--- title: Publish Version | Luma Agents --- POST /v1/skills/{skill\_id}/versions Select code samplecURL (shell:curl) ```js const url = 'https://agents.lumalabs.ai/v1/skills/example/versions'; const form = new FormData(); form.append('file', 'file'); form.append('files', 'file'); form.append('scope_id', '2489E9AD-2EE2-8E00-8EC9-32D5F69181C0'); const options = {method: 'POST', headers: {Authorization: 'Bearer '}}; options.body = form; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```sh curl --request POST \ --url https://agents.lumalabs.ai/v1/skills/example/versions \ --header 'Authorization: Bearer ' \ --header 'Content-Type: multipart/form-data' \ --form file=@file \ --form files=@file \ --form scope_id=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 ``` - Productionagents.lumalabs.ai/v1/skills/{skill\_id}/versions Publish a new version from a bundle; its SKILL.md must keep the skill's `name`. A bundle identical to the latest version, file for file, publishes nothing and answers 200 with that version. ## Authorizations - **[BearerAuth](/api/agents/index.md#bearerauth)** ## Parameters ### Path Parameters **skill\_id** required *Skill Id* string ## Request Bodyrequired Media typemultipart/form-data object **file** The bundle as one zip. string format: binary **files** The bundle's files, each part's filename its path inside the bundle. Array\ **scope\_id** Make this a workspace skill. Ignored when publishing a version. string format: uuid ## Responses ### 201 Successful Response Media typeapplication/json *ClientSkillVersion* One immutable version of a skill and the files it holds. object **created\_at** required *Created At* string format: date-time **file\_count** required *File Count* integer **files** required *Files* Array\ *ClientSkillFile* One file of a published version, as recorded on its version row. object **kind** required *ClientSkillFileKind* string Allowed values: skill\_md reference asset **path** required *Path* string **sha256** required *Sha256* string **size** required *Size* integer **skill\_id** required *Skill Id* string format: uuid **total\_bytes** required *Total Bytes* integer **version** required *Version* integer ##### Example ```json { "files": [ { "kind": "skill_md" } ] } ``` ### 422 Validation Error Media typeapplication/json *HTTPValidationError* object **detail** *Detail* Array\ *ValidationError* object **ctx** *Context* object **input** *Input* **loc** required *Location* Array **msg** required *Message* string **type** required *Error Type* string ##### Examplegenerated ```json { "detail": [ { "ctx": {}, "input": "example", "loc": [ "example" ], "msg": "example", "type": "example" } ] } ```