POST/api/v1/projects/{projectId}/sdk/builds/{buildId}/publish

Publish a build to package registries

Publishes a ready build's SDKs to their registries, such as npm and PyPI. A release cannot be undone. Use pack to run every step short of uploading.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 parameters · 3 body fields
projectIdstringrequired

The project's ID, from listProjects.

buildIdstringrequired

The build's ID, from triggerSdkBuild or listSdkBuilds.

languagesarray<string>optional

The languages to publish. Every ready artifact when omitted.

modestringoptional

release uploads to the registry. pack stops short of uploading.

Allowed:packreleaseDefault:release
skipValidatebooleanoptional

Skip validating the package before it is published.

5 status codes
202Publishing was queued.
buildIdstringrequired
modestringrequired
Allowed:packrelease
queuedarray<string>required
400The request failed validation.
errorobjectrequired
401The API key is missing or invalid.
errorobjectrequired
404The project or resource does not exist in this organisation.
errorobjectrequired
409The build is not ready to publish.
errorobjectrequired

Error handling

A 400 is returned: The request failed validation. A 401 is returned: The API key is missing or invalid. A 404 is returned: The project or resource does not exist in this organisation. A 409 is returned: The build is not ready to publish.