AI Skills

Update AI skill

Updates an AI skill's draft. Changes do not affect agents currently running the live version — call publish to release the draft as a new live version.

put/v1/ai-skills/{id}

Request

  • Base URL: https://api.withone.ai
  • URL: https://api.withone.ai/v1/ai-skills/{id}
  • Auth: one of:
    • API key in header X-One-Secret
    • OAuth 2 (authorization code, authorization URL https://api.withone.ai/oauth/authorize, token URL https://api.withone.ai/oauth/token, scopes: user:ai_skills:write)

Path parameters

idstring required

Prefixed ID with 'ai_skill' prefix (e.g., 'ai_skill_1C'), also accepts raw integer

AI skill ID

Request body

activeboolean nullable
agentstring nullable
allowedToolsunknown
argumentHintstring nullable
contentstring nullable
contextstring nullable
descriptionstring nullable
disableModelInvocationboolean nullable
hooksunknown
modelstring nullable
namestring nullable
publicboolean nullable
skipValidationboolean nullable
tagsstring[] nullable
userInvocableboolean nullable

Response

Updated AI skill

activeboolean required
agentstring nullable
allowedToolsunknown
argumentHintstring nullable
contentstring required
contextstring nullable
createdAtstring date-time required
descriptionstring required
disableModelInvocationboolean required
environment'test' | 'live' required
hooksunknown
idstring required

Prefixed ID with 'ai_skill' prefix (e.g., 'ai_skill_1C'), also accepts raw integer

lastUsedAtstring date-time nullable
latestPublishedVersionIdstring

Prefixed ID with 'ai_skill_ver' prefix (e.g., 'ai_skill_ver_1C'), also accepts raw integer

modelstring nullable
namestring required
organizationIdstring uuid nullable
projectIdstring uuid nullable
publicboolean required
tagsstring[] required
updatedAtstring date-time required
usageCountinteger required
userIdstring uuid required
userInvocableboolean required
versionstring required

Changes

No recorded changes to this operation across all 1 revision of this API.