Connect an app
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.
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.
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/initiate_agent_connection" \ -H "Content-Type: application/json" \ -d '{ "toolkit": "string", "agent": "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 workspace settings POST
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.
Invite member POST
Invite an email address to the workspace at a role (default editor). Roles: admin can do everything including members and billing; editor builds and tests agents; viewer sees agents and calls but changes nothing; reader sees calls and insights in the portal only. Sends the invitation email and returns the invite link; someone who already has an account is added straight away and told by email. Pass agentIds to limit them to specific agents: a limited person sees only those agents and does not use a seat. Refused at the seat limit and for someone already a member. Making someone an owner is not possible here.