Connect an agent
Connects the platform a project’s agents run on. The body is shaped by provider; GET /v1/connections/agent/providers lists what each needs. Retell, Vapi, ElevenLabs and Bland keys are checked by listing agents first, so a refused key returns 400 and nothing is stored. Platforms that pull agents start syncing straight away. For LIVEKIT_SELF_HOSTED and the Pipecat providers, the response carries observerApiKey, shown once, for your SDK to report calls with. Most platforms connect once per project, and a second create returns 409; LiveKit Cloud may connect several accounts.
Authorizations
Body
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
Retell. Agents and calls are pulled from your account on a schedule.
What the connection does. Defaults to PULL_AGENTS and PULL_CALLS, plus PUSH_AGENT_CONFIG on Retell, Vapi and ElevenLabs.
1PULL_AGENTS imports the agents (and their prompts and tools) into Roark. PULL_CALLS imports production calls for analysis, and needs PULL_AGENTS on platforms that pull agents. PUSH_AGENT_CONFIG lets Roark write a verified fix back to the agent, only ever after a person applies it.
PULL_AGENTS, PULL_CALLS, PUSH_AGENT_CONFIG Response
The connection