Tell reporters

Propose emailing the people who reported a release’s changes that it shipped. Email can’t be unsent, so a lead always approves it in Olamma first.

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

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

Path parameters

workspacestringrequired

Your workspace’s address name.

releaseIdstringrequired

The published release.

Headers

Idempotency-Keystring

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

Body

peoplestring[]required

Who to tell, from the release’s reporters.

messagestring

A short note added to the email.

senderIdstring

Response

statusobjectrequired

approvalIdstringrequired

Details

Ask a lead to approve emailing selected reporters of a published release.

Since 2026-12. Errors are listed in Errors.

cURL

curl -X POST "https://api.olamma.sh/v1/w/your-workspace/releases/{releaseId}/tell" \
  -H "Authorization: Bearer $OLAMMA_KEY" \
  -H "Idempotency-Key: <unique key>" \
  -H "content-type: application/json" \
  -d '{
    "people": [
      "<string>"
    ]
  }'

Response 202

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