internal
internal-skills

Update System Skill

Changed on

Replace a curated skill's content, starter flag, and availability.

workspace_ids and icp_category_ids set availability together: clearing both makes it global, either one restricts it.

patch/api/v1/internal/skills/{skill_id}

Request

  • Base URL
    https://api.maia-analytics.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.maia-analytics.com/api/v1/internal/skills/{skill_id}
  • Auth
    HTTP bearer

Path parameters

skill_idstring uuid required

Request body

namestring required
descriptionstring required
bodystring required
is_starterboolean
skill_type'workflow' | 'enrichment' | 'agent_column'

What kind of work a skill encodes: workflow runs end-to-end from a blank project (and defaults into the new-project starter gallery), enrichment produces a derived value or configuration on existing data, agent_column builds one agent-derived column.

workspace_idsstring[]
icp_category_idsstring[]

ICP categories this skill targets. Every workspace carrying one of these categories can see it, including workspaces assigned to the category after this write.

Response

Successful Response

idstring uuid required
scope'user' | 'workspace' | 'system' required

Tier a skill applies to.

Unlike knowledge entries, skills add a system scope: globally-available skills that are read-only through the public service/API and writable only via the internal admin override, plus the in-code create-skill playbook registry. user skills are owned by a single user, workspace skills by a workspace, system skills by neither.

user_idstring uuid nullable
workspace_idstring uuid nullable
namestring required
descriptionstring required
bodystring required
created_atstring date-time required
updated_atstring date-time required
is_starterboolean

Whether this skill surfaces as a first-run starter in the new-project gallery. System (Ready-made by MAIA) and workspace-scoped skills may be starters; user-scoped skills are never starters.

skill_type'workflow' | 'enrichment' | 'agent_column'

What kind of work a skill encodes: workflow runs end-to-end from a blank project (and defaults into the new-project starter gallery), enrichment produces a derived value or configuration on existing data, agent_column builds one agent-derived column.

supersedes_skill_idstring uuid nullable

If set, the MAIA/workspace starter this skill was customized from; that original is hidden from this caller's starter gallery and the agent's routing catalog in favor of this skill.

workspace_idsstring[]

The workspaces this curated (system) skill is explicitly available in. Global means this AND icp_category_ids are both empty.

icp_category_idsstring[]

The ICP categories this curated (system) skill targets. Any workspace carrying one of them can see it.

Changes

  • bd2347b6f591Revision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status