Publish a skill version
Publish the Skill: validate the definition and store it as a new immutable version that is active immediately. Clears the working copy. Blocking issues fail with validation_error and details per definition path; skills.validate lists them all beforehand.
Authorization
bearerApiKey Create a scoped API key in the Adlass settings.
In: header
Path Parameters
Resource identifier: skill_id.
uuidHeader Parameters
Optional correlation identifier.
length <= 128A unique key for this intended write. Reuse it only for an identical retry.
1 <= length <= 200Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/skills/123e4567-e89b-42d3-a456-426614174000/versions" \ -H "Idempotency-Key: 123e4567-e89b-42d3-a456-426614174000" \ -H "Content-Type: application/json" \ -d '{ "expected_revision": 0, "name": "Customer documents", "summary": "Extracts totals and due dates from supplier invoices.", "definition": { "instructions": "example", "capabilities": [] } }'{ "id": "123e4567-e89b-42d3-a456-426614174000", "slug": "customer-documents", "kind": "PLATFORM", "name": "Customer documents", "summary": "Extracts totals and due dates from supplier invoices.", "status": "ACTIVE", "visibility": "PRIVATE", "categories": [], "tags": [], "is_template": false, "current_version": 0, "has_draft": false, "draft_revision": 0, "draft_updated_at": "2026-09-04T12:00:00Z", "created_by_id": "123e4567-e89b-42d3-a456-426614174000", "created_by": { "id": "123e4567-e89b-42d3-a456-426614174000", "email": "ada@example.com", "name": "Customer documents", "image_url": "example" }, "access_mode": "example", "share_count": 0, "access": { "share_role": "example", "is_creator": false, "access_mode": "example", "can_view": false, "can_run": false, "can_edit": false, "can_share": false, "can_archive": false }, "updated_at": "2026-09-04T12:00:00Z", "version": { "id": "123e4567-e89b-42d3-a456-426614174000", "version": 0, "definition": {}, "content_hash": "3f786850e387550fdab836ed7e6dc881de23001b", "change_note": "Initial version", "created_at": "2026-09-04T12:00:00Z" }, "draft": {}}