# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Strivacity Adaptive Access Policy (Adaptive MFA) API
  version: 1.0.0
extends: openapi/strivacity-adaptive-access-policy-adaptive-mfa-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['/admin/api/v1/admin/adaptiveMfa'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the admin adaptive access policy
      effect: read
      questions:
      - What MFA rules apply to admin console logins?
      - Can I see the admin adaptive access policy settings?
      instructions:
      - text: Show the admin adaptive access policy.
      - text: Get the MFA and lockout settings used for admin sign-ins.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/api/v1/admin/adaptiveMfa'].put
  update:
    x-apievangelist-phrasing:
      intent: Update the admin adaptive access policy
      effect: write
      questions:
      - How do I require MFA for administrators signing in?
      - Can I change account lockout rules for the admin console?
      instructions:
      - text: Update the admin adaptive access policy with MFA settings {mfa} and workflow {workflow}.
        slots:
          mfa: requestBody.mfa
          workflow: requestBody.workflow
      - text: Set admin account lockout to {accountLockout}.
        slots:
          accountLockout: requestBody.accountLockout
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/api/v1/admin/adaptiveMfa/location'].get
  update:
    x-apievangelist-phrasing:
      intent: Search locations for the admin access policy
      effect: read
      questions:
      - Which locations match a prefix when building admin MFA location rules?
      - Can I look up locations for the admin access policy by typing part of a name?
      instructions:
      - text: Find locations starting with {location} for the admin access policy.
        slots:
          location: query.location
      - text: Search admin MFA policy locations by prefix {location}.
        slots:
          location: query.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/api/v1/adaptiveMfas'].get
  update:
    x-apievangelist-phrasing:
      intent: List adaptive access policies
      effect: read
      questions:
      - What adaptive access policies exist for my customer applications?
      - Can I filter adaptive MFA policies by name or policy tag?
      instructions:
      - text: List adaptive access policies.
      - text: List adaptive access policies tagged {policyTags}.
        slots:
          policyTags: query.policyTags
      - text: Find adaptive access policies named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/api/v1/adaptiveMfas'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an adaptive access policy
      effect: write
      questions:
      - How do I set up a new risk-based MFA policy for customers?
      - Can a new adaptive access policy allow password reset with the email attribute?
      instructions:
      - text: Create adaptive access policy {name} with MFA {mfa} and workflow {workflow}.
        slots:
          name: requestBody.name
          mfa: requestBody.mfa
          workflow: requestBody.workflow
      - text: Create policy {name} with session termination {sessionTermination}.
        slots:
          name: requestBody.name
          sessionTermination: requestBody.sessionTermination
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/api/v1/adaptiveMfas/location'].get
  update:
    x-apievangelist-phrasing:
      intent: Search locations for adaptive access policies
      effect: read
      questions:
      - Which locations can I use in a customer adaptive access policy rule?
      - Is there a location prefix lookup for customer MFA policies?
      instructions:
      - text: Look up customer policy locations matching {location}.
        slots:
          location: query.location
      - text: Suggest locations beginning with {location} for an adaptive access rule.
        slots:
          location: query.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/api/v1/adaptiveMfas/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an adaptive access policy
      effect: read
      questions:
      - Can I see the rules and MFA settings of one adaptive access policy?
      - What workflow does a specific adaptive access policy use?
      instructions:
      - text: Get adaptive access policy {id}.
        slots:
          id: path.id
      - text: Show the MFA rules in policy {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/api/v1/adaptiveMfas/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an adaptive access policy
      effect: write
      questions:
      - How do I change the rules on an existing adaptive access policy?
      - Can I rename an adaptive MFA policy or change its tag?
      instructions:
      - text: Update adaptive access policy {id} with rules {rules}.
        slots:
          id: path.id
          rules: requestBody.rules
      - text: Rename adaptive access policy {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/api/v1/adaptiveMfas/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an adaptive access policy
      effect: destructive
      questions:
      - Can I delete an adaptive access policy that is still assigned to an application?
      - How do I remove an unused adaptive MFA policy?
      instructions:
      - text: Delete adaptive access policy {id}.
        slots:
          id: path.id
      - text: Remove the unused MFA policy {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'