Validates a Git, registered-workspace, or uploaded archive source and publishes an immutable skills revision, creating or updating a pack.
const url = 'https://example.com/v1/m/skills/packs/example/revisions';const options = { method: 'POST', headers: { 'Idempotency-Key': 'example', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: '{"name":"example","source":{"directory":"example","expected_digest":"example","kind":"git","ref":"example","subdir":"example","url":"example","workspace_ref":"example"}}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/v1/m/skills/packs/example/revisions \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: example' \ --data '{ "name": "example", "source": { "directory": "example", "expected_digest": "example", "kind": "git", "ref": "example", "subdir": "example", "url": "example", "workspace_ref": "example" } }'Validates a Git, registered-workspace, or uploaded archive source and publishes an immutable skills revision, creating or updating a pack.
Authorizations
Section titled “ Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “ Path Parameters ”Path parameter id.
Header Parameters
Section titled “ Header Parameters ”Target tenant id; required when the principal can act in more than one tenant.
Request Body required
Section titled “ Request Body required ”JSON imports a Git, registered-workspace or built-in catalog source. Archive uploads also accept multipart/form-data with archive (binary), format (zip or tar.gz), name (required for a new pack), and optional expected_digest. The same Idempotency-Key header is required.
object
Required and nonblank for a new pack; at most 128 bytes. Revisions retain the recorded pack name.
object
Selected relative directory in the registered workspace. Empty for Git imports.
Optional expected SHA-256 of the selected source snapshot.
Git branch, tag, or commit to resolve; for a built-in pack, its identifier in the pinned catalog. Empty for workspace imports.
Optional selected Git directory. Empty for workspace imports.
Git HTTPS URL without credentials, query, or fragment. Empty for workspace and built-in imports.
Registered workspace UUID. Empty for Git imports.
object
Selected relative directory in the registered workspace. Empty for Git imports.
Optional expected SHA-256 of the selected source snapshot.
Git branch, tag, or commit to resolve; for a built-in pack, its identifier in the pinned catalog. Empty for workspace imports.
Optional selected Git directory. Empty for workspace imports.
Git HTTPS URL without credentials, query, or fragment. Empty for workspace and built-in imports.
Registered workspace UUID. Empty for Git imports.
object
Selected relative directory in the registered workspace. Empty for Git imports.
Optional expected SHA-256 of the selected source snapshot.
Git branch, tag, or commit to resolve; for a built-in pack, its identifier in the pinned catalog. Empty for workspace imports.
Optional selected Git directory. Empty for workspace imports.
Git HTTPS URL without credentials, query, or fragment. Empty for workspace and built-in imports.
Registered workspace UUID. Empty for Git imports.
Responses
Section titled “ Responses ”OK
object
Example generated
{}Bad request
object
Example generated
{}Unauthenticated
object
Example generated
{}Forbidden
object
Example generated
{}Not found
object
Example generated
{}Conflict / setup required
object
Example generated
{}Rate limited
object
Example generated
{}