Publish release

Propose publishing a shipped release to customers. A lead approves it in Olamma. Check release first: a release with no headline or nothing for customers is refused.

POST/v1/w/{workspace}/releases/{releaseId}/publish

Send an Idempotency-Key. This may answer 202 while it waits for approval.

Path parameters

workspacestringrequired

Your workspace’s address name.

releaseIdstringrequired

The release to publish.

Headers

Idempotency-Keystring

8–100 characters. Repeat the same key and body to get the first outcome back instead of writing twice.

Body

headlinestring

A headline, if it has none yet.

Response

statusobjectrequired

approvalIdstringrequired

Details

Publish a shipped release after a person approves in Olamma.

Since 2026-12. Errors are listed in Errors.

cURL

curl -X POST "https://api.olamma.sh/v1/w/your-workspace/releases/{releaseId}/publish" \
  -H "Authorization: Bearer $OLAMMA_KEY" \
  -H "Idempotency-Key: <unique key>"

Response 202

{
  "status": "awaiting_approval",
  "approvalId": "<string>"
}