{"openapi":"3.1.0","info":{"title":"Astra DB (BYOK) API","version":"0.1.0","description":"Astra DB (BYOK) lets an AI assistant read your own Astra DB data through the Astra DB API with a key you supply (application token (starts with AstraCS:, with org-db-view and related read roles)). Read-only: 8 tools (list_databases, get_database, list_database_datacenters, list_available_regions, list_serverless_regions, list_access_lists, list_database_snapshots, get_current_organization). The...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-astra-db.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-astra-db/docs"},"termsOfService":"https://connectorbay.com/byok-astra-db/terms"},"servers":[{"url":"https://byok-astra-db.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-astra-db/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_databases":{"post":{"operationId":"list_databases","summary":"List Astra databases of the organization with name, cloud, region, tier, status, keyspace and storage. Cursor paginated ","description":"List Astra databases of the organization with name, cloud, region, tier, status, keyspace and storage. Cursor paginated by database ID. Use for \"Which Astra DB databases do I have and are they active\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"include":{"anyOf":[{"enum":["nonterminated","all","active","pending","preparing","prepared","initializing","parked","parking","unparking","terminating","terminated","resizing","error","maintenance","suspended"],"type":"string"},{"type":"null"}],"default":"nonterminated","description":"Which databases to include: nonterminated (default), all, active, pending, parked, terminated, error, maintenance, suspended and other states.","title":"Include"},"provider":{"anyOf":[{"enum":["ALL","GCP","AWS","AZURE"],"type":"string"},{"type":"null"}],"default":"ALL","description":"Only databases on this cloud: ALL, GCP, AWS or AZURE.","title":"Provider"},"starting_after":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor: return databases after this database ID (the last ID of the previous page).","title":"Starting After"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many databases to return (1 to 100, default 25).","title":"Limit"}},"title":"list_databasesArguments","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_database":{"post":{"operationId":"get_database","summary":"Get one Astra database by ID with its cloud, region, tier, status, keyspaces, storage, data API endpoint and the actions","description":"Get one Astra database by ID with its cloud, region, tier, status, keyspaces, storage, data API endpoint and the actions currently available for it. Use for \"Show the details of my Astra database\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"database_id":{"description":"Astra database ID (a UUID), as returned by list_databases.","maxLength":64,"title":"Database Id","type":"string"}},"required":["database_id"],"title":"get_databaseArguments","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_database_datacenters":{"post":{"operationId":"list_database_datacenters","summary":"List the datacenters (regions) of one Astra database with tier, status, cloud, region, zone and capacity units. Use for ","description":"List the datacenters (regions) of one Astra database with tier, status, cloud, region, zone and capacity units. Use for \"In which regions is my Astra database deployed\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"database_id":{"description":"Astra database ID (a UUID), as returned by list_databases.","maxLength":64,"title":"Database Id","type":"string"},"all":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to include datacenters that are not active.","title":"All"}},"required":["database_id"],"title":"list_database_datacentersArguments","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_available_regions":{"post":{"operationId":"list_available_regions","summary":"List cloud regions and tiers available to the organization with their price in cents per hour and month and the database","description":"List cloud regions and tiers available to the organization with their price in cents per hour and month and the database and capacity limits. Use for \"Which Astra regions can I create a database in and what do they cost\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_available_regionsArguments","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_serverless_regions":{"post":{"operationId":"list_serverless_regions","summary":"List the Astra serverless regions with cloud provider, display name, zone, classification and whether they are enabled. ","description":"List the Astra serverless regions with cloud provider, display name, zone, classification and whether they are enabled. Use for \"Which Astra serverless regions exist\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"region_type":{"anyOf":[{"enum":["serverless","vector"],"type":"string"},{"type":"null"}],"default":null,"description":"Region type filter: serverless or vector (leave out for the default).","title":"Region Type"}},"title":"list_serverless_regionsArguments","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_access_lists":{"post":{"operationId":"list_access_lists","summary":"List the IP access lists configured for the organization's databases with addresses and whether the list is enabled. Use","description":"List the IP access lists configured for the organization's databases with addresses and whether the list is enabled. Use for \"Which IP access lists protect my Astra databases\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_access_listsArguments","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_database_snapshots":{"post":{"operationId":"list_database_snapshots","summary":"List the snapshots of one Astra database, optionally within a time range or source region. The response shape is not doc","description":"List the snapshots of one Astra database, optionally within a time range or source region. The response shape is not documented, so full objects are returned. Use for \"Which snapshots exist for my Astra database\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"database_id":{"description":"Astra database ID (a UUID), as returned by list_databases.","maxLength":64,"title":"Database Id","type":"string"},"from_time":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only snapshots from this time (ISO 8601).","title":"From Time"},"to_time":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only snapshots up to this time (ISO 8601).","title":"To Time"},"source_region":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only snapshots taken in this source region.","title":"Source Region"}},"required":["database_id"],"title":"list_database_snapshotsArguments","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_current_organization":{"post":{"operationId":"get_current_organization","summary":"Show the organization the application token belongs to. The response shape is not documented, so the full object is retu","description":"Show the organization the application token belongs to. The response shape is not documented, so the full object is returned. Use for \"Which Astra organization is my token for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_current_organizationArguments","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}}}}