Browser-session-only preferences for an accessible workspace. Up to 50 named selections per person and workspace, including viewers. Saves definitions, filters and period, never results or computation jobs. Writes require CSRF. Reuse the client-generated ID and identical create payload after a lost response. Updates and deletion require the current expected_revision; stale changes return 409. Source permissions and result expiry remain unchanged.
Browser-session-only preferences for an accessible workspace. Up to 50 named selections per person and workspace, including viewers. Saves definitions, filters and period, never results or computation jobs. Writes require CSRF. Reuse the client-generated ID and identical create payload after a lost response. Updates and deletion require the current expected_revision; stale changes return 409. Source permissions and result expiry remain unchanged.
Browser session: __Host-mb_session cookie.
When using a browser session for a mutation, send the current CSRF token in X-CSRF-Token with the same-site cookie. OAuth consent uses its documented form field.
Browser CSRF cookie value. Not required when an allowed machine management credential is used.
Origin
Header
string; {"format":"uri"}
No
If present, must match the canonical HTTPS origin. Sec-Fetch-Site cross-site is rejected.
workspace_id
URL query
string; {"format":"uuid"}
Yes
Limit the list to an accessible workspace.
id
Path
string; {"format":"uuid"}
Yes
Resource ID in this workspace
expected_revision
URL query
integer; {"minimum":1}
Yes
Browser-session-only preferences for an accessible workspace. Up to 50 named selections per person and workspace, including viewers. Saves definitions, filters and period, never results or computation jobs. Writes require CSRF. Reuse the client-generated ID and identical create payload after a lost response. Updates and deletion require the current expected_revision; stale changes return 409. Source permissions and result expiry remain unchanged.
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
The default referrer policy is strict-origin-when-cross-origin. Provider-login responses use no-referrer to protect login parameters.
Vary
string
Responses vary by Accept-Language; browser-rendered responses can also vary by the preference cookie.
X-Content-Type-Options
JSON; {"const":"nosniff"}
The browser must use the declared content type.
X-Frame-Options
JSON; {"const":"DENY"}
The response must not be embedded in a frame.
X-Request-ID
string
Server-generated request identifier. Include this when reporting an error; inbound values are not trusted.
application/json
Field
Type and limits
Required
Meaning
$
object
Yes
—
$.deleted
boolean; {"const":true}
Yes
—
Stable error codes
invalid_language
invalid_preferences
invalid_timezone
Header
Type and limits
Meaning
Cache-Control
string; {"pattern":"(?:^|,\\s*)no-store(?:,|$)"}
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
Private API responses prohibit storage. Public OAuth metadata is cached for 300 seconds; live streams additionally prohibit transformation.
Content-Language
string; {"enum":["en","de"]}
Language of human-readable response text, resolved from Accept-Language or the documented browser preference. Technical codes and identifiers remain stable.
This change does not have a general retry guarantee. If the response is unclear, read the affected resource before trying again. Follow Retry-After waiting times and request new sign-in or action codes when they expire.
Replace demo IDs, timestamps and placeholders with your own values. For a retry, keep the same IDs, time and content. These examples do not run requests on this page.
Keep login links, codes, cookies and keys private. Do not print them in logs or share them in support requests.
Browser-session-only preferences for an accessible workspace. Up to 50 named selections per person and workspace, including viewers. Saves definitions, filters and period, never results or computation jobs. Writes require CSRF. Reuse the client-generated ID and identical create payload after a lost response. Updates and deletion require the current expected_revision; stale changes return 409. Source permissions and result expiry remain unchanged.
Browser-session-only preferences for an accessible workspace. Up to 50 named selections per person and workspace, including viewers. Saves definitions, filters and period, never results or computation jobs. Writes require CSRF. Reuse the client-generated ID and identical create payload after a lost response. Updates and deletion require the current expected_revision; stale changes return 409. Source permissions and result expiry remain unchanged.
Browser-session-only preferences for an accessible workspace. Up to 50 named selections per person and workspace, including viewers. Saves definitions, filters and period, never results or computation jobs. Writes require CSRF. Reuse the client-generated ID and identical create payload after a lost response. Updates and deletion require the current expected_revision; stale changes return 409. Source permissions and result expiry remain unchanged.