# 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 Lifetime Policy API
  version: 1.0.0
extends: openapi/azure-ad-serviceprincipals-tokenlifetimepolicy-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}/tokenLifetimePolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: List token lifetime policies on a service principal
      effect: read
      questions:
      - Which token lifetime policy is assigned to an enterprise app's service principal?
      - Can I read the full token lifetime policy object applied to a service principal?
      instructions:
      - text: List the token lifetime policies assigned to service principal {sp}, with full details.
        slots:
          sp: path.servicePrincipal-id
      - text: Show the token lifetime policy settings on service principal {sp}.
        slots:
          sp: path.servicePrincipal-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/servicePrincipals/{servicePrincipal-id}/tokenLifetimePolicies/{tokenLifetimePolicy-id}/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unassign a token lifetime policy by id
      effect: destructive
      questions:
      - How do I remove a specific token lifetime policy from a service principal?
      - Can I unassign a token lifetime policy by putting its id in the URL path?
      instructions:
      - text: Remove token lifetime policy {policy} from service principal {sp}.
        slots:
          policy: path.tokenLifetimePolicy-id
          sp: path.servicePrincipal-id
      - text: Unassign policy {policy} from service principal {sp} using its path id.
        slots:
          policy: path.tokenLifetimePolicy-id
          sp: path.servicePrincipal-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/servicePrincipals/{servicePrincipal-id}/tokenLifetimePolicies/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count token lifetime policies on a service principal
      effect: read
      questions:
      - Does this service principal have a token lifetime policy, going by the count?
      - What's the number of token lifetime policies assigned to a service principal?
      instructions:
      - text: Count the token lifetime policies on service principal {sp}.
        slots:
          sp: path.servicePrincipal-id
      - text: Tell me how many token lifetime policies service principal {sp} has.
        slots:
          sp: path.servicePrincipal-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/servicePrincipals/{servicePrincipal-id}/tokenLifetimePolicies/$ref'].get
  update:
    x-apievangelist-phrasing:
      intent: List token lifetime policy references
      effect: read
      questions:
      - Can I get just the reference link of a service principal's token lifetime policy?
      - Which token lifetime policy id is linked to a service principal, without the full object?
      instructions:
      - text: List the token lifetime policy references ($ref) on service principal {sp}.
        slots:
          sp: path.servicePrincipal-id
      - text: Return only the @odata.id link of the token policy on service principal {sp}.
        slots:
          sp: path.servicePrincipal-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/servicePrincipals/{servicePrincipal-id}/tokenLifetimePolicies/$ref'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign a token lifetime policy to a service principal
      effect: write
      questions:
      - How do I apply a token lifetime policy to a service principal?
      - Can I assign more than one token lifetime policy to the same service principal?
      instructions:
      - text: Assign token lifetime policy {policy_ref} to service principal {sp}.
        slots:
          policy_ref: requestBody.@odata.id
          sp: path.servicePrincipal-id
      - text: Link the policy at {policy_ref} to service principal {sp} to control its token lifetimes.
        slots:
          policy_ref: requestBody.@odata.id
          sp: path.servicePrincipal-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/servicePrincipals/{servicePrincipal-id}/tokenLifetimePolicies/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unassign a token lifetime policy by reference query
      effect: destructive
      questions:
      - Can I remove a token lifetime policy from a service principal by passing its @id as a query parameter?
      - What is the collection-level way to detach a token lifetime policy?
      instructions:
      - text: Remove the policy referenced by {policy_ref} from service principal {sp} via the @id query.
        slots:
          policy_ref: query.@id
          sp: path.servicePrincipal-id
      - text: Detach {policy_ref} from service principal {sp} using the tokenLifetimePolicies $ref collection.
        slots:
          policy_ref: query.@id
          sp: path.servicePrincipal-id
      method: generated
      generated: '2026-10-01'