List the settings
GEThttps://api.getwerk.ai/api/v1/settings
The key's person's own settings, each with its value and whether a key may change it.
An API key may change the translation of cards only; the rest are changed in Werk's apps.
Authorization
AuthorizationheaderRequired
Authorization: Bearer <key> Authentication
Response
200 The settings.
levelenum
Whose settings these are: the account's or a project's.
Allowed valuespersonprojectproject_person
settingsarray of objects
Each setting with its value.
Show properties of settingsHide properties of settings
keyenum
The setting's name.
Allowed valuesbrief_time brief_on brief_resume_date email_due_notices email_own_reminders email_invitations push_my_cards push_due_notices push_own_reminders push_invitations push_project_people push_from_werk translate_cards translate_offer cards_drawer_level quiet_hours_on quiet_start quiet_end quiet_days quiet_until due_notice_lead colorhighlightedmutedin_morning_brief translate_offer_closed
valueboolean or null
The setting's value.
versioninteger
The setting's version, which a change sends as expectedVersion; 0 for one never set.
At least 0
updatedAtstring, date-time or null
When it last changed, or null when never set.
canWriteboolean
True when the caller may change it.
Errors
400
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).401
session_revoked The request carries no session the server holds, or its session has ended.401
session_expired The session has expired.404
not_found The route or record the request names does not exist, or is not one the signed-in person can reach.409
session_changed The session changed while the request was in flight.429
rate_limited More requests of this kind were sent than Werk takes within the time it counts them over.500
server_error The 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" \
-H "Authorization: Bearer wk_key_..."TypeScript
const res = await fetch("https://api.getwerk.ai/api/v1/settings", {
headers: {
Authorization: "Bearer wk_key_...",
},
});
const answer = await res.json();200JSON
{
"level": "person",
"settings": [
{
"key": "translate_cards",
"value": true,
"version": 1,
"updatedAt": "2026-10-30T12:00:00.000Z",
"canWrite": true
}
]
}Send a requestGET
It is sent with the key you give, as you. A change made here is real.
JSON
The request could not be sent, or its response could not be read.