# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Identity.SignIns Policies.token Issuance Policy API
  version: 1.0.0
extends: openapi/azure-ad-policies-tokenissuancepolicy-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: 9
- target: $.paths['/policies/tokenIssuancePolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: List token issuance policies
      effect: read
      questions:
      - Which token issuance policies are defined in my tenant?
      - Can I search our SAML token issuance policies by display name?
      instructions:
      - text: List all token issuance policies.
      - text: List token issuance policies matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenIssuancePolicies'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a token issuance policy
      effect: write
      questions:
      - How do I define a new policy that controls the SAML tokens Entra ID issues?
      - Can I add another token issuance policy to customize how SAML tokens are signed?
      instructions:
      - text: Create a new token issuance policy.
      - text: Set up a new SAML token issuance policy for the tenant.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenIssuancePolicies/{tokenIssuancePolicy-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a token issuance policy
      effect: read
      questions:
      - What SAML token characteristics does one specific token issuance policy define?
      - How do I read the settings of a single token issuance policy?
      instructions:
      - text: Get token issuance policy {tokenIssuancePolicy}.
        slots:
          tokenIssuancePolicy: path.tokenIssuancePolicy-id
      - text: Show the SAML token settings in policy {tokenIssuancePolicy}.
        slots:
          tokenIssuancePolicy: path.tokenIssuancePolicy-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenIssuancePolicies/{tokenIssuancePolicy-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a token issuance policy
      effect: destructive
      questions:
      - Can I remove a token issuance policy we no longer use?
      - How do I delete an unused SAML token issuance policy from the tenant?
      instructions:
      - text: Delete token issuance policy {tokenIssuancePolicy}.
        slots:
          tokenIssuancePolicy: path.tokenIssuancePolicy-id
      - text: Remove SAML token policy {tokenIssuancePolicy} from the tenant.
        slots:
          tokenIssuancePolicy: path.tokenIssuancePolicy-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenIssuancePolicies/{tokenIssuancePolicy-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a token issuance policy
      effect: write
      questions:
      - How do I change the settings of an existing token issuance policy?
      - Can I edit a SAML token issuance policy without recreating it?
      instructions:
      - text: Update token issuance policy {tokenIssuancePolicy}.
        slots:
          tokenIssuancePolicy: path.tokenIssuancePolicy-id
      - text: Modify the existing SAML token policy {tokenIssuancePolicy}.
        slots:
          tokenIssuancePolicy: path.tokenIssuancePolicy-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenIssuancePolicies/{tokenIssuancePolicy-id}/appliesTo'].get
  update:
    x-apievangelist-phrasing:
      intent: List apps a token issuance policy applies to
      effect: read
      questions:
      - Which applications is a given token issuance policy assigned to?
      - What directory objects are using this SAML token policy?
      instructions:
      - text: List the objects token issuance policy {tokenIssuancePolicy} is applied to.
        slots:
          tokenIssuancePolicy: path.tokenIssuancePolicy-id
      - text: Show which applications use SAML token policy {tokenIssuancePolicy}.
        slots:
          tokenIssuancePolicy: path.tokenIssuancePolicy-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenIssuancePolicies/{tokenIssuancePolicy-id}/appliesTo/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one object a token policy applies to
      effect: read
      questions:
      - Is a specific application among the objects a token issuance policy is applied to?
      - How do I fetch one directory object from a token issuance policy's assignments?
      instructions:
      - text: Get object {directoryObject} that token issuance policy {tokenIssuancePolicy} applies to.
        slots:
          directoryObject: path.directoryObject-id
          tokenIssuancePolicy: path.tokenIssuancePolicy-id
      - text: Check whether policy {tokenIssuancePolicy} is assigned to {directoryObject}.
        slots:
          directoryObject: path.directoryObject-id
          tokenIssuancePolicy: path.tokenIssuancePolicy-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenIssuancePolicies/{tokenIssuancePolicy-id}/appliesTo/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count objects a token issuance policy covers
      effect: read
      questions:
      - How many applications is one token issuance policy applied to?
      - Can I get just the number of assignments for a SAML token policy?
      instructions:
      - text: Count the objects token issuance policy {tokenIssuancePolicy} applies to.
        slots:
          tokenIssuancePolicy: path.tokenIssuancePolicy-id
      - text: Tell me how many apps use SAML token policy {tokenIssuancePolicy}.
        slots:
          tokenIssuancePolicy: path.tokenIssuancePolicy-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenIssuancePolicies/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count token issuance policies
      effect: read
      questions:
      - How many token issuance policies exist in the tenant?
      - What's the total number of SAML token policies matching a filter?
      instructions:
      - text: Count the token issuance policies in the tenant.
      - text: Count token issuance policies matching {filter}.
        slots:
          filter: query.$filter
      method: generated
      generated: '2026-10-01'