Get workspace settings
Read a workspace's settings: name, URL slug, timezone, language, how many tests run at once in a batch (evalConcurrency), and the privacy and retention settings (call retention, audit log retention, what transcripts keep, which personal details are hidden, call recording, who may download recordings, what reaches support tools and analytics, IP capture, session replay, and zero data retention). Read this before changing any of them.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Header Parameters
A key you choose, such as a UUID, that makes this POST safe to retry. Within 24 hours the same key and request answers with the first successful answer and runs nothing, the same key with a different request answers 422 idempotency_key_reused, and a key whose request is still running answers 409 idempotency_key_in_use. A failed request keeps nothing, so the same key runs it again.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Workspace slug (see whoami).
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/operations/get_workspace_settings" \ -H "Content-Type: application/json" \ -d '{ "workspace": "string" }'{}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}Get transcript POST
Get a session's conversation transcript (id from list_calls, or a run's sessionId from get_test_results). Defaults to a compact, ready-to-read text rendering of the call (turns merged, each tool call shown as one line with a clipped result). Pass format:"json" for structured message rows, as JSON inside an untrusted-data block (tool payloads clipped unless full:true; each row's metadata, such as interruption times and word timings, with include_metadata:true). Returns session_not_found if the id doesn't resolve to a session you can access. For everything recorded about a call (timing, spans, recordings, metrics, carrier events), use get_call_bundle.
Connect an app POST
Begin connecting an app for THIS agent and return an authorization link the operator opens to finish. The agent gets its OWN dedicated account for the app, so two agents can connect two distinct accounts of the same app. Returns `{ redirectUrl, connectionId, status: 'pending' }`, relay the redirectUrl to the operator; the connection flips to 'active' once they authorize (poll with list_agent_connections). Once active the agent loads the app's recommended tools automatically; narrow them later with set_agent_connection. One-click and bring-your-own-key apps connect through here; apps that require the operator's own OAuth-app credentials are refused with a message pointing to Connected apps in the app, which collects them (secrets never pass through this op). Requires workspace-admin.