{"openapi":"3.1.0","info":{"title":"ElevenLabs Workspace (BYOK) API","version":"0.1.0","description":"ElevenLabs Workspace (BYOK) lets an AI assistant read your own ElevenLabs Workspace data through the ElevenLabs Workspace API with a key you supply (API key (workspace admin permissions needed for some endpoints)). Read-only: 8 tools (get_workspace_usage, list_api_requests, list_webhooks, list_service_accounts, list_auth_connections, list_agent_secret_names, get_agent_settings,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-elevenlabs-workspace.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-elevenlabs-workspace/docs"},"termsOfService":"https://connectorbay.com/byok-elevenlabs-workspace/terms"},"servers":[{"url":"https://byok-elevenlabs-workspace.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-elevenlabs-workspace/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_workspace_usage":{"post":{"operationId":"get_workspace_usage","summary":"Get credit usage by product over a time range as a table (columns, units and rows), bucketed by interval. Times are Unix","description":"Get credit usage by product over a time range as a table (columns, units and rows), bucketed by interval. Times are Unix milliseconds, not before 2020-01-01. Use for \"How many ElevenLabs credits did each product use per day last week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_time":{"description":"Start of the range as a Unix timestamp in milliseconds.","title":"Start Time","type":"integer"},"end_time":{"description":"End of the range as a Unix timestamp in milliseconds.","title":"End Time","type":"integer"},"interval_seconds":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":86400,"description":"Bucket size in seconds, for example 3600 for hourly or 86400 for daily.","title":"Interval Seconds"},"time_zone":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":"UTC","description":"IANA time zone used to align buckets, for example Europe/London.","title":"Time Zone"}},"required":["start_time","end_time"],"title":"get_workspace_usageArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_api_requests":{"post":{"operationId":"list_api_requests","summary":"List recent API requests of the workspace as a table (columns and rows) between a start and optional end time, newest or","description":"List recent API requests of the workspace as a table (columns and rows) between a start and optional end time, newest or oldest first. Use for \"Which ElevenLabs API requests did my workspace make in the last day\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start_time":{"description":"Start of the range as a Unix timestamp in milliseconds.","title":"Start Time","type":"integer"},"end_time":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"End of the range as a Unix timestamp in milliseconds.","title":"End Time"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Rows to return (1 to 100, default 20).","title":"Limit"},"sort":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Timestamp order: asc or desc.","title":"Sort"}},"required":["start_time"],"title":"list_api_requestsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_webhooks":{"post":{"operationId":"list_webhooks","summary":"List workspace webhooks with name, id, auth type, disabled flags, creation time and most recent failure code (callback U","description":"List workspace webhooks with name, id, auth type, disabled flags, creation time and most recent failure code (callback URLs are not returned). Use for \"Which webhooks are set up in my ElevenLabs workspace and are any failing\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"include_usages":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include the products and events each webhook is attached to (admin keys only).","title":"Include Usages"}},"title":"list_webhooksArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_service_accounts":{"post":{"operationId":"list_service_accounts","summary":"List workspace service accounts with name, id and creation time (API key details are not returned). Use for \"Which servi","description":"List workspace service accounts with name, id and creation time (API key details are not returned). Use for \"Which service accounts exist in my ElevenLabs workspace\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_service_accountsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_auth_connections":{"post":{"operationId":"list_auth_connections","summary":"List workspace auth connections used by agent integrations with name, provider, auth type, status and last status update","description":"List workspace auth connections used by agent integrations with name, provider, auth type, status and last status update. Use for \"Are all my ElevenLabs agent auth connections still active\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_auth_connectionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_agent_secret_names":{"post":{"operationId":"list_agent_secret_names","summary":"List the names and ids of agent workspace secrets (secret values are never returned). Page size up to 100. Use for \"Whic","description":"List the names and ids of agent workspace secrets (secret values are never returned). Page size up to 100. Use for \"Which secrets are stored for my ElevenLabs agents\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"Secrets per page (1 to 100).","title":"Page Size"},"search":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only secrets whose name starts with this text.","title":"Search"},"cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's next_cursor to get the following page.","title":"Cursor"}},"title":"list_agent_secret_namesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_agent_settings":{"post":{"operationId":"get_agent_settings","summary":"Get workspace-level agent settings: MCP availability, data retention days, default LiveKit stack and post-call webhook e","description":"Get workspace-level agent settings: MCP availability, data retention days, default LiveKit stack and post-call webhook event types. Use for \"What are my ElevenLabs workspace agent settings\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_agent_settingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_agent_dashboard_settings":{"post":{"operationId":"get_agent_dashboard_settings","summary":"Get the charts configured on the agent analytics dashboard with type and name. Use for \"Which charts are on my ElevenLab","description":"Get the charts configured on the agent analytics dashboard with type and name. Use for \"Which charts are on my ElevenLabs agent dashboard\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_agent_dashboard_settingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}