Refile a skill into a catalog group
Moves a skill between catalog groups, or out of one, and returns the skill. Filing is not authoring: this mints no version and leaves the skill’s document, title, metadata and bundled files exactly as they are, because advancing latest_skill_version_id for a move would make every agent following this skill re-resolve to a revision identical to the last one. Publish new content with managedAgentsCreateSkillVersion, which takes a base version id for a compare-and-swap check. Send an empty skill_group_id to remove the skill from its group; skill_group_id is required, so a body that carries nothing is rejected rather than answered as a save that changed nothing.
Authorizations
A Recursion API key, created in the console under API keys.
Headers
Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.
1Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.
1Path Parameters
Skill id (UUID) as returned by managedAgentsCreateSkill or managedAgentsListSkills.
Body
Request body for refiling a skill between catalog groups. Filing is not authoring: this leaves the skill's versions untouched and mints nothing. Publish new content with managedAgentsCreateSkillVersion.
Catalog group to file this skill under. Send an empty string to remove it from its group. Grouping is for browsing and bulk attachment only and is never disclosed to the model.
Response
A reusable procedure an agent loads when it judges the procedure relevant. Its name and description are disclosed in every turn; the instructions enter the conversation only when the agent activates it. Updating a skill mints a new immutable SkillVersion.
A reusable procedure an agent loads when it judges the procedure relevant. Its name and description are disclosed in every turn; the instructions enter the conversation only when the agent activates it. Updating a skill mints a new immutable SkillVersion.
Server-assigned RFC 3339 timestamp of when the skill was created.
When to use this skill. Disclosed to the model in every turn, so it is the whole routing signal: write it as the condition under which the skill applies.
The skill's addressable name, lowercase with single hyphens, e.g. cut-release. This is what an agent passes to the activation tool.
Organization that owns the skill. Server-assigned from the caller's credentials; a value sent in a request body is ignored.
Server-assigned id of the skill, used in the skill and skill-version routes.
Where the skill came from: platform, organization, or repository. Decides which skill wins a name collision, most specific first.
Server-assigned RFC 3339 timestamp of the most recent update to the skill.
Human-readable title shown wherever skills are listed. Defaults to the name.
Length in characters of the newest version's instructions, the body disclosed to the model when it activates the skill. Zero for a skill with no version yet. Instructions are truncated at 64000 characters when a session assembles them.
-9007199254740991 <= x <= 9007199254740991Server-maintained id of the newest version of this skill; agents that attach it without pinning a version use this one.
How many versions this skill has, which is also the number of the newest one, since versions are numbered from 1 in creation order. Zero for a skill with no version yet.
-9007199254740991 <= x <= 9007199254740991Caller-owned key/value data stored with the skill and returned unchanged.
Catalog group this skill is filed under, if any. Grouping is for browsing and for attaching a set of skills to an agent in one entry; it is never disclosed to the model and does not scope the skill's name.