AI Skills

Create personal AI skill

Creates a new personal AI skill. Define the name, description, prompt content, allowed tools, and model.

post/v1/ai-skills

Request

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

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