CloudRaker APIWorkspacePlaybooks

Replace a skill’s files

View as Markdown
A skill is instructions the agent reads on demand — it never executes, never dispatches and is never approval-gated (actions are the executable, gated layer). `files` replaces the whole map (same validation and caps as create) and bumps `version`. The slug IS the storage key, so this route never renames: a rename is a create plus a delete. `scope`/`playbookId` select which tier is edited (`org` by default); platform skills are code and cannot be edited here. Authorization: organization administrators only. Response `{ data: Skill }`.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

slugstringRequired

Request

files replaces the whole map and bumps version. The slug is the key, so renaming is a create plus a delete.

filesmap from strings to stringsRequired

Markdown files keyed by filename. SKILL.md is required and carries the frontmatter (name, description, optional requires: action slugs); siblings are progressive-disclosure references the agent reads on demand.

scopeenumOptional
Allowed values:
playbookIdstring or nullOptional

Response

The updated skill.
dataobject