Datadog · OpenAPI Overlay 1.0.0

API Evangelist Events surface overlay (Datadog)

2 actions 2 updates update extends openapi/datadog-events-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Datadog's API. It is a proposal applied on top of the contract, not a document Datadog publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-mcp-toolsx-arazzo-workflowx-agent-skillx-agent-guidance

Targets 2

$.info

$.paths['/api/v2/events'].post

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist Events surface overlay (Datadog)
  version: 1.0.0
extends: openapi/datadog-events-api-openapi.yml
x-generated: '2026-09-23'
x-method: generated
x-source: openapi/datadog-events-api-openapi.yml
x-rationale: >-
  Wire the Events v2 surface (CreateEvent + SearchEvents + ListEvents) to its
  MCP tool and skill. Does not mutate the underlying spec.
actions:
  - target: $.info
    description: Attach MCP + workflow pointers to info.
    update:
      x-mcp-tools:
        - {tool: search_datadog_events, toolset: core, binding: rest, backs: [SearchEvents, ListEvents]}
      x-arazzo-workflow: ../arazzo/datadog-post-and-search-events-workflow.yml
      x-agent-skill: skills/datadog-post-and-search-events.md
  - target: "$.paths['/api/v2/events'].post"
    description: CreateEvent is a write path; note the audit trail integration.
    update:
      x-agent-guidance: >-
        CreateEvent posts to /api/v2/events. Include `title`, `text`, tags, and
        `alert_type`. All calls are audited; see security/datadog-security.yml.