Update workspace

PATCH

https://app.lumenia.net/api/v1/workspaces/:workspaceId

PATCH

/api/v1/workspaces/:workspaceId

$ curl -X PATCH https://app.lumenia.net/api/v1/workspaces/workspaceId \
>      -H "X-Account-Id: X-Account-Id" \
>      -H "Authorization: Bearer <API_KEY>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "Support (EU)"
> }'

1 {
2   "workspace": {
3     "branding": {
4       "background": "#ffd940",
5       "foreground": "#1a1a1a",
6       "logo": null
7     },
8     "chat": {
9       "historyLimit": 20,
10       "mode": "chat",
11       "prompt": "Answer only from the provided context.",
12       "temperature": 0.7
13     },
14     "counts": {
15       "attachedTools": 0,
16       "embeddedDocuments": 0
17     },
18     "createdAt": "2026-06-15T05:24:00.000Z",
19     "id": "9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
20     "knowledgeSearch": {
21       "queryRefusalMessage": "There is no relevant information in this workspace to answer your query.",
22       "similarityThreshold": 0.25,
23       "topResults": 4
24     },
25     "name": "New workspace name",
26     "organizationId": "3f2e1d0c-9b8a-4c7d-8e6f-5a4b3c2d1e0f",
27     "telegram": {
28       "connected": false
29     },
30     "voice": {
31       "connected": false
32     },
33     "whatsapp": {
34       "connected": false
35     }
36   }
37 }

Update selected workspace fields.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <API_KEY>, where API_KEY is your API key.

Path parameters

workspaceIdstringRequired

Workspace to update.

Request

Fields to update. Omitted fields remain unchanged. Use the integration endpoints to update voice, WhatsApp, or Telegram.

namestringOptional

New name shown to users.

chatobjectOptional

Conversation settings to update.

knowledgeSearchobjectOptional

Knowledge search settings to update.

brandingobjectOptional

Chat-widget appearance (partial).

Response

The updated workspace and its configuration.

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

Authentication

Path parameters

Headers

Request

Response

Errors