Skip to main content
POST
Create a skill owned by an account

Authorizations

Authorization
string
header
required

API key: key id as the username, secret as the password. An account API key carries the same scopes as an OAuth token and is checked against the scopes listed under oauth2 on each operation. A trigger API key is limited to its trigger's workspace and reaches only the session operations that list this scheme alongside the oauth2 scopes.

Path Parameters

account_id_or_name
string
required

Body

application/json
name
string
required

Skill name

overview
string | null

What the skill is for

is_public
boolean
default:false
avatar_url
string | null

Response

Successful response

id
string<uuid>
created_at
string<date-time>
updated_at
string<date-time>
is_public
boolean

Whether the asset is visible to the community or only its owner.

name
string

Unique name identifying the asset within the owner account.

Maximum string length: 100
owner_id
string<uuid>

The account that owns this entity.

archived_at
string<date-time> | null
archived_by_id
string<uuid> | null
avatar_url
string | null
Maximum string length: 255
creator_id
string<uuid> | null

The user or API key that created this skill. Null for legacy rows created before creator attribution was recorded.

overview
string | null

Optional human-facing overview for display and indexing. Falls back to the latest version description if not set.

Maximum string length: 8192
archived_by
any
creator
any

The user who created this skill.

full_name
any
last_updated_by
any

The user who pushed the newest version of this skill.

latest_version
any
likes_count
any
owner
any
type
any
viewer_can_edit
any