/v1/workspaces/{workspace_id}/changes/{change_id}AuthGet a change
One change with `before`, `after`, a JSON Patch `diff` (RFC 6902) and the summary. When `before` and `after` together exceed 64 KB, `diff_too_large` is true and the bodies are left out: compare the revisions in `revisions` (`url`, `previous_url`) instead.
Path parameters
change_id*string · uuidId of the change.
workspace_id*string · uuidId of the workspace.
Response · 200 The change.
id*string · uuidId of the change.
project_id*string · uuidThe project.
config_id*string · uuidThe config, for changes of a config, its settings, values or SDK keys.
environment_id*string · uuidThe environment, for value writes and SDK key changes.
entity_type*stringWhat changed: `project`, `environment`, `config`, `setting`, `setting_value`, `segment` or `sdk_key` (open: more may come).
Example: "setting_value"
entity_id*string · uuidId of the entity (for `setting_value`, the setting).
Example: "5b1f0c2e-8d4a-4e6b-9f3a-1c2d3e4f5a6b"
entity_key*stringThe key of the entity at the time (an environment key for SDK keys).
Example: "new_checkout"
action*string`<entity>.<verb>`, e.g. `setting_value.updated`, `setting.created`, `segment.deleted`, `sdk_key.rotated`, `confidential.revealed` (open: more may come).
Example: "setting_value.updated"
actor*objectWho made the change.
note*stringThe note sent with the write.
Example: "Ticket FLAG-142"
revisions*arrayConfig revisions the change published (empty when it changed nothing SDKs download).
reverts_change_id*string · uuidThe change this one restored (`POST …/changes/{id}/revert`).
summary*arrayHuman-readable lines, e.g. "Production: value false → true" or "rule 2 percentage 10 → 25". Confidential lists show as counts ("+3 / −1 values"), never values. Empty when the change is too large to summarise (`diff_too_large`).
Example: ["Production: value false → true"]
diff_too_large*booleanWhether `before` and `after` together exceed 64 KB: then there is no diff and no summary; compare the two revisions instead.
size_bytes*integerBytes `before` and `after` take up in history storage (they count toward the 200 MiB per project).
created_at*string · date-timeWhen the change was made.
before*objectThe entity before the change (null for a create). Confidential lists show as `{hashed, count, list_id, editable}`, never values. Null when `diff_too_large`: read the revisions instead.
after*objectThe entity after the change (null for a delete), in the same form as `before`. Null when `diff_too_large`.
diff*arrayJSON Patch (RFC 6902) from `before` to `after`. Null when `diff_too_large`.
Example
Request
GET https://api.flags.productcraft.co/v1/workspaces/{workspace_id}/changes/{change_id}
Authorization: Bearer YOUR_TOKENResponse
{
"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",
"before": {},
"after": {},
"diff": [
{
"op": {},
"path": "/rules/1/percentages/0/percentage",
"value": 25
}
]
}