Skip to main content
GET
Get one immutable skill version

Authorizations

Authorization
string
header
required

A Recursion API key, created in the console under API keys.

Path Parameters

skill_id
string<uuid>
required

Skill id (UUID) the version belongs to.

skill_version_id
string<uuid>
required

Immutable skill version id (UUID), as listed by listSkillVersions or reported as a skill's latest_skill_version_id.

Response

An immutable snapshot of a skill's document and metadata, minted on every update. An agent may pin one, so that what a session runs cannot change under it.

An immutable snapshot of a skill's document and metadata, minted on every update. An agent may pin one, so that what a session runs cannot change under it.

created_at
string<date-time>
required

Server-assigned RFC 3339 timestamp of when this version was minted.

description
string
required

The skill's routing description as it stood at this version.

name
string
required

The skill's addressable name as it stood at this version.

organization_id
string
required

Organization that owns this record. Resolved from the API key; never accepted from the caller.

skill_id
string
required

Skill this version belongs to.

skill_version_id
string
required

Identifier for this skill version. Server-assigned. Pass it when attaching a skill that must stay pinned to a specific revision.

version_number
integer<int64>
required

Monotonically increasing version counter within the skill, starting at 1. Server-assigned.

artifact_sha256
string

SHA-256 checksum of the stored document.

bundle
object

The files bundled with this version, and the archive they are mounted from. Absent for a version that carries only a document.

Example:
created_by
string

Identifier of the caller that minted this version.

entrypoint_path
string

Path of the document within the bundle. SKILL.md unless the author moved it.

file_manifest
string[]

Relative paths of files bundled with the skill. Listed to the model at activation; read only if it uses them.

frontmatter
object

The parsed SKILL.md frontmatter as authored, including fields this platform does not interpret.

instructions
string

The skill's full Markdown instructions. Returned only when reading a single version, since a listing has no use for it.

metadata
object

Caller-owned key/value data stored with this version and returned unchanged.