{"openapi":"3.1.0","info":{"title":"Datadog Status Pages (BYOK) API","version":"0.1.0","description":"Datadog Status Pages (BYOK) lets an AI assistant read your own Datadog Status Pages data through the Datadog Status Pages API with a key you supply (Datadog API key (US1 site, datadoghq.com)). Read-only: 8 tools (list_status_pages, get_status_page, list_components, list_degradations, get_degradation, list_maintenances, list_degradation_templates, list_maintenance_templates). The BYOK key travels...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-datadog-status-pages.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-datadog-status-pages/docs"},"termsOfService":"https://connectorbay.com/byok-datadog-status-pages/terms"},"servers":[{"url":"https://byok-datadog-status-pages.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-datadog-status-pages/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_status_pages":{"post":{"operationId":"list_status_pages","summary":"List Datadog status pages with name, domain prefix, custom domain, public URL, type, enabled flag and component statuses","description":"List Datadog status pages with name, domain prefix, custom domain, public URL, type, enabled flag and component statuses. Filter by name or exact domain prefix. Use for \"Which Datadog status pages do we have and are their components operational\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Case-insensitive substring of the page name.","title":"Name"},"domain_prefix":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Exact domain prefix to match (returns at most one page).","title":"Domain Prefix"},"page_limit":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many items to return (default 50).","title":"Page Limit"},"page_offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Offset to start from, for paging (default 0).","title":"Page Offset"}},"title":"list_status_pagesArguments","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_status_page":{"post":{"operationId":"get_status_page","summary":"Get one Datadog status page by id: name, domain, URL, visibility type, subscription setting and current component status","description":"Get one Datadog status page by id: name, domain, URL, visibility type, subscription setting and current component statuses. Use for \"Show the Datadog status page with id 1111\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_id":{"description":"Status page id (UUID) from list_status_pages.","maxLength":60,"title":"Page Id","type":"string"}},"required":["page_id"],"title":"get_status_pageArguments","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_components":{"post":{"operationId":"list_components","summary":"List the components and component groups of one status page with status, position and timestamps. Use for \"What componen","description":"List the components and component groups of one status page with status, position and timestamps. Use for \"What components does Datadog status page 1111 show and what is their status\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_id":{"description":"Status page id (UUID) from list_status_pages.","maxLength":60,"title":"Page Id","type":"string"}},"required":["page_id"],"title":"list_componentsArguments","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_degradations":{"post":{"operationId":"list_degradations","summary":"List degradations (incidents shown on status pages) across the organization, newest first by default. Filter by page, st","description":"List degradations (incidents shown on status pages) across the organization, newest first by default. Filter by page, status or source id. Use for \"Which degradations are currently investigating on our Datadog status pages\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only degradations of this status page id.","title":"Page Id"},"status":{"anyOf":[{"enum":["investigating","identified","monitoring","resolved"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this status: investigating, identified, monitoring or resolved.","title":"Status"},"source_id":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only degradations linked to this source id, for example a Datadog incident id.","title":"Source Id"},"sort":{"anyOf":[{"enum":["created_at","-created_at","modified_at","-modified_at"],"type":"string"},{"type":"null"}],"default":"-created_at","description":"Order: created_at, -created_at, modified_at or -modified_at.","title":"Sort"},"page_limit":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many items to return (default 50).","title":"Page Limit"},"page_offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Offset to start from, for paging (default 0).","title":"Page Offset"}},"title":"list_degradationsArguments","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_degradation":{"post":{"operationId":"get_degradation","summary":"Get one degradation of a status page with its status, description, affected components and the full list of updates. Use","description":"Get one degradation of a status page with its status, description, affected components and the full list of updates. Use for \"Show the details and updates of degradation d1 on Datadog status page 1111\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_id":{"description":"Status page id (UUID) from list_status_pages.","maxLength":60,"title":"Page Id","type":"string"},"degradation_id":{"description":"Degradation id (UUID) from list_degradations.","maxLength":60,"title":"Degradation Id","type":"string"}},"required":["page_id","degradation_id"],"title":"get_degradationArguments","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_maintenances":{"post":{"operationId":"list_maintenances","summary":"List scheduled, in-progress and completed maintenances across the organization with start date, status, descriptions and","description":"List scheduled, in-progress and completed maintenances across the organization with start date, status, descriptions and affected components. Use for \"What maintenance windows are scheduled on our Datadog status pages\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_id":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only maintenances of this status page id.","title":"Page Id"},"status":{"anyOf":[{"enum":["scheduled","in_progress","completed"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this status: scheduled, in_progress or completed.","title":"Status"},"sort":{"anyOf":[{"enum":["created_at","-created_at","start_date","-start_date"],"type":"string"},{"type":"null"}],"default":"-created_at","description":"Order: created_at, -created_at, start_date or -start_date.","title":"Sort"},"page_limit":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":50,"description":"How many items to return (default 50).","title":"Page Limit"},"page_offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Offset to start from, for paging (default 0).","title":"Page Offset"}},"title":"list_maintenancesArguments","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_degradation_templates":{"post":{"operationId":"list_degradation_templates","summary":"List the saved degradation templates of a status page: template name, default title, affected components and update mess","description":"List the saved degradation templates of a status page: template name, default title, affected components and update messages. Use for \"Which degradation templates exist for Datadog status page 1111\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_id":{"description":"Status page id (UUID) from list_status_pages.","maxLength":60,"title":"Page Id","type":"string"}},"required":["page_id"],"title":"list_degradation_templatesArguments","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_maintenance_templates":{"post":{"operationId":"list_maintenance_templates","summary":"List the saved maintenance templates of a status page: template name, default title, descriptions per phase and componen","description":"List the saved maintenance templates of a status page: template name, default title, descriptions per phase and component ids. Use for \"Which maintenance templates exist for Datadog status page 1111\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page_id":{"description":"Status page id (UUID) from list_status_pages.","maxLength":60,"title":"Page Id","type":"string"}},"required":["page_id"],"title":"list_maintenance_templatesArguments","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}}}}