List changes

List a changelog’s changes, newest first, 50 at a time. Ask by pull request to see whether one is recorded already, which deploy scripts do before recording.

GET/v1/w/{workspace}/changes

Path parameters

workspacestringrequired

Your workspace’s address name.

Query parameters

changelogIdstring

The changelog, like cl_…; or give product instead.

productstring

The product’s key, like APP; each product has one changelog.

pullRequestobject

JSON: {"repo":"owner/name","number":415}.

querystring

Words to find in titles and details.

statusenum

unreleased, released or all.

limitinteger

How many to return, 1 to 50. Defaults to 20.

cursorstring

The nextCursor from the previous page; leave out for the first page.

Response

changelogobject

changesobject[]required

nextCursorstring | null

Details

Find changes in a changelog, newest first, default 20 and maximum 50 at a time. Ask by pull request to see whether it's recorded already, by words, or by status: unreleased (in the open release, waiting for the next deploy) or released.

Since 2026-12. Errors are listed in Errors.

cURL

curl -G "https://api.olamma.sh/v1/w/your-workspace/changes" \
  -H "Authorization: Bearer $OLAMMA_KEY" \
  --data-urlencode 'product=APP' \
  --data-urlencode 'pullRequest={"repo":"acme/app","number":415}'

Response 200

{
  "changelog": {
    "id": "<string>",
    "name": "<string>",
    "product": "<string>"
  },
  "changes": [
    {
      "id": "<string>",
      "type": "<string>",
      "audience": "<string>",
      "title": "<string>",
      "releaseId": "<string>",
      "pullRequests": [
        "<string>"
      ],
      "tasks": [
        "<string>"
      ],
      "recordedBy": "<string>",
      "createdAt": "2026-12-01T09:30:00Z",
      "url": "<string>"
    }
  ],
  "nextCursor": "<string>"
}