API Evangelist conversational phrasing for Flagsmith Integrations API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Flagsmith Integrations API
  version: 1.0.0
extends: openapi/flagsmith-integrations-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 107
- target: $.paths['/api/v1/admin/dashboard/integrations/'].get
  update:
    x-apievangelist-phrasing:
      intent: See integration usage on the admin dashboard
      effect: read
      questions:
      - Which third-party integrations are switched on across my whole Flagsmith instance?
      - Can the admin dashboard tell me how widely each integration type is used?
      instructions:
      - text: Pull the admin dashboard breakdown of integrations in use.
      - text: Give me an instance-wide overview of configured integrations for the admin view.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/amplitude/'].get
  update:
    x-apievangelist-phrasing:
      intent: List Amplitude integrations for an environment
      effect: read
      questions:
      - Is Amplitude already connected to this environment?
      - What Amplitude setups exist for my staging environment?
      instructions:
      - text: List the Amplitude integrations on environment {environment}.
        slots:
          environment: path.environment_api_key
      - text: Show me every Amplitude connection configured for {environment}.
        slots:
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/amplitude/'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect Amplitude to an environment
      effect: write
      questions:
      - How do I send flag data from an environment into Amplitude?
      - Can I point the Amplitude integration at a custom base URL such as the EU endpoint?
      instructions:
      - text: Connect Amplitude to environment {environment} using API key {api_key}.
        slots:
          environment: path.environment_api_key
          api_key: requestBody.api_key
      - text: Add an Amplitude integration to {environment} with key {api_key} and base URL {base_url}.
        slots:
          environment: path.environment_api_key
          api_key: requestBody.api_key
          base_url: requestBody.base_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/amplitude/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Amplitude integration's settings
      effect: read
      questions:
      - What base URL is my Amplitude integration currently sending to?
      - Where can I look up the details of a single Amplitude connection?
      instructions:
      - text: Fetch Amplitude integration {integration_id} in environment {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      - text: Show the configuration of Amplitude connection {integration_id} on {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/amplitude/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an Amplitude integration's settings
      effect: write
      questions:
      - Can I overwrite the full Amplitude config, key and URL together, in one call?
      - What happens to the base URL if I replace my Amplitude settings without it?
      instructions:
      - text: Replace Amplitude integration {integration_id} on {environment} with API key {api_key}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          api_key: requestBody.api_key
      - text: 'Overwrite the whole Amplitude setup {integration_id} in {environment}: key {api_key}, base URL {base_url}.'
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          api_key: requestBody.api_key
          base_url: requestBody.base_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/amplitude/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disconnect Amplitude from an environment
      effect: destructive
      questions:
      - How can I stop an environment from sending data to Amplitude?
      - Is removing an Amplitude integration permanent?
      instructions:
      - text: Delete Amplitude integration {integration_id} from environment {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      - text: Disconnect Amplitude connection {integration_id} on {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/amplitude/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change one Amplitude integration setting
      effect: write
      questions:
      - Can I rotate just the Amplitude API key without touching anything else?
      - Is it possible to patch only the Amplitude base URL?
      instructions:
      - text: Rotate the Amplitude key on integration {integration_id} in {environment} to {api_key}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          api_key: requestBody.api_key
      - text: Patch only the base URL of Amplitude integration {integration_id} on {environment} to {base_url}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          base_url: requestBody.base_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/dynatrace/'].get
  update:
    x-apievangelist-phrasing:
      intent: List Dynatrace integrations for an environment
      effect: read
      questions:
      - Does this environment already push flag changes to Dynatrace?
      - Which Dynatrace connections are set up on my production environment?
      instructions:
      - text: List the Dynatrace integrations on environment {environment}.
        slots:
          environment: path.environment_api_key
      - text: Show every Dynatrace hookup configured for {environment}.
        slots:
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/dynatrace/'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect Dynatrace to an environment
      effect: write
      questions:
      - How do I get flag change events into Dynatrace for one environment?
      - What entity selector does the Dynatrace integration need?
      instructions:
      - text: Connect Dynatrace to {environment} with API key {api_key} and entity selector {entity_selector}.
        slots:
          environment: path.environment_api_key
          api_key: requestBody.api_key
          entity_selector: requestBody.entity_selector
      - text: Add a Dynatrace integration on {environment} at tenant URL {base_url}, key {api_key}, selector {entity_selector}.
        slots:
          environment: path.environment_api_key
          base_url: requestBody.base_url
          api_key: requestBody.api_key
          entity_selector: requestBody.entity_selector
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/dynatrace/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Dynatrace integration's settings
      effect: read
      questions:
      - Which entity selector is my Dynatrace integration using right now?
      - Can I inspect a single Dynatrace connection's tenant URL?
      instructions:
      - text: Fetch Dynatrace integration {integration_id} in environment {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      - text: Show the settings of Dynatrace hookup {integration_id} on {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/dynatrace/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a Dynatrace integration's settings
      effect: write
      questions:
      - Can I resubmit the entire Dynatrace configuration at once?
      - Does a full Dynatrace update require both the key and the entity selector again?
      instructions:
      - text: Replace Dynatrace integration {integration_id} on {environment} with key {api_key} and selector {entity_selector}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          api_key: requestBody.api_key
          entity_selector: requestBody.entity_selector
      - text: Overwrite the full Dynatrace config {integration_id} in {environment}, tenant URL {base_url}, key {api_key}, selector {entity_selector}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          base_url: requestBody.base_url
          api_key: requestBody.api_key
          entity_selector: requestBody.entity_selector
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/dynatrace/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disconnect Dynatrace from an environment
      effect: destructive
      questions:
      - How do I stop sending flag events to Dynatrace from an environment?
      - What does removing a Dynatrace integration affect?
      instructions:
      - text: Delete Dynatrace integration {integration_id} from environment {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      - text: Remove the Dynatrace hookup {integration_id} on {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/dynatrace/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change one Dynatrace integration setting
      effect: write
      questions:
      - Can I change only the Dynatrace entity selector?
      - Is there a way to swap the Dynatrace token and leave the rest alone?
      instructions:
      - text: Set the entity selector on Dynatrace integration {integration_id} in {environment} to {entity_selector}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          entity_selector: requestBody.entity_selector
      - text: Patch just the Dynatrace token of {integration_id} on {environment} to {api_key}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          api_key: requestBody.api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/grafana/'].get
  update:
    x-apievangelist-phrasing:
      intent: List environment-level Grafana integrations
      effect: read
      questions:
      - Is Grafana annotation set up for this particular environment?
      - Which Grafana integrations are scoped to one environment rather than the project?
      instructions:
      - text: List the environment-level Grafana integrations on {environment}.
        slots:
          environment: path.environment_api_key
      - text: Show Grafana connections configured directly on environment {environment}.
        slots:
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/grafana/'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect Grafana to a single environment
      effect: write
      questions:
      - Can I annotate Grafana dashboards with flag changes from just one environment?
      - What do I need to hook Grafana up at the environment level?
      instructions:
      - text: Connect Grafana to environment {environment} with service account key {api_key}.
        slots:
          environment: path.environment_api_key
          api_key: requestBody.api_key
      - text: Add an environment Grafana integration on {environment} pointing at {base_url} with key {api_key}.
        slots:
          environment: path.environment_api_key
          base_url: requestBody.base_url
          api_key: requestBody.api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/grafana/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an environment Grafana integration
      effect: read
      questions:
      - Which Grafana URL is an environment's integration annotating?
      - Can I look up one environment-scoped Grafana connection by its id?
      instructions:
      - text: Fetch environment Grafana integration {integration_id} on {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      - text: Show the Grafana settings {integration_id} attached to environment {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/grafana/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an environment Grafana integration
      effect: write
      questions:
      - How can I resubmit an environment's whole Grafana config?
      - Does replacing an environment Grafana integration need the key every time?
      instructions:
      - text: Replace environment Grafana integration {integration_id} on {environment} with key {api_key}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          api_key: requestBody.api_key
      - text: 'Overwrite the Grafana config {integration_id} for environment {environment}: URL {base_url}, key {api_key}.'
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          base_url: requestBody.base_url
          api_key: requestBody.api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/grafana/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an environment Grafana integration
      effect: destructive
      questions:
      - How do I stop one environment from annotating Grafana?
      - Will deleting an environment's Grafana integration affect the project-level one?
      instructions:
      - text: Delete environment Grafana integration {integration_id} from {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      - text: Disconnect Grafana {integration_id} from environment {environment} only.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/grafana/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change one environment Grafana setting
      effect: write
      questions:
      - Can I update just the Grafana URL for one environment's integration?
      - Is rotating an environment Grafana key possible without resending the URL?
      instructions:
      - text: Patch the Grafana URL on environment integration {integration_id} in {environment} to {base_url}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          base_url: requestBody.base_url
      - text: Rotate only the key of environment Grafana integration {integration_id} on {environment} to {api_key}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          api_key: requestBody.api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/heap/'].get
  update:
    x-apievangelist-phrasing:
      intent: List Heap integrations for an environment
      effect: read
      questions:
      - Is Heap wired up to this environment yet?
      - What Heap analytics connections does my environment have?
      instructions:
      - text: List the Heap integrations on environment {environment}.
        slots:
          environment: path.environment_api_key
      - text: Show all Heap analytics hookups for {environment}.
        slots:
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/heap/'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect Heap to an environment
      effect: write
      questions:
      - How do I tag Heap users with the flags they were served?
      - Can I give the Heap integration a custom base URL?
      instructions:
      - text: Connect Heap to environment {environment} with API key {api_key}.
        slots:
          environment: path.environment_api_key
          api_key: requestBody.api_key
      - text: Add a Heap integration on {environment} using key {api_key} and endpoint {base_url}.
        slots:
          environment: path.environment_api_key
          api_key: requestBody.api_key
          base_url: requestBody.base_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/heap/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Heap integration's settings
      effect: read
      questions:
      - Which endpoint is my Heap integration configured to use?
      - Can I view a single Heap connection by id?
      instructions:
      - text: Fetch Heap integration {integration_id} in environment {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      - text: Show the Heap analytics config {integration_id} on {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/heap/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a Heap integration's settings
      effect: write
      questions:
      - Can I resend the full Heap configuration in one request?
      - If I replace my Heap settings, is the API key mandatory?
      instructions:
      - text: Replace Heap integration {integration_id} on {environment} with key {api_key}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          api_key: requestBody.api_key
      - text: Overwrite the whole Heap setup {integration_id} in {environment} using key {api_key} and endpoint {base_url}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          api_key: requestBody.api_key
          base_url: requestBody.base_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/heap/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disconnect Heap from an environment
      effect: destructive
      questions:
      - How do I turn off the Heap integration for an environment?
      - Can a deleted Heap connection be recovered?
      instructions:
      - text: Delete Heap integration {integration_id} from environment {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      - text: Unhook Heap {integration_id} from {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/heap/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change one Heap integration setting
      effect: write
      questions:
      - Can I rotate the Heap API key alone?
      - Is patching only the Heap endpoint supported?
      instructions:
      - text: Update just the Heap key on integration {integration_id} in {environment} to {api_key}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          api_key: requestBody.api_key
      - text: Patch the Heap endpoint of {integration_id} on {environment} to {base_url}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          base_url: requestBody.base_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/mixpanel/'].get
  update:
    x-apievangelist-phrasing:
      intent: List Mixpanel integrations for an environment
      effect: read
      questions:
      - Does this environment already send flag data to Mixpanel?
      - What Mixpanel connections exist on my environment?
      instructions:
      - text: List the Mixpanel integrations on environment {environment}.
        slots:
          environment: path.environment_api_key
      - text: Show me all Mixpanel project links for {environment}.
        slots:
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/mixpanel/'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect Mixpanel to an environment
      effect: write
      questions:
      - How can I enrich Mixpanel user profiles with the flags each user sees?
      - Is a custom API host allowed for the Mixpanel integration?
      instructions:
      - text: Connect Mixpanel to environment {environment} using project token {api_key}.
        slots:
          environment: path.environment_api_key
          api_key: requestBody.api_key
      - text: Add a Mixpanel integration to {environment} with token {api_key} and host {base_url}.
        slots:
          environment: path.environment_api_key
          api_key: requestBody.api_key
          base_url: requestBody.base_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/mixpanel/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Mixpanel integration's settings
      effect: read
      questions:
      - Which host is my Mixpanel integration sending to?
      - Can I check a specific Mixpanel connection's details?
      instructions:
      - text: Fetch Mixpanel integration {integration_id} in environment {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      - text: Show the Mixpanel project link {integration_id} on {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/mixpanel/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a Mixpanel integration's settings
      effect: write
      questions:
      - Can I replace the entire Mixpanel config with a new token and host?
      - Does a full Mixpanel update reset the host if I leave it out?
      instructions:
      - text: Replace Mixpanel integration {integration_id} on {environment} with token {api_key}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          api_key: requestBody.api_key
      - text: 'Overwrite Mixpanel setup {integration_id} in {environment}: token {api_key}, host {base_url}.'
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          api_key: requestBody.api_key
          base_url: requestBody.base_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/mixpanel/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disconnect Mixpanel from an environment
      effect: destructive
      questions:
      - How do I stop pushing flags into Mixpanel from an environment?
      - Does deleting the Mixpanel integration remove data already in Mixpanel?
      instructions:
      - text: Delete Mixpanel integration {integration_id} from environment {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      - text: Unlink Mixpanel {integration_id} from {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/mixpanel/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change one Mixpanel integration setting
      effect: write
      questions:
      - Can I swap only the Mixpanel project token?
      - Is it possible to move the Mixpanel integration to a new host without resending the token?
      instructions:
      - text: Patch the Mixpanel token on integration {integration_id} in {environment} to {api_key}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          api_key: requestBody.api_key
      - text: Change just the Mixpanel host of {integration_id} on {environment} to {base_url}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          base_url: requestBody.base_url
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/rudderstack/'].get
  update:
    x-apievangelist-phrasing:
      intent: List RudderStack integrations for an environment
      effect: read
      questions:
      - Is RudderStack receiving flag data from this environment?
      - Which RudderStack sources are connected to my environment?
      instructions:
      - text: List the RudderStack integrations on environment {environment}.
        slots:
          environment: path.environment_api_key
      - text: Show every RudderStack source hooked to {environment}.
        slots:
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/rudderstack/'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect RudderStack to an environment
      effect: write
      questions:
      - How do I stream flag evaluations into RudderStack?
      - Can the RudderStack integration use my own data plane URL?
      instructions:
      - text: Connect RudderStack to environment {environment} with write key {api_key}.
        slots:
          environment: path.environment_api_key
          api_key: requestBody.api_key
      - text: 'Add a RudderStack integration on {environment}: data plane {base_url}, key {api_key}.'
        slots:
          environment: path.environment_api_key
          base_url: requestBody.base_url
          api_key: requestBody.api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/rudderstack/{id}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one RudderStack integration's settings
      effect: read
      questions:
      - Which data plane URL is my RudderStack integration using?
      - Can I pull up one RudderStack connection by id?
      instructions:
      - text: Fetch RudderStack integration {integration_id} in environment {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      - text: Show the RudderStack source config {integration_id} on {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/rudderstack/{id}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a RudderStack integration's settings
      effect: write
      questions:
      - Can I resubmit RudderStack's data plane and write key together?
      - Is the write key required when fully replacing RudderStack settings?
      instructions:
      - text: Replace RudderStack integration {integration_id} on {environment} with write key {api_key}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          api_key: requestBody.api_key
      - text: 'Overwrite the RudderStack setup {integration_id} in {environment}: data plane {base_url}, key {api_key}.'
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          base_url: requestBody.base_url
          api_key: requestBody.api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/rudderstack/{id}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disconnect RudderStack from an environment
      effect: destructive
      questions:
      - How do I stop sending flag data to RudderStack?
      - What breaks if I remove the RudderStack integration?
      instructions:
      - text: Delete RudderStack integration {integration_id} from environment {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      - text: Detach RudderStack source {integration_id} from {environment}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/rudderstack/{id}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change one RudderStack integration setting
      effect: write
      questions:
      - Can I update only the RudderStack data plane URL?
      - Is rotating just the RudderStack write key supported?
      instructions:
      - text: Patch the RudderStack data plane on {integration_id} in {environment} to {base_url}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          base_url: requestBody.base_url
      - text: Rotate only the RudderStack write key of {integration_id} on {environment} to {api_key}.
        slots:
          integration_id: path.id
          environment: path.environment_api_key
          api_key: requestBody.api_key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/environments/{environment_api_key}/integrations/segment/'].get
  update:
    x-apievangelist-phrasing:
      intent: List Segment integrations for an environment
      effect: read
      questions:
      - Is Segment connected to this environment?
      - What Segment write keys are configured on my environment?
      instructions:
      - text: List the Segment integrations on environment {environment}.
        slots:
          environment: path.environment_api_key
      - text: Show all Segment connections for {environment}.
        slots:
          environment: path.environment_api_key
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (89 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/flagsmith/refs/heads/main/overlays/flagsmith-integrations-api-phrasing-overlay.yaml