AI Skills

Get AI skill

Returns the full details of an AI skill, including its prompt, tools, current published version, and metadata.

get/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:read)

Path parameters

idstring required

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

AI skill ID

Response

AI skill details

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.