{"openapi":"3.1.0","info":{"title":"Datadog Case Management (BYOK) API","version":"0.1.0","description":"Datadog Case Management (BYOK) lets an AI assistant read your own Datadog Case Management data through the Datadog Case Management API with a key you supply (Datadog API key (US1 site, datadoghq.com)). Read-only: 11 tools (search_cases, get_case, count_cases, list_projects, get_project, list_case_types, list_custom_attributes, list_case_views, list_automation_rules, list_notification_rules,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-datadog-case-management.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-datadog-case-management/docs"},"termsOfService":"https://connectorbay.com/byok-datadog-case-management/terms"},"servers":[{"url":"https://byok-datadog-case-management.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-datadog-case-management/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/search_cases":{"post":{"operationId":"search_cases","summary":"Search Datadog cases with a query string. Returns key, title, status, priority, type, dates and the project and assignee","description":"Search Datadog cases with a query string. Returns key, title, status, priority, type, dates and the project and assignee ids. Pages of up to 100. Use for \"Which P1 cases are open in Datadog Case Management\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Search query, for example 'status:OPEN priority:P1' (Datadog case search syntax).","title":"Query"},"sort_field":{"anyOf":[{"enum":["created_at","priority","status"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort by created_at, priority or status.","title":"Sort Field"},"sort_ascending":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True for ascending order (default descending).","title":"Sort Ascending"},"page_size":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Cases per page (1 to 100).","title":"Page Size"},"page_number":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Page number, starting at 0.","title":"Page Number"}},"title":"search_casesArguments","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_case":{"post":{"operationId":"get_case","summary":"Get one case by id or key: title, description, status, priority, type, dates and the project and assignee ids. Use for \"","description":"Get one case by id or key: title, description, status, priority, type, dates and the project and assignee ids. Use for \"Show the details of Datadog case SEC-12\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"case_id":{"description":"Case id (UUID) or key such as SEC-12 from search_cases.","maxLength":80,"title":"Case Id","type":"string"}},"required":["case_id"],"title":"get_caseArguments","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/count_cases":{"post":{"operationId":"count_cases","summary":"Count cases, optionally narrowed by a query and grouped by fields such as status or priority. Use for \"How many Datadog ","description":"Count cases, optionally narrowed by a query and grouped by fields such as status or priority. Use for \"How many Datadog cases are there per status\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Case search query to narrow the count.","title":"Query"},"group_by":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated fields to group by, for example status,priority.","title":"Group By"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of values per group (1 to 100).","title":"Limit"}},"title":"count_casesArguments","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_projects":{"post":{"operationId":"list_projects","summary":"List Case Management projects with key, name, restricted flag and enabled case types. Use for \"Which Datadog Case Manage","description":"List Case Management projects with key, name, restricted flag and enabled case types. Use for \"Which Datadog Case Management projects exist\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_projectsArguments","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_project":{"post":{"operationId":"get_project","summary":"Get one Case Management project: key, name, restricted flag, settings (integrations, auto-close, notifications) and colu","description":"Get one Case Management project: key, name, restricted flag, settings (integrations, auto-close, notifications) and column configuration. Use for \"What are the settings of Datadog Case Management project SEC\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Case Management project id (UUID) from list_projects.","maxLength":60,"title":"Project Id","type":"string"}},"required":["project_id"],"title":"get_projectArguments","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_case_types":{"post":{"operationId":"list_case_types","summary":"List case types with name, description and emoji. Use for \"What case types are defined in Datadog\".","description":"List case types with name, description and emoji. Use for \"What case types are defined in Datadog\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_case_typesArguments","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_custom_attributes":{"post":{"operationId":"list_custom_attributes","summary":"List the custom attributes defined for cases: key, display name, description, case type and whether several values are a","description":"List the custom attributes defined for cases: key, display name, description, case type and whether several values are allowed. Use for \"Which custom attributes can Datadog cases have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_custom_attributesArguments","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_case_views":{"post":{"operationId":"list_case_views","summary":"List the saved case views (saved search queries) of a project with name, query and dates. Use for \"Which saved case view","description":"List the saved case views (saved search queries) of a project with name, query and dates. Use for \"Which saved case views does Datadog project SEC have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Project id (UUID) from list_projects.","maxLength":60,"title":"Project Id","type":"string"}},"required":["project_id"],"title":"list_case_viewsArguments","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_automation_rules":{"post":{"operationId":"list_automation_rules","summary":"List a project's case automation rules: name, enabled state, trigger and action definitions and dates. Use for \"What aut","description":"List a project's case automation rules: name, enabled state, trigger and action definitions and dates. Use for \"What automation rules does Datadog project SEC have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Case Management project id (UUID) from list_projects.","maxLength":60,"title":"Project Id","type":"string"}},"required":["project_id"],"title":"list_automation_rulesArguments","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_notification_rules":{"post":{"operationId":"list_notification_rules","summary":"List a project's case notification rules: query, enabled flag, triggers and recipient definitions. Use for \"Who gets not","description":"List a project's case notification rules: query, enabled flag, triggers and recipient definitions. Use for \"Who gets notified about cases in Datadog project SEC\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"project_id":{"description":"Case Management project id (UUID) from list_projects.","maxLength":60,"title":"Project Id","type":"string"}},"required":["project_id"],"title":"list_notification_rulesArguments","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_windows":{"post":{"operationId":"list_maintenance_windows","summary":"List event-management maintenance windows (periods when notifications and automation are suppressed for matching work it","description":"List event-management maintenance windows (periods when notifications and automation are suppressed for matching work items): name, query, start and end. Use for \"Are there any Datadog case maintenance windows scheduled\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_maintenance_windowsArguments","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}}}}