# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Datadog Action API
  version: 1.0.0
extends: openapi/datadog-action-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/api/v2/actions/connections'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an Action Connection
      effect: write
      questions:
      - Can I create a connection that workflows and apps use to call external services?
      - What credentials does a new Action Connection need?
      instructions:
      - text: Create an Action Connection {connection}.
        slots:
          connection: requestBody.data
      - text: Add a new action connection with {connection}.
        slots:
          connection: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/actions/connections/{connection_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Action Connection
      effect: read
      questions:
      - Can I look up how an existing Action Connection is configured?
      - What does an action connection record contain?
      instructions:
      - text: Get Action Connection {connection_id}.
        slots:
          connection_id: path.connection_id
      - text: Show me the details of action connection {connection_id}.
        slots:
          connection_id: path.connection_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/actions/connections/{connection_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Action Connection
      effect: destructive
      questions:
      - Can I remove an Action Connection that's no longer used?
      - Will deleting an action connection break workflows that rely on it?
      instructions:
      - text: Delete Action Connection {connection_id}.
        slots:
          connection_id: path.connection_id
      - text: Remove action connection {connection_id}.
        slots:
          connection_id: path.connection_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/actions/connections/{connection_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Action Connection
      effect: write
      questions:
      - Can I rotate the credentials on an existing Action Connection?
      - Which fields of an action connection can be changed?
      instructions:
      - text: Update Action Connection {connection_id} with {changes}.
        slots:
          connection_id: path.connection_id
          changes: requestBody.data
      - text: Rotate the credentials on action connection {connection_id}.
        slots:
          connection_id: path.connection_id
      method: generated
      generated: '2026-10-01'