# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Applications Service Principals.token Issuance Policy API
  version: 1.0.0
extends: openapi/azure-ad-serviceprincipals-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: 6
- target: $.paths['/servicePrincipals/{servicePrincipal-id}/tokenIssuancePolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: List a service principal's token issuance policies
      effect: read
      questions:
      - Which token issuance policies are assigned to a service principal?
      - Can I see the full policy objects controlling SAML tokens for an enterprise app?
      instructions:
      - text: List the token issuance policies on service principal {service_principal}.
        slots:
          service_principal: path.servicePrincipal-id
      - text: Show full token issuance policy details for service principal {service_principal}.
        slots:
          service_principal: path.servicePrincipal-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/servicePrincipals/{servicePrincipal-id}/tokenIssuancePolicies/{tokenIssuancePolicy-id}/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unassign a token issuance policy by its ID
      effect: destructive
      questions:
      - Can I unassign a specific token issuance policy from a service principal using the policy ID in the path?
      - Does unlinking a token issuance policy from a service principal delete the policy itself?
      instructions:
      - text: Unassign token issuance policy {policy} from service principal {service_principal}.
        slots:
          policy: path.tokenIssuancePolicy-id
          service_principal: path.servicePrincipal-id
      - text: Remove the link between policy {policy} and service principal {service_principal}.
        slots:
          policy: path.tokenIssuancePolicy-id
          service_principal: path.servicePrincipal-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/servicePrincipals/{servicePrincipal-id}/tokenIssuancePolicies/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a service principal's token issuance policies
      effect: read
      questions:
      - How many token issuance policies are assigned to a service principal?
      - Can I check whether any token issuance policy is on an enterprise app?
      instructions:
      - text: Count the token issuance policies on service principal {service_principal}.
        slots:
          service_principal: path.servicePrincipal-id
      - text: Tell me how many token issuance policies {service_principal} has.
        slots:
          service_principal: path.servicePrincipal-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/servicePrincipals/{servicePrincipal-id}/tokenIssuancePolicies/$ref'].get
  update:
    x-apievangelist-phrasing:
      intent: List token issuance policy references
      effect: read
      questions:
      - Can I get just the reference links of the token issuance policies on a service principal?
      - Which token issuance policy IDs are linked to a service principal as $ref entries?
      instructions:
      - text: List the token issuance policy references on service principal {service_principal}.
        slots:
          service_principal: path.servicePrincipal-id
      - text: Give me only the $ref links for token issuance policies of {service_principal}.
        slots:
          service_principal: path.servicePrincipal-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/servicePrincipals/{servicePrincipal-id}/tokenIssuancePolicies/$ref'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign a token issuance policy to a service principal
      effect: write
      questions:
      - How do I apply a token issuance policy to an enterprise app's service principal?
      - Can I link an existing token issuance policy to a service principal by reference?
      instructions:
      - text: Assign token issuance policy {policy_ref} to service principal {service_principal}.
        slots:
          policy_ref: requestBody.@odata.id
          service_principal: path.servicePrincipal-id
      - text: Link the policy at {policy_ref} to service principal {service_principal} for token issuance.
        slots:
          policy_ref: requestBody.@odata.id
          service_principal: path.servicePrincipal-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/servicePrincipals/{servicePrincipal-id}/tokenIssuancePolicies/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unassign a token issuance policy by @id reference
      effect: destructive
      questions:
      - Can I remove a token issuance policy link by passing its reference as an @id query value?
      - Is there a way to unlink a token issuance policy using its $ref URL instead of the policy ID path?
      instructions:
      - text: Remove the token issuance policy referenced by {policy_ref} from service principal {service_principal}.
        slots:
          policy_ref: query.@id
          service_principal: path.servicePrincipal-id
      - text: Unlink token issuance policy {policy_ref} from {service_principal} via its @id reference.
        slots:
          policy_ref: query.@id
          service_principal: path.servicePrincipal-id
      method: generated
      generated: '2026-10-01'