{"openapi":"3.1.0","info":{"title":"Anchor Browser (BYOK) API","version":"0.1.0","description":"Anchor Browser (BYOK) lets an AI assistant read your own Anchor Browser data through the Anchor Browser API with a key you supply (API key). Read-only: 8 tools (list_sessions_status, get_session_usage_history, get_session_tags, list_applications, get_application, list_application_identities, list_application_auth_flows, get_task_run_status). The BYOK key travels with each request, is used for...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-anchorbrowser.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-anchorbrowser/docs"},"termsOfService":"https://connectorbay.com/byok-anchorbrowser/terms"},"servers":[{"url":"https://byok-anchorbrowser.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-anchorbrowser/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/list_sessions_status":{"post":{"operationId":"list_sessions_status","summary":"List the browser sessions of the account with session ID, status, tags and creation time (connection URLs are not return","description":"List the browser sessions of the account with session ID, status, tags and creation time (connection URLs are not returned). Use for \"Which Anchor Browser sessions do I have and what state are they in\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tags":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only sessions with these tags (as the provider expects them, for example a single tag).","title":"Tags"},"domains":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only sessions that visited this domain.","title":"Domains"},"created_from":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only sessions created after this time. Date-time in ISO 8601 format, for example 2025-01-31T00:00:00Z.","title":"Created From"},"created_to":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only sessions created before this time. Date-time in ISO 8601 format, for example 2025-01-31T00:00:00Z.","title":"Created To"},"batch_id":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only sessions of this batch ID.","title":"Batch Id"},"task_initiated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for sessions started by a task run, false for the others.","title":"Task Initiated"},"proxy":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for sessions that used a proxy, false for the others.","title":"Proxy"},"extra_stealth":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for sessions with extra stealth, false for the others.","title":"Extra Stealth"},"profile_name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only sessions that used this browser profile.","title":"Profile Name"}},"title":"list_sessions_statusArguments","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_session_usage_history":{"post":{"operationId":"get_session_usage_history","summary":"Get session usage analytics per hour, day, week or month: session count, session hours, proxy bytes, AI steps, screensho","description":"Get session usage analytics per hour, day, week or month: session count, session hours, proxy bytes, AI steps, screenshots and credits used, with totals. Use for \"How many Anchor Browser sessions and credits did I use this month\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"from_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Start of the range. Date-time in ISO 8601 format, for example 2025-01-31T00:00:00Z.","title":"From Date"},"to_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"End of the range. Date-time in ISO 8601 format, for example 2025-01-31T00:00:00Z.","title":"To Date"},"granularity":{"anyOf":[{"enum":["hour","day","week","month"],"type":"string"},{"type":"null"}],"default":"day","description":"Bucket size: hour, day (default), week or month.","title":"Granularity"},"page":{"anyOf":[{"maximum":100000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"limit":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":100,"description":"Rows per page (1 to 1000, default 100).","title":"Limit"}},"title":"get_session_usage_historyArguments","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_session_tags":{"post":{"operationId":"get_session_tags","summary":"Get the tags attached to a browser session. Use for \"What tags does this Anchor Browser session have\".","description":"Get the tags attached to a browser session. Use for \"What tags does this Anchor Browser session have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"session_id":{"description":"Browser session ID, as returned by list_sessions_status.","maxLength":100,"title":"Session Id","type":"string"}},"required":["session_id"],"title":"get_session_tagsArguments","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_applications":{"post":{"operationId":"list_applications","summary":"List the managed-login applications (target websites) with name, URL, identity count, auth methods and creation and upda","description":"List the managed-login applications (target websites) with name, URL, identity count, auth methods and creation and update times. Use for \"Which applications do I have set up for managed sign-in in Anchor Browser\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"search":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only applications whose name or URL matches this text.","title":"Search"}},"title":"list_applicationsArguments","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_application":{"post":{"operationId":"get_application","summary":"Get one managed-login application by ID with name, URL, identity count and auth methods. Use for \"Show this Anchor Brows","description":"Get one managed-login application by ID with name, URL, identity count and auth methods. Use for \"Show this Anchor Browser application\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"application_id":{"description":"Application ID, as returned by list_applications.","maxLength":100,"title":"Application Id","type":"string"}},"required":["application_id"],"title":"get_applicationArguments","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_application_identities":{"post":{"operationId":"list_application_identities","summary":"List the identities (saved sign-ins) of an application with name, auth flow, validation status and times (credentials ar","description":"List the identities (saved sign-ins) of an application with name, auth flow, validation status and times (credentials are not returned). Use for \"Which identities are linked to this Anchor Browser application\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"application_id":{"description":"Application ID, as returned by list_applications.","maxLength":100,"title":"Application Id","type":"string"},"search":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only identities whose name matches this text.","title":"Search"}},"required":["application_id"],"title":"list_application_identitiesArguments","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_application_auth_flows":{"post":{"operationId":"list_application_auth_flows","summary":"List the authentication flows of an application with name, methods, whether it is the recommended one and the custom fie","description":"List the authentication flows of an application with name, methods, whether it is the recommended one and the custom field names it asks for. Use for \"How can people sign in to this Anchor Browser application\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"application_id":{"description":"Application ID, as returned by list_applications.","maxLength":100,"title":"Application Id","type":"string"}},"required":["application_id"],"title":"list_application_auth_flowsArguments","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_task_run_status":{"post":{"operationId":"get_task_run_status","summary":"Get the status of an automation task run (queued, running, success, failure, timeout or cancelled) with its error text a","description":"Get the status of an automation task run (queued, running, success, failure, timeout or cancelled) with its error text and session ID. Use for \"Did my Anchor Browser task run finish\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"run_id":{"description":"Task run ID, as returned when the run was started.","maxLength":100,"title":"Run Id","type":"string"}},"required":["run_id"],"title":"get_task_run_statusArguments","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}}}}