sym_skills_manage
Create/update catalogues, publish immutable versions, rename/archive skills, grant/revoke account access, and link/unlink catalogues to authorized Browser Passes. Requires repository role and explicit task authorization. Does not execute code or grant browser access. Read sym_docs for exact action schemas.
API 2.3.3 · Published service contract ↗
Permissions
Discovery scopes: skills:read, skills:write. Requires configured catalogue service and discoveryScopes.
Arguments
| Field | Type | Required | Description |
|---|---|---|---|
| action | string | ✓ | Values: ["catalogue.create","catalogue.update","grant.set","grant.remove","link.set","link.remove","version.publish","skill.update"] |
| args | object | ✓ |
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"catalogue.create",
"catalogue.update",
"grant.set",
"grant.remove",
"link.set",
"link.remove",
"version.publish",
"skill.update"
]
},
"args": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"anyOf": [
{
"type": "object",
"properties": {
"catalogueId": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"description": {
"default": "",
"type": "string",
"maxLength": 2000
}
},
"required": [
"catalogueId",
"name"
],
"additionalProperties": false,
"title": "catalogue.create"
},
{
"type": "object",
"properties": {
"catalogueId": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"expectedRevision": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"description": {
"type": "string",
"maxLength": 2000
},
"archived": {
"type": "boolean"
}
},
"required": [
"catalogueId",
"expectedRevision"
],
"additionalProperties": false,
"title": "catalogue.update"
},
{
"type": "object",
"properties": {
"catalogueId": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"expectedRevision": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"accountUid": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"role": {
"type": "string",
"enum": [
"reader",
"editor"
]
}
},
"required": [
"catalogueId",
"expectedRevision",
"accountUid",
"role"
],
"additionalProperties": false,
"title": "grant.set"
},
{
"type": "object",
"properties": {
"catalogueId": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"expectedRevision": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"accountUid": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
}
},
"required": [
"catalogueId",
"expectedRevision",
"accountUid"
],
"additionalProperties": false,
"title": "grant.remove"
},
{
"type": "object",
"properties": {
"catalogueId": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"passId": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"expectedRevision": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"catalogueId",
"passId",
"expectedRevision"
],
"additionalProperties": false,
"title": "link.set"
},
{
"type": "object",
"properties": {
"catalogueId": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"passId": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"expectedRevision": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"catalogueId",
"passId",
"expectedRevision"
],
"additionalProperties": false,
"title": "link.remove"
},
{
"type": "object",
"properties": {
"catalogueId": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"skillId": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"version": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"expectedRevision": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "SKILL metadata revision, not catalogueRevision. New skill: 0; existing skill: revision from list or previous response.skill.revision."
},
"manifest": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$",
"description": "Must exactly equal the outer skillId."
},
"version": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$",
"description": "Must exactly equal the outer version; published versions are immutable."
},
"description": {
"type": "string",
"maxLength": 2000
},
"origins": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"format": "uri",
"description": "Exact HTTP(S) origin, e.g. https://example.com; no path."
}
},
"effect": {
"type": "string",
"enum": [
"read",
"write"
],
"description": "Declared behavior; not a JavaScript sandbox."
},
"inputSchema": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "boolean"
}
],
"description": "JSON Schema draft-07 for the skill input or returned output."
},
"outputSchema": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "boolean"
}
],
"description": "JSON Schema draft-07 for the skill input or returned output."
},
"codeSha256": {
"description": "Optional exact UTF-8 source hash. Omit it normally: the server computes sourceHash. If supplied, it must match.",
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"id",
"version",
"description",
"origins",
"effect",
"inputSchema",
"outputSchema"
],
"additionalProperties": {}
},
"source": {
"type": "string",
"maxLength": 100000
},
"provenance": {
"type": "object",
"properties": {
"workspace": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"profile": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"originalHash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"workspace",
"profile"
],
"additionalProperties": false
}
},
"required": [
"catalogueId",
"skillId",
"version",
"expectedRevision",
"manifest",
"source"
],
"additionalProperties": false,
"title": "version.publish"
},
{
"type": "object",
"properties": {
"catalogueId": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"skillId": {
"type": "string",
"pattern": "^[A-Za-z0-9_.-]{1,128}$"
},
"expectedRevision": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Current SKILL metadata revision, not catalogueRevision."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"description": {
"type": "string",
"maxLength": 2000
},
"archived": {
"type": "boolean"
}
},
"required": [
"catalogueId",
"skillId",
"expectedRevision"
],
"additionalProperties": false,
"title": "skill.update"
}
]
}
},
"required": [
"action",
"args"
],
"additionalProperties": false
}Returns
open-object; see responseContract.payloads and live/version-specific contract
{
"type": "object",
"properties": {},
"additionalProperties": {}
}REST equivalents
[
{
"method": "POST",
"path": "/v1/skills/manage"
}
]