AI Skills

Get organization AI skill

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

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

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.

Response

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