Beta module namespace
skills
Beta routes may change with notice and are NOT covered by the 24-month stable window of the core contract.
Every module route is enumerated with method, path, auth and required permission; request/response schemas are not published for the beta surface.
14 operations
| Method | Path | Required permission | Authentication | Summary |
|---|---|---|---|---|
| get | /v1/m/skills/assignments | skills:catalog:read | Bearer token | Lists pinned skills assignments for an authorized workspace, template, agent group, agent, or session target with cursor pagination. |
| post | /v1/m/skills/assignments | skills:assignment:write | Bearer token | Creates or updates a target's pin to an immutable skills revision and selected members for new conversations. |
| put | /v1/m/skills/assignments/{id} | skills:assignment:write | Bearer token | Creates or updates a target's pin to an immutable skills revision and selected members for new conversations. |
| delete | /v1/m/skills/assignments/{id} | skills:assignment:write | Bearer token | Removes a skills assignment from its authorized target at the expected version so new conversations no longer inherit that pin. |
| get | /v1/m/skills/builtins | skills:catalog:read | Bearer token | Lists the embedded, pinned sources without installing or executing them. |
| get | /v1/m/skills/packs | skills:catalog:read | Bearer token | Lists the tenant's skills packs, including retired packs, with cursor pagination. |
| post | /v1/m/skills/packs | skills:catalog:write | Bearer token | Validates a Git, registered-workspace, or uploaded archive source and publishes an immutable skills revision, creating or updating a pack. |
| get | /v1/m/skills/packs/{id} | skills:catalog:read | Bearer token | Returns a skills pack and a cursor-paged history of its complete immutable revisions, including manifests and import provenance. |
| delete | /v1/m/skills/packs/{id} | skills:catalog:admin | Bearer token | Retires an unreferenced skills pack at the expected version while retaining its immutable revisions and provenance. |
| get | /v1/m/skills/packs/{id}/assignments | skills:catalog:read | Bearer token | Lists the pinned skills assignments of an authorized pack whose targets the caller can read natively, with cursor pagination. |
| get | /v1/m/skills/packs/{id}/diff | skills:catalog:write | Bearer token | Compares two revisions of a pack from their verified artifacts. |
| post | /v1/m/skills/packs/{id}/revisions | skills:catalog:write | Bearer token | Validates a Git, registered-workspace, or uploaded archive source and publishes an immutable skills revision, creating or updating a pack. |
| post | /v1/m/skills/packs/{id}/update | skills:catalog:write | Bearer token | Reads a pack's recorded source again. |
| get | /v1/m/skills/selection | skills:catalog:read | Bearer token | Returns the skills a new conversation pinned to the authorized target, or the tree of targets, receives: the same resolution a launch runs, refusals included. |