Skip to main content
PUT
Update workspace skill

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

skill_id
string
required

ID of the skill to update. Get it from id in List workspace skills.

Body

application/json
name
string | null

New name. Name of the skill, up to 64 characters: lowercase letters and digits in words joined by single hyphens, such as code-review. Unique within the workspace.

Required string length: 1 - 64
Example:

"brand-voice"

description
string | null

New description. When the skill applies, up to 1024 characters. The AI builder reads it to decide when to load the skill, so say what the skill is for.

Required string length: 1 - 1024
Example:

"Use when writing any user-facing copy for our apps."

body
string | null

New instructions. The instructions the AI builder follows once it loads the skill, up to 15000 characters.

Required string length: 1 - 15000
Example:

"Write in a warm, plain-spoken voice. Use sentence case for headings and keep buttons to two words."

enabled
boolean | null

true lets the AI builder use the skill, and false stops it.

Example:

false

Response

The updated skill.

id
string
required

ID of the skill.

Example:

"68d2a1f4c9e7b3001f2a5c88"

name
string
required

Name of the skill.

Example:

"brand-voice"

description
string
required

When the skill applies.

Example:

"Use when writing any user-facing copy for our apps."

body
string
required

The instructions the AI builder follows once it loads the skill.

Example:

"Write in a warm, plain-spoken voice. Use sentence case for headings and keep buttons to two words."

enabled
boolean
required

Whether the AI builder can use the skill.

Example:

true

created_by
string
required

Email of the member who created the skill.

Example:

"dana@acme.com"

created_date
string
required

Time the skill was created, in UTC, as an ISO 8601 timestamp.

Example:

"2026-08-01T09:15:00.123000Z"

updated_date
string
required

Time the skill last changed, in UTC, as an ISO 8601 timestamp.

Example:

"2026-08-03T14:02:10.456000Z"