overlay: 1.0.0
info:
  title: API Evangelist Incidents surface overlay (Datadog)
  version: 1.0.0
extends: ../openapi/_original/datadog-incidents-openapi.yml
x-generated: '2026-09-23'
x-method: generated
x-source: openapi/_original/datadog-incidents-openapi.yml
x-rationale: >-
  The incidents surface is scattered across create/get/existing/search
  split-per-tag files; this overlay attaches the arazzo workflow + skill
  pointers at the original-spec level so agent processors can pick them up
  once, not per tag file.
actions:
  - target: $.info
    description: Attach MCP + workflow pointers to info.
    update:
      x-mcp-tools:
        - {tool: get_datadog_incident,    toolset: core, binding: rest, backs: [GetIncident]}
        - {tool: search_datadog_incidents, toolset: core, binding: rest, backs: [SearchIncidents, ListIncidents]}
      x-arazzo-workflows:
        - ../arazzo/datadog-create-incident-workflow.yml
        - ../arazzo/datadog-declare-incident-workflow.yml
        - ../arazzo/datadog-resolve-incident-workflow.yml
        - ../arazzo/datadog-search-incidents-workflow.yml
        - ../arazzo/datadog-manage-incident-attachments-workflow.yml
      x-agent-skill: skills/datadog-create-incident.md
  - target: "$.paths['/api/v2/incidents'].post"
    description: Note that CreateIncident requires `incident_write` permission.
    update:
      x-agent-guidance: >-
        CreateIncident on /api/v2/incidents accepts a JSON:API document with
        type=incidents; declare severity, customer_impact_scope, and
        notification handles up-front. See skills/datadog-create-incident.md.