AI Skills

Update organization AI skill

Updates an organization-scoped AI skill's draft. Publish to release the draft as a new live version.

put/v1/ai-skills/organizations/{org_id}/{id}

Request

  • Base URL: https://api.withone.ai
  • URL: https://api.withone.ai/v1/ai-skills/organizations/{org_id}/{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: org:ai_skills:write)

Path parameters

org_idstring uuid required

Organization ID

idstring required

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

AI skill ID

Headers

X-One-Organization-Idstring uuid

Selects the tenant this request acts in. Omit it to act in your personal scope.

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 organization 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.