Update a single project setting
Updates one key of the project's `settings` JSON column. Mirrors the workspace settings endpoint. Requires `canManageProjectSettings` (no subscription check on this route). At the project level every setting accepts `null`, meaning "inherit the workspace's value". Otherwise the type of `value` depends on `name`: - `allowAiFeatures`, `aiPolishEnabled`, `aiComposeEnabled`, `aiChatEnabled`, `aiAssistEnabled`, `aiTaskGenerationEnabled`, `aiImageRevisionEnabled`, `aiPolishAllowReviewer`, `aiComposeAllowReviewer`, `aiChatAllowReviewer`, `aiAssistAllowReviewer`, `aiTaskGenerationAllowReviewer`, `aiImageRevisionAllowReviewer` — boolean. - `aiAssistFollowUpWindow` — integer, 0–30. - `aiCustomPreprompt`, `aiTaskGenerationPreprompt` — string (may be empty; empty means "no preprompt", null means inherit). - `aiChatTools`, `aiAssistTools` — object mapping tool names (`^[a-z][a-z0-9_]*$`) to boolean or null. - `originalPruning` — an `OriginalPruningPolicy` object, or null to turn automatic pruning off. A `value` of the wrong type for the setting is a validation error (400).
Updates one key of the project's settings JSON column. Mirrors the
workspace settings endpoint. Requires canManageProjectSettings
(no subscription check on this route).
At the project level every setting accepts null, meaning "inherit the
workspace's value". Otherwise the type of value depends on name:
allowAiFeatures,aiPolishEnabled,aiComposeEnabled,aiChatEnabled,aiAssistEnabled,aiTaskGenerationEnabled,aiImageRevisionEnabled,aiPolishAllowReviewer,aiComposeAllowReviewer,aiChatAllowReviewer,aiAssistAllowReviewer,aiTaskGenerationAllowReviewer,aiImageRevisionAllowReviewer— boolean.aiAssistFollowUpWindow— integer, 0–30.aiCustomPreprompt,aiTaskGenerationPreprompt— string (may be empty; empty means "no preprompt", null means inherit).aiChatTools,aiAssistTools— object mapping tool names (^[a-z][a-z0-9_]*$) to boolean or null.originalPruning— anOriginalPruningPolicyobject, or null to turn automatic pruning off.
A value of the wrong type for the setting is a validation error (400).
OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.
In: header
Scope: projects:write
Path Parameters
Unique ID of the project.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$uuidThe project setting to update. Only the listed names are accepted.
Value in
- "allowAiFeatures"
- "aiPolishEnabled"
- "aiComposeEnabled"
- "aiChatEnabled"
- "aiAssistEnabled"
- "aiAssistFollowUpWindow"
- "aiTaskGenerationEnabled"
- "aiImageRevisionEnabled"
- "aiPolishAllowReviewer"
- "aiComposeAllowReviewer"
- "aiChatAllowReviewer"
- "aiAssistAllowReviewer"
- "aiTaskGenerationAllowReviewer"
- "aiImageRevisionAllowReviewer"
- "aiCustomPreprompt"
- "aiTaskGenerationPreprompt"
- "aiChatTools"
- "aiAssistTools"
- "originalPruning"
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X PATCH "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/settings/allowAiFeatures" \ -H "Content-Type: application/json" \ -d '{ "value": false }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "workspaceId": "ef0efa32-d1c1-43d4-a5e2-fe7b4f00403c", "name": "string", "slug": "string", "color": "string", "logo": "3c06f846-1ab1-40a9-8645-a19a9fdeae85", "settings": {}, "status": "active", "createdAt": 1678886400000, "updatedAt": 1678886400000}