analytics3

auth14

billing11

catalog1

chat9

connector2

enrichment18

exclusions4

favorite2

filters1

first-query1

import6

internal115

knowledge8

layer4

map8

notes4

project30

project-lock4

query1

release-notes1

saved-contacts11

share23

skills5

table12

terms1

user-events1

workspace9

workspace

Update Workspace

Update workspace settings. Requires workspace admin for the name field.

All fields are optional. Only provided fields are updated.

patch/api/v1/workspace

Request body

namestring nullable

New name for the workspace

avatar_colorstring nullable

Avatar color name for the workspace. Set to null to remove.

agent_fill_row_ceilinginteger nullable

Rows MAIA may fill within one reply before asking. Omit to leave unchanged; set to null to go back to the default. Zero means ask every time.

Response

Successful Response

idstring uuid required

namestring required

avatar_colorstring nullable

created_atstring date-time nullable

budget_authority'credits' | 'paid_balance' required

Which budget a metered run draws down.

Two members, because there are two budgets. Free usage and paid usage are the same balance on the same account, spent at the same prices and refused by the same check; what a workspace paid for that balance decides what its refusal offers next, not how the run is admitted. A third member for the free tier is what let the two drift — different prices, different exemptions, different per-run sizing — while both claimed to meter usage.

member_countinteger required

feature_togglesobject

workspace_type'standard' | 'discovery' required

on_free_planboolean

national_county_coverageboolean

manage_billing_availableboolean

Changes

Changed in 7 of the 30 revisions of this API.6316

Sep 19, 2026924eeadc29ad3See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
Sep 19, 20268fb358001d371See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
Sep 18, 202673f618ba0a7e1See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
Sep 16, 202695495ef535bc2See the full diff
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
This revision also has 18 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 15, 2026499d0b94aa9423See the full diff
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ▲
  removed the required property // from the response with the status
  response-required-property-removed
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
Sep 12, 2026604ea84d0ff714See the full diff
- ●
  added the new paid_balance enum value to the response property for the response status
  response-property-enum-value-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  removed the discovery_allowance enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  added the required property to the response with the status
  response-required-property-added
Aug 26, 2026b8fec14143f244See the full diff
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added subschema #2 to the response property anyOf list for the response status
  response-property-any-of-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added

Full history