List agents using an app
List the agents in a workspace that use a connected app's tools (the connection modal's "Used by" set). An agent counts only through its OWN enabled, active connection to the toolkit; a workspace-level connection makes the app available to add but lists no agents on its own. Pass the toolkit slug (from list_workspace_connections). Returns { agents: [{ id, name, slug }], total }. Any workspace member can read it.
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/list_connection_agents" \ -H "Content-Type: application/json" \ -d '{ "workspace": "string", "toolkit": "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
}List channels POST
List the agent's channels. `declared` is what the agent serves ('voice' = phone numbers and the website call pill, 'text' = website chat widget and share link); change it with set_agent_channels. `channels` are the website surface rows with each one's enabled state and presentation config (greeting bubble, consent line); toggle one with set_channel. The brain (prompt, tools, knowledge base) is shared across channels.
List connector tools POST
List the actions/tools a connected app exposes, so you can choose which to enable on an agent with set_agent_connection's `allowedTools`. Returns `tools`, each `{ slug, name, description }`, plus `nextCursor` for paging and `totalItems`. `toolkit` is the toolkit slug (from list_available_connectors or list_agent_connections). Pass `search` (min 3 chars) to filter by keyword. By default this returns the app's FULL tool catalogue; pass `important: true` for only the provider's curated high-signal subset, but note some large toolkits (e.g. HighLevel, 200+ tools) have zero 'important' tools, so the default full list is usually what you want. This is the discovery half of set_agent_connection: call it to get valid tool slugs before scoping an agent's allowed tools.