# 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 Lifetime Policy API
  version: 1.0.0
extends: openapi/azure-ad-policies-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: 9
- target: $.paths['/policies/tokenLifetimePolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: List token lifetime policies
      effect: read
      questions:
      - What token lifetime policies are defined in my tenant?
      - Which policies control how long access and ID tokens stay valid?
      instructions:
      - text: List all token lifetime policies.
      - text: Show every policy that sets access or ID token lifetimes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenLifetimePolicies'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a token lifetime policy
      effect: write
      questions:
      - How do I create a policy that shortens access token lifetime?
      - Can I define a custom token lifetime for tokens issued in my tenant?
      instructions:
      - text: Create a new token lifetime policy.
      - text: Add a token lifetime policy that sets a custom access token lifetime.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenLifetimePolicies/{tokenLifetimePolicy-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a token lifetime policy
      effect: read
      questions:
      - What token lifetime does a particular policy define?
      - Is a given token lifetime policy the organization default?
      instructions:
      - text: Get token lifetime policy {policy_id}.
        slots:
          policy_id: path.tokenLifetimePolicy-id
      - text: Show the definition of token lifetime policy {policy_id}.
        slots:
          policy_id: path.tokenLifetimePolicy-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenLifetimePolicies/{tokenLifetimePolicy-id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a token lifetime policy
      effect: destructive
      questions:
      - How do I remove a token lifetime policy we no longer want?
      - Can I delete a token lifetime policy so tokens fall back to default lifetimes?
      instructions:
      - text: Delete token lifetime policy {policy_id}.
        slots:
          policy_id: path.tokenLifetimePolicy-id
      - text: Remove the token lifetime policy {policy_id} from the tenant.
        slots:
          policy_id: path.tokenLifetimePolicy-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenLifetimePolicies/{tokenLifetimePolicy-id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a token lifetime policy
      effect: write
      questions:
      - How do I change the lifetime set in an existing token lifetime policy?
      - Can I edit a token lifetime policy's definition in place?
      instructions:
      - text: Update token lifetime policy {policy_id}.
        slots:
          policy_id: path.tokenLifetimePolicy-id
      - text: Change the token lifetime defined in policy {policy_id}.
        slots:
          policy_id: path.tokenLifetimePolicy-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenLifetimePolicies/{tokenLifetimePolicy-id}/appliesTo'].get
  update:
    x-apievangelist-phrasing:
      intent: List apps a token lifetime policy applies to
      effect: read
      questions:
      - Which applications or service principals is a token lifetime policy applied to?
      - Where is this token lifetime policy in effect?
      instructions:
      - text: List the objects token lifetime policy {policy_id} applies to.
        slots:
          policy_id: path.tokenLifetimePolicy-id
      - text: Show the apps and service principals using token lifetime policy {policy_id}.
        slots:
          policy_id: path.tokenLifetimePolicy-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenLifetimePolicies/{tokenLifetimePolicy-id}/appliesTo/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one object a token lifetime policy applies to
      effect: read
      questions:
      - Is a specific application covered by a given token lifetime policy?
      - Can I read one directory object from a token lifetime policy's applies-to list?
      instructions:
      - text: Get object {object_id} from the applies-to list of token lifetime policy {policy_id}.
        slots:
          object_id: path.directoryObject-id
          policy_id: path.tokenLifetimePolicy-id
      - text: Check whether directory object {object_id} is under token lifetime policy {policy_id}.
        slots:
          object_id: path.directoryObject-id
          policy_id: path.tokenLifetimePolicy-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenLifetimePolicies/{tokenLifetimePolicy-id}/appliesTo/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count objects a token lifetime policy applies to
      effect: read
      questions:
      - How many apps is a token lifetime policy applied to?
      - Is this token lifetime policy assigned anywhere at all?
      instructions:
      - text: Count the objects token lifetime policy {policy_id} applies to.
        slots:
          policy_id: path.tokenLifetimePolicy-id
      - text: Tell me how many apps use token lifetime policy {policy_id}.
        slots:
          policy_id: path.tokenLifetimePolicy-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/policies/tokenLifetimePolicies/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count token lifetime policies
      effect: read
      questions:
      - How many token lifetime policies does my tenant have?
      - What's the total number of token lifetime policies defined?
      instructions:
      - text: Count the token lifetime policies.
      - text: Tell me how many token lifetime policies exist in the tenant.
      method: generated
      generated: '2026-10-01'