# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Datadog Update API
  version: 1.0.0
extends: openapi/datadog-update-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: 6
- target: $.paths['/api/v2/apicatalog/api/{id}/openapi'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an API's OpenAPI definition in the catalog
      effect: write
      questions:
      - How do I upload a new OpenAPI file for an API already in the catalog?
      - Does updating a cataloged API replace all of its existing content?
      instructions:
      - text: Replace the OpenAPI definition of catalog API {id} with {openapi_spec_file}.
        slots:
          id: path.id
          openapi_spec_file: requestBody.openapi_spec_file
      - text: Upload a fresh OpenAPI spec for API {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/downtime/{downtime_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a downtime
      effect: write
      questions:
      - Can I extend or reschedule a downtime that's already set?
      - What's the way to change the scope of an existing downtime?
      instructions:
      - text: Update downtime {downtime_id} with {data}.
        slots:
          downtime_id: path.downtime_id
          data: requestBody.data
      - text: Reschedule downtime {downtime_id} using {data}.
        slots:
          downtime_id: path.downtime_id
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/fastly/accounts/{account_id}/services/{service_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Fastly service
      effect: write
      questions:
      - How do I change tags on a Fastly service I'm monitoring?
      - Can I edit one Fastly service under an account?
      instructions:
      - text: Update Fastly service {service_id} in account {account_id} with {data}.
        slots:
          service_id: path.service_id
          account_id: path.account_id
          data: requestBody.data
      - text: Edit the tags of Fastly service {service_id} on account {account_id}.
        slots:
          service_id: path.service_id
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/powerpacks/{powerpack_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a powerpack
      effect: write
      questions:
      - Can I change the widgets in an existing powerpack?
      - How do I rename a powerpack?
      instructions:
      - text: Update powerpack {powerpack_id} with {data}.
        slots:
          powerpack_id: path.powerpack_id
          data: requestBody.data
      - text: Edit the widgets of powerpack {powerpack_id}.
        slots:
          powerpack_id: path.powerpack_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/scim/Users/{user_uuid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a SCIM user's attributes
      effect: write
      questions:
      - How does my identity provider deactivate a user over SCIM?
      - Can I change a SCIM user's email or title?
      instructions:
      - text: Update SCIM user {user_uuid} with title {title}.
        slots:
          user_uuid: path.user_uuid
          title: requestBody.title
      - text: Set SCIM user {user_uuid} active status to {active}.
        slots:
          user_uuid: path.user_uuid
          active: requestBody.active
      - text: Change the emails of SCIM user {user_uuid} to {emails}.
        slots:
          user_uuid: path.user_uuid
          emails: requestBody.emails
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/users/{user_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a user
      effect: write
      questions:
      - How do I change a user's name or disable them as an admin?
      - Does editing a user require an admin application key?
      instructions:
      - text: Update user {user_id} with {data}.
        slots:
          user_id: path.user_id
          data: requestBody.data
      - text: Disable user {user_id} in my organization.
        slots:
          user_id: path.user_id
      method: generated
      generated: '2026-10-01'