skills

Get Skill

Return a single skill (incl. body); 404 if not visible to the caller.

get/api/v1/skills/{skill_id}

Path parameters

skill_idstring uuid required

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 (MAIA-2976).

workflow skills run end-to-end from a blank project (the IOS skill) and are the only kind that defaults into the new-project starter gallery; enrichment skills produce a derived configuration/value (usable IOS acreage) and agent_column skills build a single agent-derived column (owner assemblages) against an existing project's data.

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.

Changes

No recorded changes to this endpoint across all 15 revisions of this API.