# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Admin Portal Identity Store API
  version: 1.0.0
extends: openapi/strivacity-identity-store-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: 7
- target: $.paths['/admin/api/v1/identityStores'].get
  update:
    x-apievangelist-phrasing:
      intent: List identity stores
      effect: read
      questions:
      - Which identity stores are configured in my tenant?
      - Can I filter identity stores by name or policy tag?
      instructions:
      - text: List all identity stores.
      - text: Find identity stores tagged {policyTags}.
        slots:
          policyTags: query.policyTags
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/api/v1/identityStores'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an identity store
      effect: write
      questions:
      - How do I set up a new store to hold customer accounts?
      - Can a new identity store allow organization self-registration?
      instructions:
      - text: Create an identity store named {name} with password policy {passwordPolicy}.
        slots:
          name: requestBody.name
          passwordPolicy: requestBody.passwordPolicy
      - text: Add identity store {name} described as {description}.
        slots:
          name: requestBody.name
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/api/v1/identityStores/{identityStoreName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an identity store
      effect: read
      questions:
      - How do I see the password policy and hooks of one identity store?
      - What settings does a specific identity store have?
      instructions:
      - text: Show identity store {identityStoreName}.
        slots:
          identityStoreName: path.identityStoreName
      - text: Get the configuration of the {identityStoreName} identity store.
        slots:
          identityStoreName: path.identityStoreName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/api/v1/identityStores/{identityStoreName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an identity store
      effect: write
      questions:
      - How do I change the password policy on an existing identity store?
      - Can I rename an identity store?
      instructions:
      - text: Update identity store {identityStoreName} to use password policy {passwordPolicy}.
        slots:
          identityStoreName: path.identityStoreName
          passwordPolicy: requestBody.passwordPolicy
      - text: Turn on the password hash API for identity store {identityStoreName}.
        slots:
          identityStoreName: path.identityStoreName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/api/v1/identityStores/{identityStoreName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an identity store
      effect: destructive
      questions:
      - Why do I get a conflict when deleting an identity store?
      - How do I remove an identity store that is no longer used?
      instructions:
      - text: Delete identity store {identityStoreName}.
        slots:
          identityStoreName: path.identityStoreName
      - text: Remove the empty identity store {identityStoreName}.
        slots:
          identityStoreName: path.identityStoreName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/api/v1/identityStores/{identityStoreName}/availableNativeClaims'].get
  update:
    x-apievangelist-phrasing:
      intent: List native claims available to an identity store
      effect: read
      questions:
      - Which native claims can I map attributes to in an identity store?
      - What built-in claims does an identity store support?
      instructions:
      - text: List the available native claims for identity store {identityStoreName}.
        slots:
          identityStoreName: path.identityStoreName
      - text: Show which native claims {identityStoreName} could use.
        slots:
          identityStoreName: path.identityStoreName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/admin/api/v1/identityStores/{identityStoreName}/nativeClaimMappings'].get
  update:
    x-apievangelist-phrasing:
      intent: List an identity store's native claim mappings
      effect: read
      questions:
      - How are attributes currently mapped to native claims in an identity store?
      - Which attribute feeds the email native claim right now?
      instructions:
      - text: Show the current native claim mappings of identity store {identityStoreName}.
        slots:
          identityStoreName: path.identityStoreName
      - text: List how attributes in {identityStoreName} are mapped to native claims.
        slots:
          identityStoreName: path.identityStoreName
      method: generated
      generated: '2026-10-01'