# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Applications.token Lifetime Policy API
  version: 1.0.0
extends: openapi/azure-ad-applications-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['/applications/{application-id}/tokenLifetimePolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: List token lifetime policies assigned to an app
      effect: read
      questions:
      - Which token lifetime policy is assigned to an application, with its full settings?
      - Why does an app only ever return one token lifetime policy?
      instructions:
      - text: List the token lifetime policies assigned to application {app_id}.
        slots:
          app_id: path.application-id
      - text: Show the full token lifetime policy objects on app {app_id}.
        slots:
          app_id: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/tokenLifetimePolicies/{tokenLifetimePolicy-id}/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unassign a token lifetime policy from an app
      effect: destructive
      questions:
      - How do I remove a specific token lifetime policy from an application by the policy's ID?
      - Does unassigning a token lifetime policy from an app delete the policy itself?
      instructions:
      - text: Remove token lifetime policy {policy_id} from application {app_id}.
        slots:
          policy_id: path.tokenLifetimePolicy-id
          app_id: path.application-id
      - text: Unassign policy {policy_id} from app {app_id} using its policy ID in the path.
        slots:
          policy_id: path.tokenLifetimePolicy-id
          app_id: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/tokenLifetimePolicies/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count token lifetime policies on an app
      effect: read
      questions:
      - How many token lifetime policies are assigned to an application?
      - Does this app have any token lifetime policy at all?
      instructions:
      - text: Count the token lifetime policies on application {app_id}.
        slots:
          app_id: path.application-id
      - text: Return the number of token lifetime assignments for app {app_id}.
        slots:
          app_id: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/tokenLifetimePolicies/$ref'].get
  update:
    x-apievangelist-phrasing:
      intent: List token lifetime policy references on an app
      effect: read
      questions:
      - Can I get just the reference links of the token lifetime policies assigned to an app?
      - What policy IDs are linked to an application without fetching the full policy bodies?
      instructions:
      - text: List the token lifetime policy references on application {app_id}.
        slots:
          app_id: path.application-id
      - text: Show only the @odata.id links of token lifetime policies on app {app_id}.
        slots:
          app_id: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/tokenLifetimePolicies/$ref'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign a token lifetime policy to an app
      effect: write
      questions:
      - How do I apply a custom token lifetime policy to an application in Entra ID?
      - Can an application have more than one token lifetime policy assigned?
      instructions:
      - text: Assign the token lifetime policy at {policy_ref} to application {app_id}.
        slots:
          policy_ref: requestBody.@odata.id
          app_id: path.application-id
      - text: Link token lifetime policy {policy_ref} to app {app_id}.
        slots:
          policy_ref: requestBody.@odata.id
          app_id: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/tokenLifetimePolicies/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unassign a token lifetime policy by reference
      effect: destructive
      questions:
      - Can I remove a token lifetime policy from an app by passing the policy reference as a query parameter?
      - What goes in the @id parameter when unlinking a token lifetime policy from an application?
      instructions:
      - text: Remove the token lifetime policy reference {policy_ref} from application {app_id}.
        slots:
          policy_ref: query.@id
          app_id: path.application-id
      - text: Unlink policy {policy_ref} from app {app_id} using the @id query reference.
        slots:
          policy_ref: query.@id
          app_id: path.application-id
      method: generated
      generated: '2026-10-01'