List versions · Cueston Docs

GET/announcements/{id}/versionsNeedscontent.view

Published versions, newest first, and whether the draft has changes not yet published to each environment.

Authorization

secretKey

headerAuthorizationBearer <sk_…>

A secret API key from Settings → API keys. It acts with its creator's role.

Path Parameters

id*integer

The announcement's id.

Range1 <= value

Response Body

application/json

response

versions*array<>

working*

publication*

Which version each environment serves. null = not published there.

Shell

curl -X GET 'https://app.cueston.com/api/announcements/1/versions'

Example ResponseSchema

JSON

{
  "versions": [
    {
      "id": 42,
      "version": 3,
      "note": "Clearer copy on step 2",
      "hash": "7090a4327d58d501f1d2894b7f5148994c165ad4c232de0e817493669e4e9a59",
      "createdBy": {
        "id": 42,
        "name": "Ada Lovelace",
        "email": "ada@acme.com"
      },
      "createdAt": "2026-10-26T09:30:00Z",
      "environments": [
        "production"
      ]
    }
  ],
  "working": {
    "hash": "7090a4327d58d501f1d2894b7f5148994c165ad4c232de0e817493669e4e9a59",
    "hasUnpublishedChanges": {
      "production": true,
      "staging": true
    }
  },
  "publication": {
    "production": {
      "versionId": 7,
      "version": 3,
      "publishedAt": "2026-10-26T09:30:00Z"
    },
    "staging": {
      "versionId": 7,
      "version": 3,
      "publishedAt": "2026-10-26T09:30:00Z"
    }
  }
}{
  "versions": [
    {
      "id": 42,
      "version": 3,
      "note": "Clearer copy on step 2",
      "hash": "7090a4327d58d501f1d2894b7f5148994c165ad4c232de0e817493669e4e9a59",
      "createdBy": {
        "id": 42,
        "name": "Ada Lovelace",
        "email": "ada@acme.com"
      },
      "createdAt": "2026-10-26T09:30:00Z",
      "environments": [
        "production"
      ]
    }
  ],
  "working": {
    "hash": "7090a4327d58d501f1d2894b7f5148994c165ad4c232de0e817493669e4e9a59",
    "hasUnpublishedChanges": {
      "production": true,
      "staging": true
    }
  },
  "publication": {
    "production": {
      "versionId": 7,
      "version": 3,
      "publishedAt": "2026-10-26T09:30:00Z"
    },
    "staging": {
      "versionId": 7,
      "version": 3,
      "publishedAt": "2026-10-26T09:30:00Z"
    }
  }
}