Get a skill version
⚠️
Preview — this feature is being built; the design below is the spec.
GET https://app.syntic.ai/v1/skills/{skill_id}/versions/{version}Return one version’s manifest, file count, size and content hash. The hash lets you check that the bundle you tested is the one agents will load.
For how this fits into a full workflow, see Agent skills.
Headers
| Header | Required | Value |
|---|---|---|
Authorization | Yes | Bearer <key>: a private inference key (sk_live_...). See Authentication. |
syntic-beta | Yes, while in preview | agents-2026-11-01. Without it the call fails with 400 beta_required. See Versioning. |
Path parameters
| Parameter | Type | Description |
|---|---|---|
skill_id | string | The skill id, starting with skill_. |
version | string | A version number such as 4, or latest. |
Response
200 OK, Content-Type: application/json
{
"skill_id": "skill_01JBXM4",
"version": "4",
"created_at": 1792512000,
"files": 4,
"bytes_unzipped": 182044,
"sha256": "3f9a0c1e…b72d",
"entrypoint": "SKILL.md",
"manifest": {
"name": "invoice-reconciler",
"description": "Match supplier invoices to purchase orders and flag mismatches.",
"requires": [
"syntic_code_execution"
]
}
}| Field | Type | Description |
|---|---|---|
version | string | The resolved version number, even when you asked for latest. |
sha256 | string | Hash of the uploaded archive. |
entrypoint | string | The instruction file the model reads first. |
manifest | object | Name, description and required tools, read from the entrypoint’s front matter. |
Examples
curl -sS "https://app.syntic.ai/v1/skills/skill_01JBXM4/versions/4" \
-H "Authorization: Bearer $SYNTIC_API_KEY" \
-H "syntic-beta: agents-2026-11-01"Errors
Errors use the error envelope and carry a request_id. Codes specific to this operation:
| Status | type | code | When |
|---|---|---|---|
| 400 | invalid_request_error | beta_required | The syntic-beta header is missing. |
| 404 | not_found_error | skill_version_not_found | The skill or version does not exist. |
| 401 | authentication_error | invalid_api_key | The key is missing, unknown, revoked or expired. |
| 429 | rate_limit_error | rate_limited | Too many requests; wait for Retry-After. See Rate-limit headers. |
Was this page helpful?