# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Datadog Patch API
  version: 1.0.0
extends: openapi/datadog-patch-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: 3
- target: $.paths['/api/v2/scim/Users/{user_uuid}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a SCIM user
      effect: write
      questions:
      - How do I deactivate or rename a user through SCIM?
      - Can I apply SCIM patch operations to a single user?
      instructions:
      - text: Apply SCIM patch {Operations} to user {user_uuid}.
        slots:
          Operations: requestBody.Operations
          user_uuid: path.user_uuid
      - text: Partially update SCIM user {user_uuid} with {Operations}.
        slots:
          user_uuid: path.user_uuid
          Operations: requestBody.Operations
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/security/signals/notification_rules/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a security signal notification rule
      effect: write
      questions:
      - How do I change only the recipients of a security signal notification rule?
      - Can I disable a signal-based notification rule without resending every field?
      instructions:
      - text: Patch signal notification rule {id} with {changes}.
        slots:
          id: path.id
          changes: requestBody.data
      - text: Update just {changes} on security signal notification rule {id}.
        slots:
          changes: requestBody.data
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/security/vulnerabilities/notification_rules/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a vulnerability notification rule
      effect: write
      questions:
      - How do I change the targets of a vulnerability notification rule?
      - Can I partially update a vulnerability-based notification rule?
      instructions:
      - text: Patch vulnerability notification rule {id} with {changes}.
        slots:
          id: path.id
          changes: requestBody.data
      - text: Update just {changes} on vulnerability notification rule {id}.
        slots:
          changes: requestBody.data
          id: path.id
      method: generated
      generated: '2026-10-01'