AI Skills

Publish organization AI skill

Releases the current draft of an organization-scoped AI skill as a new immutable live version.

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

Request

  • Base URL: https://api.withone.ai
  • URL: https://api.withone.ai/v1/ai-skills/organizations/{org_id}/{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: org:ai_skills:write)

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

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.