v3

OpenAPI 3.1.02026-08-06274467602.9 KB

internal

internal-skills

List System Skills

List every MAIA-curated (system) skill with its workspace-availability set.

get/api/v1/internal/skills

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.

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.