Nurama Developers
Settings

Update resource settings

Create or update the caller's setting overrides for a specific resource. Each supplied category is shallow-merged into the existing overrides for that resource; at least one category is required. No check is made that the caller is a member of the resource.

PUT
/settings/{resourceType}/{resourceId}

Create or update the caller's setting overrides for a specific resource. Each supplied category is shallow-merged into the existing overrides for that resource; at least one category is required. No check is made that the caller is a member of the resource.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

resourceType*string

The resource type (workspace or project)

Value in

  • "workspace"
  • "project"
resourceId*string

The resource ID

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Body for PUT /settings/{resourceType}/{resourceId}. Each category is a free-form map — any setting key is accepted (the well-known keys are listed in ResourceSettingsOverrides). null clears an override so the parent level applies again. emailNotifications values may be boolean, number (interval settings) or null; the other categories accept boolean or null.

Properties1 <= properties

Response Body

application/json

application/json

application/json

curl -X PUT "https://example.com/settings/workspace/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "emailNotifications": {      "newMention": false,      "newMentionActiveInterval": 30    },    "sounds": {      "playSounds": null    }  }'
{  "message": "string",  "settings": {    "resourceId": "026d60bb-63a8-407e-bf67-01dcfc6022e6",    "resourceType": "workspace",    "emailNotifications": {},    "systemNotifications": {},    "sounds": {}  }}