Update workspace settings

Change the LLM token limit, contact memory prompt, reliability fallbacks, Conductor limit, webhook timeout or recording retention.

PATCHhttps://api.tried.com.au/workspace/settings

Changes workspace-level settings. Send only the fields you want to change. Admin only.

Request#

Field	Type	Required	Description
`llm_token_limit`	integer	No	1024 to 131072.
`reliability`	object	No	Any subset of the fields in Update reliability settings. Merged into the current values.
`memory_prompt`	string or null	No	Up to 2000 characters. `null` or a blank string restores the default prompt.
`conductor_payg_enabled`	boolean	No	Allow paid Conductor credits.
`conductor_monthly_limit`	number	No	0 to 100000 AUD per month.
`webhook_timeout_ms`	integer or null	No	1000 to 60000. `null` returns to the 10 second default.
`recording_retention_days`	integer	No	How long recordings are kept: `30` (included), `90`, `180`, `365` or `730`. Longer than 30 is billed per recorded minute. See Recording retention.

account_state and owner_user_id are read-only here. Use Transfer workspace to change the owner.

Example request#

curl -X PATCH https://api.tried.com.au/workspace/settings \
  -H "Authorization: Bearer $TRIED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "llm_token_limit": 16384,
    "webhook_timeout_ms": 8000,
    "memory_prompt": "Note the patient's preferred clinic, dentist and appointment times. Use short bullet points."
  }'

const res = await fetch("https://api.tried.com.au/workspace/settings", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.TRIED_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "llm_token_limit": 16384,
    "webhook_timeout_ms": 8000,
    "memory_prompt": "Note the patient's preferred clinic, dentist and appointment times. Use short bullet points."
  }),
});
const settings = await res.json();

import os, requests

res = requests.patch(
    "https://api.tried.com.au/workspace/settings",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
    json={
        "llm_token_limit": 16384,
        "webhook_timeout_ms": 8000,
        "memory_prompt": "Note the patient's preferred clinic, dentist and appointment times. Use short bullet points.",
    },
)
settings = res.json()

Response#

200 OK

{
  "llm_token_limit": 16384,
  "reliability": {
    "fallback_voice_id": null,
    "llm_fallback_model": null,
    "stt_fallback_provider": null,
    "llm_fallback_timeout_ms": 4000
  },
  "memory_prompt": "Note the patient's preferred clinic, dentist and appointment times. Use short bullet points.",
  "memory_prompt_is_default": false,
  "memory_prompt_max_chars": 2000,
  "account_state": "active",
  "account_state_reason": null,
  "conductor_payg_enabled": false,
  "conductor_monthly_limit": 0,
  "owner_user_id": null,
  "webhook_timeout_ms": 8000
}

Returns all settings after the change. The fields are the same as Get workspace settings.

Errors#

Status	When
`400`	Validation failed, for example `llm_token_limit: Number must be greater than or equal to 1024` or `memory_prompt: String must contain at most 2000 character(s)`.
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request. This route needs the `admin` scope. A dashboard user without the right role gets `Requires role: admin`. API keys act as admin.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.