# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Datadog Account API
  version: 1.0.0
extends: openapi/datadog-account-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: 35
- target: $.paths['/api/v2/integration/gcp/accounts'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a GCP STS service account
      effect: write
      questions:
      - How do I connect a GCP service account to Datadog using STS?
      - Can Datadog monitor Google Cloud without me sharing a key file?
      instructions:
      - text: 'Register this GCP STS-enabled service account with Datadog: {data}.'
        slots:
          data: requestBody.data
      - text: Add a new GCP STS service account entry.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integration/gcp/accounts/{account_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a GCP STS service account
      effect: destructive
      questions:
      - Can I disconnect a GCP STS service account from Datadog?
      - What happens to monitoring when I delete a GCP STS account entry?
      instructions:
      - text: Delete GCP STS account {account_id}.
        slots:
          account_id: path.account_id
      - text: Disconnect the Google Cloud service account {account_id} from Datadog.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integration/gcp/accounts/{account_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a GCP STS service account
      effect: write
      questions:
      - Can I change settings on a GCP service account already connected via STS?
      - Is it possible to edit the metadata of an existing GCP STS integration?
      instructions:
      - text: Update GCP STS account {account_id} with {data}.
        slots:
          account_id: path.account_id
          data: requestBody.data
      - text: Edit the settings of Google Cloud service account {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integration/gcp/sts_delegate'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the GCP STS delegate account
      effect: read
      questions:
      - Which Datadog service account do I grant access to in GCP?
      - Where do I find the STS delegate principal for the Google Cloud integration?
      instructions:
      - text: Show our Datadog-GCP STS delegate account.
      - text: Get the delegate service account Datadog uses for GCP STS.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/cloudflare/accounts'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect a Cloudflare account
      effect: write
      questions:
      - How do I add my Cloudflare account to Datadog?
      - Can Datadog pull metrics from Cloudflare?
      instructions:
      - text: Add a Cloudflare account to Datadog with {data}.
        slots:
          data: requestBody.data
      - text: Connect a new Cloudflare account integration.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/cloudflare/accounts/{account_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Cloudflare account integration
      effect: read
      questions:
      - What are the settings of a connected Cloudflare account?
      - Can I check one Cloudflare integration account by its ID?
      instructions:
      - text: Show Cloudflare account {account_id}.
        slots:
          account_id: path.account_id
      - text: Get the Cloudflare integration details for {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/cloudflare/accounts/{account_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a Cloudflare account integration
      effect: destructive
      questions:
      - Can I disconnect a Cloudflare account from Datadog?
      - Will removing the Cloudflare account stop its metrics collection?
      instructions:
      - text: Delete Cloudflare account {account_id}.
        slots:
          account_id: path.account_id
      - text: Disconnect Cloudflare integration {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/cloudflare/accounts/{account_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Cloudflare account integration
      effect: write
      questions:
      - Can I rotate the API key on a connected Cloudflare account?
      - Is it possible to edit an existing Cloudflare integration?
      instructions:
      - text: Update Cloudflare account {account_id} with {data}.
        slots:
          account_id: path.account_id
          data: requestBody.data
      - text: Change the settings of Cloudflare integration {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/confluent-cloud/accounts'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect a Confluent Cloud account
      effect: write
      questions:
      - How do I monitor Confluent Cloud Kafka in Datadog?
      - Can I add a Confluent account with its API key and secret?
      instructions:
      - text: Add a Confluent Cloud account with {data}.
        slots:
          data: requestBody.data
      - text: Connect a new Confluent Cloud account integration.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/confluent-cloud/accounts/{account_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Confluent Cloud account
      effect: read
      questions:
      - What's configured on a connected Confluent Cloud account?
      - Can I look up one Confluent integration account by ID?
      instructions:
      - text: Show Confluent account {account_id}.
        slots:
          account_id: path.account_id
      - text: Get the Confluent Cloud integration details for {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/confluent-cloud/accounts/{account_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a Confluent Cloud account
      effect: destructive
      questions:
      - Can I disconnect a Confluent Cloud account from Datadog?
      - Does deleting a Confluent account also remove its resources?
      instructions:
      - text: Delete Confluent account {account_id}.
        slots:
          account_id: path.account_id
      - text: Disconnect Confluent Cloud integration {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/confluent-cloud/accounts/{account_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Confluent Cloud account
      effect: write
      questions:
      - Can I update the credentials on a Confluent Cloud account?
      - Is it possible to change tags on a connected Confluent account?
      instructions:
      - text: Update Confluent account {account_id} with {data}.
        slots:
          account_id: path.account_id
          data: requestBody.data
      - text: Edit the Confluent Cloud integration {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/confluent-cloud/accounts/{account_id}/resources'].get
  update:
    x-apievangelist-phrasing:
      intent: List resources in a Confluent account
      effect: read
      questions:
      - Which Kafka clusters and connectors are tracked for a Confluent account?
      - Can I see all Confluent resources under one account?
      instructions:
      - text: List the resources in Confluent account {account_id}.
        slots:
          account_id: path.account_id
      - text: Show every Confluent Cloud resource tracked under {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/confluent-cloud/accounts/{account_id}/resources'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a resource to a Confluent account
      effect: write
      questions:
      - How do I add a Kafka cluster to a Confluent integration?
      - Can I register a new Confluent resource under an existing account?
      instructions:
      - text: Add resource {data} to Confluent account {account_id}.
        slots:
          account_id: path.account_id
          data: requestBody.data
      - text: Register a new Confluent resource under account {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/confluent-cloud/accounts/{account_id}/resources/{resource_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Confluent account resource
      effect: read
      questions:
      - What are the details of one resource in a Confluent account?
      - Can I check a single Confluent resource by its ID?
      instructions:
      - text: Show resource {resource_id} in Confluent account {account_id}.
        slots:
          account_id: path.account_id
          resource_id: path.resource_id
      - text: Get Confluent resource {resource_id} from account {account_id}.
        slots:
          account_id: path.account_id
          resource_id: path.resource_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/confluent-cloud/accounts/{account_id}/resources/{resource_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a resource from a Confluent account
      effect: destructive
      questions:
      - Can I stop tracking one Confluent resource without removing the account?
      - How do I remove a Kafka cluster from a Confluent integration?
      instructions:
      - text: Delete resource {resource_id} from Confluent account {account_id}.
        slots:
          account_id: path.account_id
          resource_id: path.resource_id
      - text: Remove Confluent resource {resource_id} under account {account_id}.
        slots:
          account_id: path.account_id
          resource_id: path.resource_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/confluent-cloud/accounts/{account_id}/resources/{resource_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Confluent account resource
      effect: write
      questions:
      - Can I change the tags on a single Confluent resource?
      - Is it possible to edit a resource already added to a Confluent account?
      instructions:
      - text: Update resource {resource_id} in Confluent account {account_id} with {data}.
        slots:
          account_id: path.account_id
          resource_id: path.resource_id
          data: requestBody.data
      - text: Edit Confluent resource {resource_id} under account {account_id}.
        slots:
          account_id: path.account_id
          resource_id: path.resource_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/fastly/accounts'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect a Fastly account
      effect: write
      questions:
      - Can Datadog collect metrics from my Fastly CDN?
      - What do I need to add a Fastly account integration?
      instructions:
      - text: Add a Fastly account with {data}.
        slots:
          data: requestBody.data
      - text: Connect a new Fastly account to Datadog.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/fastly/accounts/{account_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Fastly account integration
      effect: read
      questions:
      - What's configured on a connected Fastly account?
      - Can I look up a Fastly integration account by its ID?
      instructions:
      - text: Show Fastly account {account_id}.
        slots:
          account_id: path.account_id
      - text: Get the Fastly integration details for {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/fastly/accounts/{account_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a Fastly account integration
      effect: destructive
      questions:
      - Can I disconnect a Fastly account from Datadog?
      - Will deleting the Fastly account stop CDN metrics?
      instructions:
      - text: Delete Fastly account {account_id}.
        slots:
          account_id: path.account_id
      - text: Disconnect Fastly integration {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/fastly/accounts/{account_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Fastly account integration
      effect: write
      questions:
      - Can I change the API key on a connected Fastly account?
      - Is editing an existing Fastly integration possible?
      instructions:
      - text: Update Fastly account {account_id} with {data}.
        slots:
          account_id: path.account_id
          data: requestBody.data
      - text: Change the settings of Fastly integration {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/okta/accounts'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect an Okta account
      effect: write
      questions:
      - Can Datadog ingest logs from my Okta tenant?
      - What's needed to add an Okta account integration?
      instructions:
      - text: Add an Okta account with {data}.
        slots:
          data: requestBody.data
      - text: Connect a new Okta account to Datadog.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/okta/accounts/{account_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Okta account integration
      effect: read
      questions:
      - What's configured on a connected Okta account?
      - Can I look up an Okta integration account by ID?
      instructions:
      - text: Show Okta account {account_id}.
        slots:
          account_id: path.account_id
      - text: Get the Okta integration details for {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/okta/accounts/{account_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an Okta account integration
      effect: destructive
      questions:
      - Can I disconnect an Okta account from Datadog?
      - What stops when I delete the Okta account integration?
      instructions:
      - text: Delete Okta account {account_id}.
        slots:
          account_id: path.account_id
      - text: Disconnect Okta integration {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/integrations/okta/accounts/{account_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Okta account integration
      effect: write
      questions:
      - Can I change the credentials on a connected Okta account?
      - Is it possible to edit an existing Okta integration's settings?
      instructions:
      - text: Update Okta account {account_id} with {data}.
        slots:
          account_id: path.account_id
          data: requestBody.data
      - text: Change the settings of Okta integration {account_id}.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/service_accounts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a service account
      effect: write
      questions:
      - How do I create a non-human service account in Datadog?
      - Can I give a service account roles when creating it?
      instructions:
      - text: Create a service account with {data}.
        slots:
          data: requestBody.data
      - text: Create a new service account for our automation.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/service_accounts/{service_account_id}/application_keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List a service account's application keys
      effect: read
      questions:
      - Which application keys belong to a given service account?
      - Can I filter a service account's keys by creation date?
      instructions:
      - text: List application keys for service account {service_account_id}.
        slots:
          service_account_id: path.service_account_id
      - text: Find keys on service account {service_account_id} matching {filter}.
        slots:
          service_account_id: path.service_account_id
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/service_accounts/{service_account_id}/application_keys'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an application key for a service account
      effect: write
      questions:
      - How do I generate an application key for a service account?
      - Can a service account have its own app key separate from a user?
      instructions:
      - text: Create an application key for service account {service_account_id}.
        slots:
          service_account_id: path.service_account_id
      - text: Generate application key {data} on service account {service_account_id}.
        slots:
          service_account_id: path.service_account_id
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/service_accounts/{service_account_id}/application_keys/{app_key_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a service account's application key
      effect: read
      questions:
      - What are the details of one application key on a service account?
      - Can I check the scopes of a specific service account key?
      instructions:
      - text: Show application key {app_key_id} of service account {service_account_id}.
        slots:
          service_account_id: path.service_account_id
          app_key_id: path.app_key_id
      - text: Get key {app_key_id} owned by service account {service_account_id}.
        slots:
          service_account_id: path.service_account_id
          app_key_id: path.app_key_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/service_accounts/{service_account_id}/application_keys/{app_key_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a service account's application key
      effect: destructive
      questions:
      - Can I revoke an application key owned by a service account?
      - What breaks if I delete a service account's app key?
      instructions:
      - text: Delete application key {app_key_id} from service account {service_account_id}.
        slots:
          service_account_id: path.service_account_id
          app_key_id: path.app_key_id
      - text: Revoke service account {service_account_id}'s key {app_key_id}.
        slots:
          service_account_id: path.service_account_id
          app_key_id: path.app_key_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/service_accounts/{service_account_id}/application_keys/{app_key_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a service account's application key
      effect: write
      questions:
      - Can I rename an application key that a service account owns?
      - Is it possible to change scopes on a service account's key?
      instructions:
      - text: Rename key {app_key_id} on service account {service_account_id} via {data}.
        slots:
          service_account_id: path.service_account_id
          app_key_id: path.app_key_id
          data: requestBody.data
      - text: Edit application key {app_key_id} of service account {service_account_id}.
        slots:
          service_account_id: path.service_account_id
          app_key_id: path.app_key_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/usage/cost_by_org'].get
  update:
    x-apievangelist-phrasing:
      intent: Get monthly cost by org (deprecated)
      effect: read
      questions:
      - What did each child org cost us per month on the old cost-by-org endpoint?
      - Is the cost_by_org endpoint deprecated in favor of historical cost?
      instructions:
      - text: Get cost by org from {start_month} using the deprecated endpoint.
        slots:
          start_month: query.start_month
      - text: Show multi-org cost from {start_month} to {end_month} via cost_by_org.
        slots:
          start_month: query.start_month
          end_month: query.end_month
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/usage/estimated_cost'].get
  update:
    x-apievangelist-phrasing:
      intent: Get estimated cost for this or last month
      effect: read
      questions:
      - How much is Datadog estimated to cost us so far this month?
      - Can I see estimated cost broken down by sub-org with daily granularity?
      instructions:
      - text: Show estimated cost from {start_date} to {end_date}.
        slots:
          start_date: query.start_date
          end_date: query.end_date
      - text: Get estimated cost by {view} starting {start_month}.
        slots:
          view: query.view
          start_month: query.start_month
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/usage/historical_cost'].get
  update:
    x-apievangelist-phrasing:
      intent: Get historical monthly cost
      effect: read
      questions:
      - What did Datadog cost us in previous months?
      - When does a month's final cost become available?
      instructions:
      - text: Show historical cost from {start_month} to {end_month}.
        slots:
          start_month: query.start_month
          end_month: query.end_month
      - text: Get historical cost by {view} since {start_month}.
        slots:
          view: query.view
          start_month: query.start_month
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v2/usage/projected_cost'].get
  update:
    x-apievangelist-phrasing:
      intent: Get projected cost for this month
      effect: read
      questions:
      - What is our Datadog bill projected to be at month end?
      - Can I see this month's projected cost per sub-organization?
      instructions:
      - text: Show the projected cost for the current month.
      - text: Get projected cost broken down by {view}.
        slots:
          view: query.view
      method: generated
      generated: '2026-10-01'