DevelopersHow to connect an assistantKeys
Reference/Profile/Read

List a setting's history

GEThttps://api.getwerk.ai/api/v1/settings/{key}/history

The changes of one of the key's person's settings, or of their name, photo, time zone or device language, newest first.

Each change says through which connected app or key it came when it came from outside Werk's apps.

Authorization

AuthorizationheaderRequired

Authorization: Bearer <key> Authentication

Headers

Werk-Localestring

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

keyenumRequired

The setting's name, or person_name, person_photo, person_timezone or phone_locale.

Allowed valuesbrief_timebrief_onbrief_resume_dateemail_due_noticesemail_own_remindersemail_invitationspush_my_cardspush_due_noticespush_own_reminderspush_invitationspush_project_peoplepush_from_werktranslate_cardstranslate_offercards_drawer_levelquiet_hours_onquiet_startquiet_endquiet_daysquiet_untildue_notice_leadcolorhighlightedmutedin_morning_brieftranslate_offer_closedperson_nameperson_photoperson_timezonephone_localeproject_nameproject_stepsproject_photo

Query parameters

beforeVersioninteger

Reads the changes made before this version; left out, from the newest.

At least 1
limitinteger

How many changes a page holds.

From 1 to 100
Default50

Response

200 The changes.

changesarray of objects

The setting's changes, newest first.

Show properties of changesHide properties of changes
actorIdstring, uuid

The person who made the change.

beforestring, number, boolean, array, object or null

The value before the change.

afterstring, number, boolean, array, object or null

The value after the change.

versioninteger

The setting's version after the change.

At least 1
changedAtstring, date-time

When the change was made.

viaobject

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
kindenum

connection for an app connected by sign-in, key for an API key.

Allowed valuesconnectionkey
namestring

The app's or the key's name, as Werk shows it.

At least 1 character
verifiedboolean

True when Werk verified the app's identity.

labelstring

The caption Werk shows beside the change, in the reader's language.

At least 1 character
nextBeforeVersioninteger or null

The version to read the next, older page from as beforeVersion, or null when none remains.

At least 1

Errors

400invalid_queryThe 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).
400invalid_settingThe 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).
401session_revokedThe request carries no session the server holds, or its session has ended.
401session_expiredThe session has expired.
404not_foundThe route or record the request names does not exist, or is not one the signed-in person can reach.
409session_changedThe session changed while the request was in flight.
rate_limitedMore requests of this kind were sent than Werk takes within the time it counts them over.
500server_errorThe server could not complete the request, and it is not known whether a write it holds was made.
curl
curl "https://api.getwerk.ai/api/v1/settings/translate_cards/history?limit=20" \
  -H "Authorization: Bearer wk_key_..."
TypeScript
const res = await fetch("https://api.getwerk.ai/api/v1/settings/translate_cards/history?limit=20", {
  headers: {
    Authorization: "Bearer wk_key_...",
  },
});
const answer = await res.json();
200JSON
{
  "changes": [
    {
      "actorId": "5d1f3a2e-8c4b-4e7a-9f21-3b6c8d0e1a42",
      "before": false,
      "after": true,
      "version": 1,
      "changedAt": "2026-10-30T12:00:00.000Z"
    }
  ],
  "nextBeforeVersion": null
}