Change a project's setting
Changes one of the project's settings.
The project's owner and admins may change them; an API key may change the default due notice lead only. Refused when the setting changed since it was read.
Authorization
Authorization: Bearer <key> Authentication
Path parameters
The project's id.
Body
An id the caller makes for this request. Sent again with the same request, it returns the first answer and changes nothing twice; sent with a different request, it is refused.
The setting's name.
The setting's new value.
The setting's version as last read; when it changed since, the change is refused.
Response
200 The setting after the change.
The setting's name.
The setting's value.
The setting's version, which a change sends as expectedVersion; 0 for one never set.
When it last changed, or null when never set.
True when the caller may change it.
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.not_permitted The signed-in person's role, or whose the record is, does not allow this request.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.project_deleted The project is being deleted.project_archived The project is archived, so it does not take this request.setting_version_conflict The setting changed after the version the request names.request_conflict The request id was already used with another request, or the change it asks could not be made to the record it names.request_erased The request id belongs to a request whose record was erased.payload_too_large The request body has more bytes than the route takes.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 -X POST "https://api.getwerk.ai/api/v1/projects/2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73/settings" \
-H "Authorization: Bearer wk_key_..." \
-H "Content-Type: application/json" \
-d '{
"clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4b06",
"key": "due_notice_lead",
"value": "1_day",
"expectedVersion": 2
}'const res = await fetch("https://api.getwerk.ai/api/v1/projects/2f6c9e41-7a3b-4d58-9c1e-0b8d4f2a6e73/settings", {
method: "POST",
headers: {
Authorization: "Bearer wk_key_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
"clientRequestId": "f1e2d3c4-b5a6-4978-8a9b-0c1d2e3f4b06",
"key": "due_notice_lead",
"value": "1_day",
"expectedVersion": 2
}),
});
const answer = await res.json();{
"key": "due_notice_lead",
"value": "1_day",
"version": 3,
"updatedAt": "2026-11-21T14:05:00.000Z",
"canWrite": true
}Send a requestPOST
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.