List a project setting's history
The changes of one of the project's settings or of its name, steps or photo, newest first.
Each change says who made it, and through which connected app or key when it came from outside Werk's apps.
Authorization
Authorization: Bearer <key> Authentication
Headers
The language tag Werk writes the answer's own words in, such as step names and history lines, matched to a language it serves; a card's text stays as written. At a project's paths, the reads of its cards and steps, of a card, its update photos, a file and its reminders, and of follow and reminder invitations, and a document's read-now and consent, take the language of the person's chat with Werk in that project first, while it has one. Without either, the language Werk uses with the person the key or the connection acts for.
Path parameters
The project's id.
The setting's name, or project_name, project_steps or project_photo.
Query parameters
Reads the changes made before this version; left out, from the newest.
How many changes a page holds.
Response
200 The changes.
The setting's changes, newest first.
Show properties of changesHide properties of changes
The person who made the change.
The value before the change.
The value after the change.
The setting's version after the change.
When the change was made.
The connected app or API key the change came through; absent for one made in Werk's apps.
Show properties of viaHide properties of via
connection for an app connected by sign-in, key for an API key.
The app's or the key's name, as Werk shows it.
True when Werk verified the app's identity.
The caption Werk shows beside the change, in the reader's language.
The version to read the next, older page from as beforeVersion, or null when none remains.
Errors
invalid_query The query is not in the form the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).invalid_setting The setting, its value or the read of its history is not one the route takes; the limit is in the unit of the input details.field names (characters for a text, entries for a list, the value for a number).session_revoked The request carries no session the server holds, or its session has ended.session_expired The session has expired.conversation_not_found The project the request names, or its chat, is not one the signed-in person is in.not_found The route or record the request names does not exist, or is not one the signed-in person can reach.session_changed The session changed while the request was in flight.rate_limited More requests of this kind were sent than Werk takes within the time it counts them over.server_error The server could not complete the request, and it is not known whether a write it holds was made.curl "https://api.getwerk.ai/api/v1/projects/2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73/settings/due_notice_lead/history?limit=20" \
-H "Authorization: Bearer wk_key_..."const res = await fetch("https://api.getwerk.ai/api/v1/projects/2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73/settings/due_notice_lead/history?limit=20", {
headers: {
Authorization: "Bearer wk_key_...",
},
});
const answer = await res.json();{
"changes": [
{
"actorId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
"before": "at_due",
"after": "1_day",
"version": 2,
"changedAt": "2026-11-02T16:20:00.000Z"
}
],
"nextBeforeVersion": null
}Send a requestGET
It is sent with the key you give, as you. A change made here is real.
The request could not be sent, or its response could not be read.