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

HeaderRequiredValue
AuthorizationYesBearer <key>: a private inference key (sk_live_...). See Authentication.
syntic-betaYes, while in previewagents-2026-11-01. Without it the call fails with 400 beta_required. See Versioning.

Path parameters

ParameterTypeDescription
skill_idstringThe skill id, starting with skill_.
versionstringA 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"
    ]
  }
}
FieldTypeDescription
versionstringThe resolved version number, even when you asked for latest.
sha256stringHash of the uploaded archive.
entrypointstringThe instruction file the model reads first.
manifestobjectName, 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:

StatustypecodeWhen
400invalid_request_errorbeta_requiredThe syntic-beta header is missing.
404not_found_errorskill_version_not_foundThe skill or version does not exist.
401authentication_errorinvalid_api_keyThe key is missing, unknown, revoked or expired.
429rate_limit_errorrate_limitedToo many requests; wait for Retry-After. See Rate-limit headers.
Was this page helpful?