Create Skill
Create a user- or workspace-scoped skill (system scope is read-only → 403).
Request body
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.
Whether the skill is a new-project starter. Omit for the default: a workflow-type workspace skill defaults to a starter, other types and user skills do not. Only workspace skills may be starters.
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.
Set when customizing an existing MAIA/workspace skill: the id of the starter this copy supersedes. That original is hidden from the gallery and the agent's routing catalog in this copy's favor.
Response
Successful Response
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.
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.
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.
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 30 revisions of this API.