Get approval

Check a change that waited for a person: whether it was approved and ran, was declined or lapsed, and once done, what it returned. Only for changes this key proposed.

GET/v1/w/{workspace}/approvals/{approvalId}

Path parameters

workspacestringrequired

Your workspace’s address name.

approvalIdstringrequired

The approvalId from the 202 answer, like ap_….

Response

approvalIdstringrequired

statusstringrequired

pending (waiting for a person), running, done, failed, unknown (the change may or may not have happened: check before trying again), declined, cancelled, expired, or stale (what it changes moved on since; a person refreshes it in Olamma).

toolstringrequired

The tool the change runs, like publish_release.

previewobject

What the approver sees.

expiresAtstringrequired

decidedBystring

decidedAtstring

reasonstring

Why it was declined, when the approver said.

resultobject

Once done: what the change returned, the same as the endpoint would have.

errorstring

Once failed or unknown: what went wrong.

resultRefsstring[]

Details

Read your proposal or one from an agent you own, including its decision and result.

Since 2026-12. Errors are listed in Errors.

cURL

curl "https://api.olamma.sh/v1/w/your-workspace/approvals/{approvalId}" \
  -H "Authorization: Bearer $OLAMMA_KEY"

Response 200

{
  "approvalId": "<string>",
  "status": "<string>",
  "tool": "<string>",
  "preview": {},
  "expiresAt": "2026-12-01T09:30:00Z",
  "decidedBy": "<string>",
  "decidedAt": "2026-12-01T09:30:00Z",
  "reason": "<string>",
  "result": {},
  "error": "<string>",
  "resultRefs": [
    "<string>"
  ]
}