skills

Import immutable skills.

post/api/skill/import

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /api/skill/import
Auth: HTTP bearer

X-AgentZ-Workspace-IDstring

Stable Workspace ID selecting Workspace scope. Omit for Organisation scope.

Imported skills and any requested Agent attachment results.

skillsSkillName[] required

Aug 19, 202661dc99f5fdae Revision changes
- breaking
  the / response property's maxLength was increased from 32 to 63 for the response status
- info
  the / response's property pattern was changed from ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$ to ^[a-z0-9]+(-[a-z0-9]+)*$ for the status
Aug 18, 2026f9e13a5159d6 Revision changes
- breaking
  the request property's minLength was increased from 0 to 2
- warning
  the request property's maxLength was set to 65536
- warning
  removed the request property
- info
  api operation id importSkills removed and replaced with importImmutableSkills
- info
  the endpoint scheme security GatewayBearer was added to the API
- info
  added the new optional header request parameter X-AgentZ-Workspace-ID
- info
  the request property type was generalized from array to string