# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Dialogflow CX API (v3) - Conversational Agents Transition…
  version: 1.0.0
extends: openapi/google-dialogflow-transitionroutegroups-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: 10
- target: $.paths['/v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/transitionRouteGroups/{transitionRouteGroupsId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an agent-level transition route group
      effect: read
      questions:
      - What routes are inside a transition route group shared across my whole CX agent?
      - Can I read an agent-wide route group in a particular language?
      instructions:
      - text: Get agent-level route group {group} on CX agent {agent}, project {project}, location {location}.
        slots:
          group: path.transitionRouteGroupsId
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
      - text: Show agent {agent}'s shared transition route group {group} in language {language} ({project}/{location}).
        slots:
          agent: path.agentsId
          group: path.transitionRouteGroupsId
          language: query.languageCode
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/transitionRouteGroups/{transitionRouteGroupsId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an agent-level transition route group
      effect: destructive
      questions:
      - Can I delete a transition route group shared at the CX agent level?
      - Can I force-delete an agent-wide route group that flows still reference?
      instructions:
      - text: Delete agent-level route group {group} from CX agent {agent}, project {project}, location {location}.
        slots:
          group: path.transitionRouteGroupsId
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
      - text: Force-remove agent {agent}'s shared route group {group} with force={force} ({project}/{location}).
        slots:
          agent: path.agentsId
          group: path.transitionRouteGroupsId
          force: query.force
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/transitionRouteGroups/{transitionRouteGroupsId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an agent-level transition route group
      effect: write
      questions:
      - How do I change the routes in a transition route group shared across my CX agent?
      - Can I rename an agent-wide route group without touching its routes?
      instructions:
      - text: Replace the routes of agent-level route group {group} on CX agent {agent} ({project}/{location}) with {routes}.
        slots:
          group: path.transitionRouteGroupsId
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
          routes: requestBody.transitionRoutes
      - text: Rename agent {agent}'s shared route group {group} to {display_name} in project {project}, location {location}.
        slots:
          agent: path.agentsId
          group: path.transitionRouteGroupsId
          display_name: requestBody.displayName
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/transitionRouteGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List agent-level transition route groups
      effect: read
      questions:
      - Which transition route groups are shared at the agent level on my Dialogflow CX agent?
      - Can I page through agent-wide route groups in one language?
      instructions:
      - text: List agent-level transition route groups on CX agent {agent}, project {project}, location {location}.
        slots:
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
      - text: Show agent {agent}'s shared route groups in language {language} ({project}/{location}).
        slots:
          agent: path.agentsId
          language: query.languageCode
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/transitionRouteGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an agent-level transition route group
      effect: write
      questions:
      - How do I create a reusable transition route group that any flow in my CX agent can use?
      - Can I define the routes when I create an agent-wide route group?
      instructions:
      - text: Create agent-level route group {display_name} on CX agent {agent}, project {project}, location {location}.
        slots:
          display_name: requestBody.displayName
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
      - text: Add a shared route group {display_name} with routes {routes} to agent {agent} ({project}/{location}).
        slots:
          display_name: requestBody.displayName
          routes: requestBody.transitionRoutes
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/flows/{flowsId}/transitionRouteGroups/{transitionRouteGroupsId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a flow's transition route group
      effect: read
      questions:
      - What does a transition route group that belongs to one flow of my CX agent contain?
      - Can I fetch a flow-scoped route group in a specific language?
      instructions:
      - text: Get route group {group} in flow {flow} of CX agent {agent}, project {project}, location {location}.
        slots:
          group: path.transitionRouteGroupsId
          flow: path.flowsId
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
      - text: Show flow {flow}'s route group {group} in language {language} on agent {agent} ({project}/{location}).
        slots:
          flow: path.flowsId
          group: path.transitionRouteGroupsId
          language: query.languageCode
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/flows/{flowsId}/transitionRouteGroups/{transitionRouteGroupsId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a flow's transition route group
      effect: destructive
      questions:
      - Can I delete a transition route group defined inside a single CX flow?
      - Can I force-delete a flow-scoped route group that its pages still use?
      instructions:
      - text: Delete route group {group} from flow {flow} of CX agent {agent}, project {project}, location {location}.
        slots:
          group: path.transitionRouteGroupsId
          flow: path.flowsId
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
      - text: Force-remove flow {flow}'s route group {group} with force={force} on agent {agent} ({project}/{location}).
        slots:
          flow: path.flowsId
          group: path.transitionRouteGroupsId
          force: query.force
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/flows/{flowsId}/transitionRouteGroups/{transitionRouteGroupsId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a flow's transition route group
      effect: write
      questions:
      - How do I edit the routes in a transition route group that lives in one CX flow?
      - Can I rename a flow-scoped route group?
      instructions:
      - text: Replace the routes of route group {group} in flow {flow}, CX agent {agent} ({project}/{location}) with {routes}.
        slots:
          group: path.transitionRouteGroupsId
          flow: path.flowsId
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
          routes: requestBody.transitionRoutes
      - text: Rename flow {flow}'s route group {group} to {display_name} on agent {agent}, project {project}, location {location}.
        slots:
          flow: path.flowsId
          group: path.transitionRouteGroupsId
          display_name: requestBody.displayName
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/flows/{flowsId}/transitionRouteGroups'].get
  update:
    x-apievangelist-phrasing:
      intent: List a flow's transition route groups
      effect: read
      questions:
      - Which transition route groups are defined inside a specific flow of my CX agent?
      - Can I list flow-scoped route groups in a chosen language?
      instructions:
      - text: List route groups in flow {flow} of CX agent {agent}, project {project}, location {location}.
        slots:
          flow: path.flowsId
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
      - text: Show flow {flow}'s transition route groups, {page_size} per page, on agent {agent} ({project}/{location}).
        slots:
          flow: path.flowsId
          page_size: query.pageSize
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/projects/{projectsId}/locations/{locationsId}/agents/{agentsId}/flows/{flowsId}/transitionRouteGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a transition route group in a flow
      effect: write
      questions:
      - How do I create a transition route group that only pages in one CX flow can use?
      - Can I add routes to a new flow-scoped route group as I create it?
      instructions:
      - text: Create route group {display_name} in flow {flow} of CX agent {agent}, project {project}, location {location}.
        slots:
          display_name: requestBody.displayName
          flow: path.flowsId
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
      - text: Add a route group {display_name} with routes {routes} to flow {flow} on agent {agent} ({project}/{location}).
        slots:
          display_name: requestBody.displayName
          routes: requestBody.transitionRoutes
          flow: path.flowsId
          agent: path.agentsId
          project: path.projectsId
          location: path.locationsId
      method: generated
      generated: '2026-10-01'