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 latestSkillVersionId for a move would make every agent following this skill re-resolve to a revision identical to the last one. Publish new content with managedAgentsCreateSkillVersionV2, which takes a base version id for a compare-and-swap check. Send an empty skillGroupId to remove the skill from its group; skillGroupId 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
Response
OK
-9007199254740991 <= x <= 9007199254740991-9007199254740991 <= x <= 9007199254740991