# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Applications.app Management Policy API
  version: 1.0.0
extends: openapi/azure-ad-applications-appmanagementpolicy-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}/appManagementPolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: List app management policies applied to an app
      effect: read
      questions:
      - Which app management policies are applied to one of our application registrations?
      - Can I see the full policy objects, like credential restrictions, on an app?
      instructions:
      - text: List the app management policies applied to application {application}.
        slots:
          application: path.application-id
      - text: Show full app management policy details on application {application} with only {fields}.
        slots:
          application: path.application-id
          fields: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/appManagementPolicies/{appManagementPolicy-id}/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unassign a specific app management policy by path
      effect: destructive
      questions:
      - How do I detach one app management policy from an application using the policy's ID in the URL?
      - What happens to an app's credential rules after I remove its app management policy?
      instructions:
      - text: Remove app management policy {policy} from application {application}.
        slots:
          policy: path.appManagementPolicy-id
          application: path.application-id
      - text: Unlink policy {policy} from app {application} so it falls back to the tenant default.
        slots:
          policy: path.appManagementPolicy-id
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/appManagementPolicies/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count app management policies on an app
      effect: read
      questions:
      - How many app management policies are assigned to a given application?
      - Can I count only the assigned policies that match a filter?
      instructions:
      - text: Count the app management policies on application {application}.
        slots:
          application: path.application-id
      - text: Count app management policies on application {application} matching {filter}.
        slots:
          application: path.application-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/appManagementPolicies/$ref'].get
  update:
    x-apievangelist-phrasing:
      intent: List references to an app's management policies
      effect: read
      questions:
      - Can I get just the reference links for the app management policies on an application?
      - Is there a lightweight way to list policy references rather than the full policy objects?
      instructions:
      - text: List only the policy reference links assigned to application {application}.
        slots:
          application: path.application-id
      - text: Get the first {count} app management policy references for application {application}.
        slots:
          count: query.$top
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/appManagementPolicies/$ref'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign an app management policy to an app
      effect: write
      questions:
      - How do I apply an app management policy to an application so it overrides the tenant default?
      - Can I attach a custom credential restriction policy to a single app registration?
      instructions:
      - text: Assign app management policy {policyRef} to application {application}.
        slots:
          policyRef: requestBody.@odata.id
          application: path.application-id
      - text: Apply the policy at {policyRef} to app {application}.
        slots:
          policyRef: requestBody.@odata.id
          application: path.application-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{application-id}/appManagementPolicies/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unassign an app management policy by reference
      effect: destructive
      questions:
      - Can I remove an app management policy from an app by passing the policy's @id reference as a query parameter?
      - Is there a collection-level way to unassign a policy reference from an application?
      instructions:
      - text: Remove the policy referenced by {policyRef} from application {application}.
        slots:
          policyRef: query.@id
          application: path.application-id
      - text: Unassign policy reference {policyRef} from app {application} using the @id query form.
        slots:
          policyRef: query.@id
          application: path.application-id
      method: generated
      generated: '2026-10-01'