# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Identity.DirectoryManagement Directory Role…
  version: 1.0.0
extends: openapi/azure-ad-directoryroletemplates-directoryroletemplate-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['/directoryRoleTemplates'].get
  update:
    x-apievangelist-phrasing:
      intent: List directory role templates
      effect: read
      questions:
      - Which built-in directory role templates are available in Entra ID?
      - Can I see every role template I could activate as a directory role?
      instructions:
      - text: List all directory role templates.
      - text: Show me the available built-in role templates.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directoryRoleTemplates'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a directory role template
      effect: write
      questions:
      - Can I add a new entry to the directory role templates collection?
      - What name and description does a new directory role template take?
      instructions:
      - text: Create a directory role template named {display_name} described as {description}.
        slots:
          display_name: requestBody.displayName
          description: requestBody.description
      - text: Add role template {display_name} to the directory.
        slots:
          display_name: requestBody.displayName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directoryRoleTemplates/{directoryRoleTemplate-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a directory role template
      effect: read
      questions:
      - What does a specific directory role template describe?
      - Can I look up a role template by its template ID?
      instructions:
      - text: Get directory role template {template}.
        slots:
          template: path.directoryRoleTemplate-id
      - text: Show the name and description of role template {template}.
        slots:
          template: path.directoryRoleTemplate-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directoryRoleTemplates/{directoryRoleTemplate-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a directory role template
      effect: destructive
      questions:
      - Can a directory role template be deleted from the collection?
      - What is removed when I delete a role template entity?
      instructions:
      - text: Delete directory role template {template}.
        slots:
          template: path.directoryRoleTemplate-id
      - text: Remove role template {template} from the directory.
        slots:
          template: path.directoryRoleTemplate-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directoryRoleTemplates/{directoryRoleTemplate-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a directory role template
      effect: write
      questions:
      - Can I change the display name or description of a role template?
      - Is it possible to edit an existing directory role template entity?
      instructions:
      - text: Rename directory role template {template} to {display_name}.
        slots:
          template: path.directoryRoleTemplate-id
          display_name: requestBody.displayName
      - text: Set the description of role template {template} to {description}.
        slots:
          template: path.directoryRoleTemplate-id
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/directoryRoleTemplates/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count directory role templates
      effect: read
      questions:
      - How many directory role templates exist?
      - Can I get just the total of role templates in the directory?
      instructions:
      - text: Count the directory role templates.
      - text: Tell me how many role templates there are.
      method: generated
      generated: '2026-10-01'