Flags API reference

Flags API · Revisions

get/v1/workspaces/{workspace_id}/configs/{config_id}/environments/{environment_id}/revisionsAuth

List config revisions

Published revisions of the config in one environment, newest first. Every write that changes what SDKs download publishes a revision; edits that do not (a description, a name) do not. The last 100 revisions, or 20 MiB of compressed snapshots, are kept, and the current one always.

Path parameters

config_id*string · uuid

Id of the config.

environment_id*string · uuid

Id of an environment of the same project.

workspace_id*string · uuid

Id of the workspace.

Query parameters

cursorstring

Opaque cursor for pagination: the `next_cursor` of the previous page.

limitinteger

Page size.

Response · 200 A page of revisions.

data*array

Published revisions, newest first (the last 100, or 20 MiB of compressed snapshots, are kept).

pagination*object

The cursor for the next page.

Example

Request

GET https://api.flags.productcraft.co/v1/workspaces/{workspace_id}/configs/{config_id}/environments/{environment_id}/revisions
Authorization: Bearer YOUR_TOKEN

Response

{
  "data": [
    {
      "revision": 2,
      "generation": 1,
      "etag": "q8w4Yb0cJ0dY2t1vUo3n7A",
      "size_bytes": 412,
      "published_at": "2026-01-01T00:00:00.000Z",
      "change_id": "00000000-0000-0000-0000-000000000000",
      "current": true
    }
  ],
  "pagination": {}
}