# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Identity Services Authentication Sequences API
  version: 1.0.0
extends: openapi/palo-alto-networks-authentication-sequences-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: 10
- target: $.paths['/authentication-sequences'].get
  update:
    x-apievangelist-phrasing:
      intent: List authentication sequences
      effect: read
      questions:
      - Which authentication sequences are configured in my Strata Cloud Manager folders?
      - Can I filter authentication sequences by folder or snippet?
      instructions:
      - text: List authentication sequences in folder {folder}.
        slots:
          folder: query.folder
      - text: Find the authentication sequence named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/authentication-sequences'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an authentication sequence
      effect: write
      questions:
      - How do I chain several authentication profiles into one sequence?
      - Can a new authentication sequence use the domain to find the profile?
      instructions:
      - text: Create authentication sequence {name} with profiles {authentication_profiles}.
        slots:
          name: requestBody.name
          authentication_profiles: requestBody.authentication_profiles
      - text: Add authentication sequence {name} with domain-based profile lookup set to {use_domain_find_profile}.
        slots:
          name: requestBody.name
          use_domain_find_profile: requestBody.use_domain_find_profile
      method: generated
      generated: '2026-09-26'
- target: $.paths['/authentication-sequences/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an authentication sequence
      effect: read
      questions:
      - What profiles are in a specific authentication sequence, and in what order?
      - Can I fetch one authentication sequence by its ID?
      instructions:
      - text: Get authentication sequence {id}.
        slots:
          id: path.id
      - text: Show which profiles authentication sequence {id} tries.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/authentication-sequences/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an authentication sequence
      effect: write
      questions:
      - Can I change the profile order in an existing authentication sequence?
      - How do I add a profile to an authentication sequence I already have?
      instructions:
      - text: Update authentication sequence {id} named {name} to use profiles {authentication_profiles}.
        slots:
          id: path.id
          name: requestBody.name
          authentication_profiles: requestBody.authentication_profiles
      - text: Turn domain-based profile lookup to {use_domain_find_profile} on authentication sequence {id} ({name}).
        slots:
          use_domain_find_profile: requestBody.use_domain_find_profile
          id: path.id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/authentication-sequences/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an authentication sequence
      effect: destructive
      questions:
      - Can I remove an authentication sequence that's no longer referenced?
      - What ID do I need to delete an authentication sequence?
      instructions:
      - text: Delete authentication sequence {id}.
        slots:
          id: path.id
      - text: Remove authentication sequence {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/config/v1/authentication-sequences'].get
  update:
    x-apievangelist-phrasing:
      intent: List authentication sequences in a folder
      effect: read
      questions:
      - Which authentication sequences are defined in my Prisma Access folder?
      - Can I look up an authentication sequence by name instead of by ID?
      - How many authentication sequences come back per page, and how do I page through them?
      instructions:
      - text: List all authentication sequences in folder {folder}.
        slots:
          folder: query.folder
      - text: Find the authentication sequence named {name} in folder {folder}.
        slots:
          name: query.name
          folder: query.folder
      - text: Show the next {limit} authentication sequences in {folder} starting at offset {offset}.
        slots:
          limit: query.limit
          folder: query.folder
          offset: query.offset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/authentication-sequences'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an authentication sequence
      effect: write
      questions:
      - How do I set up a new authentication sequence that tries several authentication profiles in order?
      - Can I add an authentication sequence to a folder through the SSE config v1 API?
      instructions:
      - text: Create an authentication sequence called {name} in folder {folder}.
        slots:
          name: requestBody.name
          folder: query.folder
      - text: Create authentication sequence {name} in {folder} that tries profiles {authentication_profiles} in order.
        slots:
          name: requestBody.name
          folder: query.folder
          authentication_profiles: requestBody.authentication_profiles
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/authentication-sequences/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one authentication sequence by ID
      effect: read
      questions:
      - What authentication profiles does a specific authentication sequence contain?
      - Where can I see the full configuration of one authentication sequence by its ID?
      instructions:
      - text: Show me authentication sequence {id}.
        slots:
          id: path.id
      - text: Get the profile order configured in authentication sequence {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/authentication-sequences/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit an existing authentication sequence
      effect: write
      questions:
      - How do I change the profile order in an authentication sequence I already created?
      - Can I rename an existing authentication sequence?
      instructions:
      - text: Rename authentication sequence {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: Edit SSE v1 authentication sequence {id} so it tries {authentication_profiles}.
        slots:
          id: path.id
          authentication_profiles: requestBody.authentication_profiles
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/authentication-sequences/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an authentication sequence
      effect: destructive
      questions:
      - How do I remove an authentication sequence I no longer need?
      - Is deleting an authentication sequence permanent?
      instructions:
      - text: Delete SSE config authentication sequence {id}.
        slots:
          id: path.id
      - text: Remove the unused authentication sequence {id} from the configuration.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'