Flags API reference

Flags API · History

get/v1/workspaces/{workspace_id}/projects/{project_id}/changesAuth

List changes

The history of a project, newest first: every write with who made it (user, API key, or a client acting for a user), its note, the config revisions it published and a human summary ("Production: value false → true"). Filter by config, environment, setting, segment, actor or time. Confidential lists show as counts, never values.

Path parameters

project_id*string · uuid

Id of the 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.

config_idstring · uuid

Only changes of this config (its settings, values and keys).

environment_idstring · uuid

Only changes in this environment (value writes, SDK keys).

setting_idstring · uuid

Only changes of this setting: its metadata and its values in every environment.

segment_idstring · uuid

Only changes of this segment.

actor_idstring

Only changes made by this actor (`actor.id`: a platform user id or an API key id).

sincestring · date-time

Only changes at or after this time (ISO 8601).

untilstring · date-time

Only changes before this time (ISO 8601).

Response · 200 A page of changes.

data*array

Changes, newest first.

pagination*object

The cursor for the next page.

Example

Request

GET https://api.flags.productcraft.co/v1/workspaces/{workspace_id}/projects/{project_id}/changes
Authorization: Bearer YOUR_TOKEN

Response

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "project_id": "00000000-0000-0000-0000-000000000000",
      "config_id": "00000000-0000-0000-0000-000000000000",
      "environment_id": "00000000-0000-0000-0000-000000000000",
      "entity_type": "setting_value",
      "entity_id": "5b1f0c2e-8d4a-4e6b-9f3a-1c2d3e4f5a6b",
      "entity_key": "new_checkout",
      "action": "setting_value.updated",
      "actor": {},
      "note": "Ticket FLAG-142",
      "revisions": [
        {
          "config_id": "00000000-0000-0000-0000-000000000000",
          "environment_id": "00000000-0000-0000-0000-000000000000",
          "revision": 7,
          "url": "https://api.flags.productcraft.co/v1/workspaces/9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b/configs/1f0c…/environments/7a2e…/revisions/7",
          "previous_url": "string"
        }
      ],
      "reverts_change_id": "00000000-0000-0000-0000-000000000000",
      "summary": [
        "Production: value false → true"
      ],
      "diff_too_large": false,
      "size_bytes": 0,
      "created_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "pagination": {}
}