Get workspace settings

Read workspace-level settings: LLM token limit, contact memory prompt, Conductor limit, webhook timeout and more.

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

Returns the workspace-level settings. The settings row is created with defaults the first time it is read. Any role can read it.

Request#

This endpoint takes no path, query or body parameters.

Example request#

curl https://api.tried.com.au/workspace/settings \
  -H "Authorization: Bearer $TRIED_API_KEY"

const res = await fetch("https://api.tried.com.au/workspace/settings", {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const settings = await res.json();

import os, requests

res = requests.get(
    "https://api.tried.com.au/workspace/settings",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
settings = res.json()

Response#

200 OK

{
  "llm_token_limit": 32768,
  "reliability": {
    "fallback_voice_id": null,
    "llm_fallback_model": null,
    "stt_fallback_provider": null,
    "llm_fallback_timeout_ms": 4000
  },
  "memory_prompt": "Keep a short, factual brief about this contact for future conversations: who they are, what they asked for, decisions and commitments made, open follow-ups, and stated preferences (time, channel, language). Drop small talk. Update or remove facts that the latest conversation changed. Use short bullet points.",
  "memory_prompt_is_default": true,
  "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": null,
  "recording_retention_days": 30,
  "recording_retention_options": [30, 90, 180, 365, 730],
  "recording_retention_price_per_min": 0
}

Field	Type	Description
`llm_token_limit`	integer	LLM token limit for the workspace. Default `32768`.
`reliability`	object	Provider fallback preferences. Same shape as Get reliability settings.
`memory_prompt`	string	Prompt used to write contact memory after each conversation. Returns the built-in default when you have not set one.
`memory_prompt_is_default`	boolean	`true` when no custom memory prompt is stored.
`memory_prompt_max_chars`	integer	Longest memory prompt you can store: `2000`.
`account_state`	string	Last stored account state: `active`, `verification_needed`, `invoice_past_due` or `invoice_overdue`. Get account status recomputes it.
`account_state_reason`	string or null	Why the account is in that state.
`conductor_payg_enabled`	boolean	Whether paid Conductor credits are allowed once free credits run out. Default `false`.
`conductor_monthly_limit`	number	AUD of paid Conductor credits allowed per month. Default `0`.
`owner_user_id`	string or null	User who owns the workspace. Set by Transfer workspace.
`webhook_timeout_ms`	integer or null	Account-level webhook timeout, used when an agent has no `webhook_timeout_ms`. `null` means the 10 second default.
`recording_retention_days`	integer	Days recordings are kept after a call ends. Default `30`.
`recording_retention_options`	integer[]	Allowed values for `recording_retention_days`.
`recording_retention_price_per_min`	number	Extra AUD per recorded minute at the current setting. `0` at 30 days.

Errors#

Status	When
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request. This route needs the `admin` scope.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.