AI Skills

Publish AI skill

Releases the current draft as a new immutable live version. Agents tracking the latest version pick up the change on their next run. Agents pinned to an earlier version are unaffected.

post/v1/ai-skills/{id}/publish

Request

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

Path parameters

idstring required

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

AI skill ID

Response

Published version

agentstring nullable

aiSkillIdstring required

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

allowedToolsunknown

argumentHintstring nullable

contentstring required

contextstring nullable

descriptionstring required

disableModelInvocationboolean required

hooksunknown

idstring required

Prefixed ID with 'ai_skill_ver' prefix (e.g., 'ai_skill_ver_1C'), also accepts raw integer

modelstring nullable

namestring required

publishedAtstring date-time required

publishedBystring uuid required

rejectReasonstring nullable

rejectedAtstring date-time nullable

tagsstring[] required

userInvocableboolean required

verifiedAtstring date-time nullable

versionNumberinteger required

yankedAtstring date-time nullable

yankedBystring uuid nullable

yankedReasonstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.