Skip to main content
PUT
Python SDK

Authorizations

Authorization
string
header
required

Enter your API key (e.g. dai_sk_test_key_001)

Headers

Authorization
string

Path Parameters

skill_id
string
required

The skill's stable ID (prefixed 'sk_').

Example:

"sk_abc123"

Cookies

decimal_session
string | null

Body

application/json

Validated request for PUT /skills/{id}.

All fields optional (partial update).

display_name
string | null

Human registry title shown instead of the slug name.

Maximum string length: 200
description
string | null
Maximum string length: 1024
body_markdown
string | null
body
string | null
stability
string | null
is_active
boolean | null
category
string | null
Maximum string length: 100
skill_type
string | null

Taxonomy class: capability or preference (legacy model-gap/proprietary/convention still accepted).

skill_scope
string | null

Knowledge scope: public or private.

invocation_mode
string | null

Who may fire the skill: model, user, or any.

trigger_phrases
string[] | null
frontmatter
Frontmatter · object | null
change_summary
string | null
author
string | null

Response

Successful Response

status
string
required
Allowed value: "ok"
skill_id
string
required
name
string
required
latest_version_id
string | null

ID of the new version if body changed; unchanged otherwise.