{"openapi":"3.1.0","info":{"title":"Grafana Cloud (BYOK) API","version":"0.1.0","description":"Grafana Cloud (BYOK) lets an AI assistant read your own Grafana Cloud data through the Grafana Cloud API with a key you supply (Grafana Cloud access policy token (or grafana.com API key) with read scopes for the objects these tools read). Read-only: 5 tools (get_org, get_org_settings, get_billed_usage, get_billed_usage_history, list_org_stack_regions). The BYOK key travels with each request, is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-grafana-cloud-org.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-grafana-cloud-org/docs"},"termsOfService":"https://connectorbay.com/byok-grafana-cloud-org/terms"},"servers":[{"url":"https://byok-grafana-cloud-org.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-grafana-cloud-org/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_org":{"post":{"operationId":"get_org","summary":"Get a Grafana Cloud organization: name, URL, plan, support plan, quotas and current usage counters for metrics, logs, tr","description":"Get a Grafana Cloud organization: name, URL, plan, support plan, quotas and current usage counters for metrics, logs, traces, profiles and users. Use for \"What is my Grafana Cloud organization's current usage\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_slug_or_id":{"description":"Slug or numeric id of the Grafana Cloud organization, for example 'mycompany'.","maxLength":200,"title":"Org Slug Or Id","type":"string"}},"required":["org_slug_or_id"],"title":"get_orgArguments","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_org_settings":{"post":{"operationId":"get_org_settings","summary":"Get organization security settings: MFA requirement, token expiry limit and allowed invite domains. Use for \"Does my Gra","description":"Get organization security settings: MFA requirement, token expiry limit and allowed invite domains. Use for \"Does my Grafana Cloud organization require MFA\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_slug_or_id":{"description":"Slug or numeric id of the Grafana Cloud organization, for example 'mycompany'.","maxLength":200,"title":"Org Slug Or Id","type":"string"}},"required":["org_slug_or_id"],"title":"get_org_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_billed_usage":{"post":{"operationId":"get_billed_usage","summary":"Get the billed usage lines of a month: dimension, unit, total usage, included usage, overage and amount due. Use for \"Wh","description":"Get the billed usage lines of a month: dimension, unit, total usage, included usage, overage and amount due. Use for \"What did Grafana Cloud bill me for in September 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_slug_or_id":{"description":"Slug or numeric id of the Grafana Cloud organization, for example 'mycompany'.","maxLength":200,"title":"Org Slug Or Id","type":"string"},"month":{"description":"Month number, 1 to 12.","maximum":12,"minimum":1,"title":"Month","type":"integer"},"year":{"description":"Four digit year, for example 2026.","maximum":2100,"minimum":2020,"title":"Year","type":"integer"}},"required":["org_slug_or_id","month","year"],"title":"get_billed_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/get_billed_usage_history":{"post":{"operationId":"get_billed_usage_history","summary":"List the months (month and year) for which billed usage is available, covering the last 12 months. Use for \"For which mo","description":"List the months (month and year) for which billed usage is available, covering the last 12 months. Use for \"For which months can I see Grafana Cloud billed usage\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_slug_or_id":{"description":"Slug or numeric id of the Grafana Cloud organization, for example 'mycompany'.","maxLength":200,"title":"Org Slug Or Id","type":"string"}},"required":["org_slug_or_id"],"title":"get_billed_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/list_org_stack_regions":{"post":{"operationId":"list_org_stack_regions","summary":"List the stack regions enabled for an organization, optionally for one region slug or id. Use for \"Which Grafana Cloud r","description":"List the stack regions enabled for an organization, optionally for one region slug or id. Use for \"Which Grafana Cloud regions are enabled for my organization\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"org_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Numeric id of the organization to filter by.","title":"Org Id"},"region_slug_or_id":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only the entry for this region slug or id.","title":"Region Slug Or Id"}},"title":"list_org_stack_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}}}}