Error

A valid request URL is required to generate request examples

{
  "success": true,
  "data": {
    "reportTimezone": "America/New_York"
  }
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

Meta

Update the organization's report settings (org/me write)

The WRITE half of the org “org/me” settings surface. Sets the org’s writable preferences — today the Observe REPORT timezone (reportTimezone). The report timezone is the first source in the reporting-tz precedence chain: when set, the app applies it (over the browser tz) as the default ?tz= on every metric query, the day-bucket axis labels, the report schedule’s default tz, and the print/PDF window; when unset, the client falls through to the browser tz. A non-empty reportTimezone MUST be a valid IANA zone (an unknown/malformed zone is rejected 400); an empty string CLEARS the preference (revert to the browser-tz default). Org-scoped: writes the caller’s OWN organization row. Available to any authenticated principal (dual-auth) — no special scope is required.

PATCH

/

meta

/

account

Error

A valid request URL is required to generate request examples

{
  "success": true,
  "data": {
    "reportTimezone": "America/New_York"
  }
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Flowyte secret API key (Authorization: Bearer flowyte_sk_live_…). Scope-gated; is scoped to your organization — a key can never reach another tenant. The listed scopes in each operation's apiKey requirement are the scopes that key must hold. The tokenUrl is nominal: keys are minted in the dashboard.

Body

application/json

At least one writable field must be present (reportTimezone and/or callRecording); an all-empty body is a 400. Each field is applied independently.

reportTimezone

string

A valid IANA timezone (e.g. America/New_York) to set as the org's Observe report timezone, or an empty string to CLEAR the preference (revert to the browser-tz default). Max 64 chars; the non-portable Local alias is rejected.

callRecording

object

The org's call-recording preference (customer opt-in + retention). Both sub-fields are optional — an omitted sub-field keeps the stored value (toggle-only / retention- only PATCH). PLUMBING ONLY: the recording pipeline is globally gated OFF, so this is stored and honored but records nothing until the pipeline is enabled.

Show child attributes

Response

The stored value(s) for the field(s) that were updated — reportTimezone (empty string when cleared) and/or callRecording. Only the fields present in the request are echoed.

success

boolean

required

data

object

required

Show child attributes

message

string

errors

object[]

Show child attributes