AI Skills

Create organization AI skill

Creates a new AI skill owned by an organization, visible to every project in the org.

post/v1/ai-skills/organizations/{org_id}

Request

  • Base URL: https://api.withone.ai
  • URL: https://api.withone.ai/v1/ai-skills/organizations/{org_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

Headers

X-One-Organization-Idstring uuid

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

Request body

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

Response

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