internal
internal-skills

Promote Skill

Changed on

Promote an internal-authored user/workspace skill into the system catalog.

Copies the source (which stays intact) into a new owner-less system skill with the given curation controls. Sources outside internal workspaces / internal authors are rejected (403); a name collision is a 409 the caller resolves by re-submitting with a name override.

post/api/v1/internal/skills/{skill_id}/promote

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}/promote
  • Auth
    HTTP bearer

Path parameters

skill_idstring uuid required

Request body

namestring nullable
is_starterboolean
workspace_idsstring[]
icp_category_idsstring[]

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