Replace skill bundle
Replaces a Skill’s bundle with a newly uploaded one and returns the updated Skill.
Upload the new bundle with Upload file first. file_id is the only field you can change: to change the description or surfaces, edit SKILL.md and upload a new bundle. The replacement must name the same Skill.
Replacing a bundle with identical contents changes nothing and returns the current Skill, so a retry is safe. version.num is checked before the bundle is replaced, but two replacements sent at the same moment with the same num can both succeed, and the later one is stored.
Authentication
JWT bearer token authentication. Include the Configuration API key in the Authorization header as ‘Bearer <token>’.
Path parameters
The id of the Skill, as returned when it was registered or listed.
Request
The Files API id of the replacement bundle, uploaded with purpose CONFIGURATIONS_ASSISTANT_SKILL. Its SKILL.md must name the same Skill. See Upload file.
Response headers
Response
Unique identifier of the Skill, assigned by the server. Use it in a productivity assistant’s skill_ids.
Skill name from the bundle’s SKILL.md. Unique in your organization, and fixed once the Skill is created.
Skill description from the bundle’s SKILL.md.
Where the Skill is available, from the surfaces list in the bundle’s SKILL.md, for example slack. An empty list means everywhere.