AI Skills

Yank AI skill version

Marks a published version as yanked so it can no longer be selected as the live version. Useful for emergency rollback after a bad release. The reason you provide is recorded for audit.

post/v1/ai-skills/{id}/versions/{version}/yank

Request

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

versioninteger required

Version number

Request body

reasonstring required

Response

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.