Register skill
Registers a new Skill from an uploaded bundle and returns it with its id.
Upload the .zip or .skill bundle first with Upload file, using purpose CONFIGURATIONS_ASSISTANT_SKILL, then send the returned file id here as file_id within 24 hours. The Skill’s name, description and surfaces come from the bundle’s SKILL.md, so you don’t send them.
The bundle must meet the Skill bundle requirements.
Authentication
JWT bearer token authentication. Include the Configuration API key in the Authorization header as ‘Bearer <token>’.
Request
Files API id of the uploaded .zip or .skill bundle (purpose CONFIGURATIONS_ASSISTANT_SKILL). Required on create; on update it replaces the bundle. Write-only: the staged upload is consumed on registration and expires, so reads never return a file_id.
Response
Files API id of the uploaded .zip or .skill bundle (purpose CONFIGURATIONS_ASSISTANT_SKILL). Required on create; on update it replaces the bundle. Write-only: the staged upload is consumed on registration and expires, so reads never return a file_id.
Surfaces the skill is available on, from the bundle’s SKILL.md (e.g. slack, movewebchat:assistant). Empty means every surface.