# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for authentik Propertymappings API
  version: 1.0.0
extends: openapi/authentik-propertymappings-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 111
- target: $.paths['/propertymappings/all/'].get
  update:
    x-apievangelist-phrasing:
      intent: List property mappings of every type
      effect: read
      questions:
      - What property mappings exist across all types in my authentik instance?
      - Can I see only the built-in managed mappings, whatever kind they are?
      instructions:
      - text: List every property mapping regardless of type.
      - text: Search all property mappings of any type for {term}.
        slots:
          term: query.search
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/all/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get any property mapping by ID
      effect: read
      questions:
      - How do I look up a property mapping when I only have its UUID and not its type?
      - Which type and expression does an unknown mapping ID resolve to?
      instructions:
      - text: Show the generic property mapping record for {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Look up mapping {mapping_id} without knowing which kind it is.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/all/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete any property mapping by ID
      effect: destructive
      questions:
      - Can I delete a property mapping through the generic endpoint without knowing its type?
      - Is there a single call that removes a mapping of any kind?
      instructions:
      - text: Delete property mapping {mapping_id} via the all-types endpoint.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove mapping {mapping_id}, whatever type it is.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/all/{pm_uuid}/test/'].post
  update:
    x-apievangelist-phrasing:
      intent: Test a property mapping against a user
      effect: read
      questions:
      - How do I preview what a property mapping expression returns for a given user?
      - Can I dry-run a mapping against a group or custom context before attaching it?
      - Is there a way to get the mapping test output pretty-formatted?
      instructions:
      - text: Test property mapping {mapping_id} against user {user}.
        slots:
          mapping_id: path.pm_uuid
          user: requestBody.user
      - text: Evaluate mapping {mapping_id} for group {group} and format the result.
        slots:
          mapping_id: path.pm_uuid
          group: requestBody.group
      - text: Run mapping {mapping_id} with extra context {context} and show what it outputs.
        slots:
          mapping_id: path.pm_uuid
          context: requestBody.context
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/all/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses any property mapping
      effect: read
      questions:
      - Which providers or sources reference a mapping, looked up by its UUID alone?
      - Would anything break if I removed a mapping of an unknown type?
      instructions:
      - text: Show every object that depends on mapping {mapping_id} using the all-types lookup.
        slots:
          mapping_id: path.pm_uuid
      - text: Check what still references generic mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/all/types/'].get
  update:
    x-apievangelist-phrasing:
      intent: List creatable property mapping types
      effect: read
      questions:
      - What kinds of property mappings can I create in authentik?
      - Which mapping types are available to choose from when adding a new one?
      instructions:
      - text: List all the property mapping types I can create.
      - text: Show the available mapping kinds with their component names.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/notification/'].get
  update:
    x-apievangelist-phrasing:
      intent: List notification webhook mappings
      effect: read
      questions:
      - Which webhook mappings shape the payload of my notification transports?
      - Can I filter notification webhook mappings by name?
      instructions:
      - text: List my notification webhook mappings.
      - text: Find the notification webhook mapping called {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/notification/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a notification webhook mapping
      effect: write
      questions:
      - How do I customize the JSON body a notification webhook sends?
      - Can I add a new webhook mapping with my own Python expression for alerts?
      instructions:
      - text: Create a notification webhook mapping {name} with expression {expression}.
        slots:
          name: requestBody.name
          expression: requestBody.expression
      - text: Add a new webhook payload mapping named {name} that returns {expression}.
        slots:
          name: requestBody.name
          expression: requestBody.expression
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/notification/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a notification webhook mapping
      effect: read
      questions:
      - What expression does a particular notification webhook mapping run?
      - Can I view the details of one webhook payload mapping?
      instructions:
      - text: Show notification webhook mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Get the expression of webhook mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/notification/{pm_uuid}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a notification webhook mapping
      effect: write
      questions:
      - How do I overwrite both the name and expression of a webhook mapping at once?
      - Can I fully replace an existing notification webhook mapping definition?
      instructions:
      - text: Replace webhook mapping {mapping_id} with name {name} and expression {expression}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
          expression: requestBody.expression
      - text: Overwrite notification mapping {mapping_id} entirely, naming it {name}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/notification/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a notification webhook mapping
      effect: destructive
      questions:
      - How do I remove a webhook payload mapping I no longer use?
      - Can I delete a notification webhook mapping for good?
      instructions:
      - text: Delete notification webhook mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove the webhook payload mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/notification/{pm_uuid}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of a notification webhook mapping
      effect: write
      questions:
      - Can I change only the expression of a notification webhook mapping?
      - Is it possible to rename a webhook mapping without resending its expression?
      instructions:
      - text: Change just the expression of webhook mapping {mapping_id} to {expression}.
        slots:
          mapping_id: path.pm_uuid
          expression: requestBody.expression
      - text: Rename notification webhook mapping {mapping_id} to {name}, leaving the rest.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/notification/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses a notification webhook mapping
      effect: read
      questions:
      - Which notification transports rely on this webhook mapping?
      - Is a given webhook payload mapping still in use anywhere?
      instructions:
      - text: List the objects that use notification webhook mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Check whether webhook mapping {mapping_id} is referenced by any transport.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/google_workspace/'].get
  update:
    x-apievangelist-phrasing:
      intent: List Google Workspace provider mappings
      effect: read
      questions:
      - Which mappings control how users sync out to Google Workspace?
      - Can I filter Google Workspace provisioning mappings by expression or managed status?
      instructions:
      - text: List my Google Workspace provider mappings.
      - text: Find Google Workspace provisioning mappings named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/google_workspace/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Google Workspace provider mapping
      effect: write
      questions:
      - How do I add a custom attribute mapping for provisioning users into Google Workspace?
      - Can I write my own expression to shape the Google Workspace user payload?
      instructions:
      - text: Create a Google Workspace provider mapping {name} with expression {expression}.
        slots:
          name: requestBody.name
          expression: requestBody.expression
      - text: Add a new Google Workspace provisioning mapping called {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/google_workspace/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Google Workspace provider mapping
      effect: read
      questions:
      - What does a specific Google Workspace provisioning mapping send?
      - Is this Google Workspace mapping one of the built-in managed ones?
      instructions:
      - text: Show Google Workspace provider mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Get the expression behind Google Workspace mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/google_workspace/{pm_uuid}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a Google Workspace provider mapping
      effect: write
      questions:
      - How do I fully overwrite a Google Workspace provisioning mapping?
      - Can I resubmit the whole definition of a Google Workspace mapping in one go?
      instructions:
      - text: Replace Google Workspace mapping {mapping_id} with name {name} and expression {expression}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
          expression: requestBody.expression
      - text: Overwrite the full Google Workspace provider mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/google_workspace/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Google Workspace provider mapping
      effect: destructive
      questions:
      - How do I get rid of a Google Workspace provisioning mapping?
      - Can I delete a custom mapping from my Google Workspace sync?
      instructions:
      - text: Delete Google Workspace provider mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove the Google Workspace sync mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/google_workspace/{pm_uuid}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of a Google Workspace provider mapping
      effect: write
      questions:
      - Can I tweak only the expression of a Google Workspace mapping?
      - Is there a way to rename a Google Workspace provisioning mapping without touching its code?
      instructions:
      - text: Update just the expression of Google Workspace mapping {mapping_id} to {expression}.
        slots:
          mapping_id: path.pm_uuid
          expression: requestBody.expression
      - text: Rename Google Workspace mapping {mapping_id} to {name} only.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/google_workspace/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses a Google Workspace provider mapping
      effect: read
      questions:
      - Which Google Workspace providers use this mapping?
      - Is a given Google Workspace mapping safe to delete?
      instructions:
      - text: List what references Google Workspace mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Check which providers depend on Google Workspace mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/microsoft_entra/'].get
  update:
    x-apievangelist-phrasing:
      intent: List Microsoft Entra provider mappings
      effect: read
      questions:
      - Which mappings control how users are provisioned into Microsoft Entra ID?
      - Can I search my Entra provisioning mappings by expression text?
      instructions:
      - text: List my Microsoft Entra provider mappings.
      - text: Find Entra provisioning mappings matching {term}.
        slots:
          term: query.search
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/microsoft_entra/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Microsoft Entra provider mapping
      effect: write
      questions:
      - How do I add a custom attribute mapping for syncing users to Microsoft Entra?
      - Can I define my own expression for the Entra ID user payload?
      instructions:
      - text: Create a Microsoft Entra provider mapping {name} with expression {expression}.
        slots:
          name: requestBody.name
          expression: requestBody.expression
      - text: Add a new Entra ID sync mapping called {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/microsoft_entra/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Microsoft Entra provider mapping
      effect: read
      questions:
      - What does a particular Microsoft Entra provisioning mapping send?
      - Can I read the expression of one Entra ID mapping?
      instructions:
      - text: Show Microsoft Entra provider mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Get the details of Entra mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/microsoft_entra/{pm_uuid}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a Microsoft Entra provider mapping
      effect: write
      questions:
      - How do I fully overwrite a Microsoft Entra provisioning mapping?
      - Can I resend the entire Entra mapping definition to replace it?
      instructions:
      - text: Replace Entra mapping {mapping_id} with name {name} and expression {expression}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
          expression: requestBody.expression
      - text: Overwrite the whole Microsoft Entra provider mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/microsoft_entra/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Microsoft Entra provider mapping
      effect: destructive
      questions:
      - How do I remove a Microsoft Entra provisioning mapping?
      - Can I delete a custom mapping from my Entra ID sync?
      instructions:
      - text: Delete Microsoft Entra provider mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove the Entra ID sync mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/microsoft_entra/{pm_uuid}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of a Microsoft Entra provider mapping
      effect: write
      questions:
      - Can I change only the expression of an Entra provisioning mapping?
      - Is it possible to rename a Microsoft Entra mapping and leave its code alone?
      instructions:
      - text: Update just the expression of Entra mapping {mapping_id} to {expression}.
        slots:
          mapping_id: path.pm_uuid
          expression: requestBody.expression
      - text: Rename Microsoft Entra mapping {mapping_id} to {name} only.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/microsoft_entra/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses a Microsoft Entra provider mapping
      effect: read
      questions:
      - Which Microsoft Entra providers use this mapping?
      - Is a given Entra mapping still referenced before I delete it?
      instructions:
      - text: List what references Entra mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Check which providers depend on Microsoft Entra mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/rac/'].get
  update:
    x-apievangelist-phrasing:
      intent: List RAC remote access property mappings
      effect: read
      questions:
      - Which property mappings configure my remote access (RAC) connections?
      - Can I list only the managed RAC mappings?
      instructions:
      - text: List my RAC property mappings.
      - text: Find RAC remote access mappings named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/rac/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a RAC remote access property mapping
      effect: write
      questions:
      - How do I set static connection settings for remote access endpoints with a mapping?
      - Can a new RAC mapping combine static settings with an optional expression?
      instructions:
      - text: Create a RAC property mapping {name} with static settings {static_settings}.
        slots:
          name: requestBody.name
          static_settings: requestBody.static_settings
      - text: Add RAC mapping {name} using settings {static_settings} and expression {expression}.
        slots:
          name: requestBody.name
          static_settings: requestBody.static_settings
          expression: requestBody.expression
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/rac/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a RAC remote access property mapping
      effect: read
      questions:
      - What static settings does a particular RAC mapping apply to connections?
      - Can I view a single remote access property mapping?
      instructions:
      - text: Show RAC property mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Get the static settings of RAC mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/rac/{pm_uuid}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a RAC remote access property mapping
      effect: write
      questions:
      - How do I overwrite a RAC mapping's name and static settings together?
      - Can I resubmit a full remote access mapping definition to replace it?
      instructions:
      - text: Replace RAC mapping {mapping_id} with name {name} and static settings {static_settings}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
          static_settings: requestBody.static_settings
      - text: Overwrite the whole RAC property mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/rac/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a RAC remote access property mapping
      effect: destructive
      questions:
      - How do I remove a remote access property mapping?
      - Can I delete a RAC mapping I no longer need?
      instructions:
      - text: Delete RAC property mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove the remote access mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/rac/{pm_uuid}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of a RAC remote access property mapping
      effect: write
      questions:
      - Can I change just the static settings on a RAC mapping?
      - Is it possible to update only the expression of a remote access mapping?
      instructions:
      - text: Update only the static settings of RAC mapping {mapping_id} to {static_settings}.
        slots:
          mapping_id: path.pm_uuid
          static_settings: requestBody.static_settings
      - text: Change just the expression on RAC mapping {mapping_id} to {expression}.
        slots:
          mapping_id: path.pm_uuid
          expression: requestBody.expression
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/rac/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses a RAC remote access mapping
      effect: read
      questions:
      - Which RAC providers or endpoints use this property mapping?
      - Is a remote access mapping still attached to anything?
      instructions:
      - text: List what references RAC mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Check which endpoints depend on remote access mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/radius/'].get
  update:
    x-apievangelist-phrasing:
      intent: List RADIUS provider property mappings
      effect: read
      questions:
      - Which property mappings add attributes to my RADIUS responses?
      - Can I filter RADIUS mappings to the non-managed ones I wrote myself?
      instructions:
      - text: List my RADIUS provider property mappings.
      - text: Find RADIUS mappings named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/radius/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a RADIUS provider property mapping
      effect: write
      questions:
      - How do I return custom RADIUS attributes with an expression?
      - Can I add a new property mapping for my RADIUS provider?
      instructions:
      - text: Create a RADIUS property mapping {name} with expression {expression}.
        slots:
          name: requestBody.name
          expression: requestBody.expression
      - text: Add a new RADIUS attribute mapping called {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/radius/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a RADIUS provider property mapping
      effect: read
      questions:
      - What expression does a particular RADIUS mapping evaluate?
      - Can I view one RADIUS provider property mapping?
      instructions:
      - text: Show RADIUS property mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Get the expression of RADIUS mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/radius/{pm_uuid}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a RADIUS provider property mapping
      effect: write
      questions:
      - How do I fully overwrite a RADIUS property mapping?
      - Can I replace the whole definition of a RADIUS attribute mapping?
      instructions:
      - text: Replace RADIUS mapping {mapping_id} with name {name} and expression {expression}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
          expression: requestBody.expression
      - text: Overwrite the whole RADIUS property mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/radius/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a RADIUS provider property mapping
      effect: destructive
      questions:
      - How do I remove a RADIUS attribute mapping?
      - Can I delete a RADIUS property mapping for good?
      instructions:
      - text: Delete RADIUS property mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove the RADIUS attribute mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/radius/{pm_uuid}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of a RADIUS provider property mapping
      effect: write
      questions:
      - Can I change only the expression of a RADIUS mapping?
      - Is it possible to rename a RADIUS property mapping without resending the rest?
      instructions:
      - text: Update just the expression of RADIUS mapping {mapping_id} to {expression}.
        slots:
          mapping_id: path.pm_uuid
          expression: requestBody.expression
      - text: Rename RADIUS mapping {mapping_id} to {name} only.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/radius/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses a RADIUS provider mapping
      effect: read
      questions:
      - Which RADIUS providers use this property mapping?
      - Is a RADIUS attribute mapping still referenced before I remove it?
      instructions:
      - text: List what references RADIUS mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Check which providers depend on RADIUS mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/saml/'].get
  update:
    x-apievangelist-phrasing:
      intent: List SAML provider property mappings
      effect: read
      questions:
      - Which attribute mappings go into the SAML assertions my apps receive?
      - Can I filter SAML provider mappings by SAML attribute name or friendly name?
      instructions:
      - text: List my SAML provider property mappings.
      - text: Find SAML provider mappings that emit attribute {saml_name}.
        slots:
          saml_name: query.saml_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/saml/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a SAML provider property mapping
      effect: write
      questions:
      - How do I add a custom attribute to outgoing SAML assertions?
      - Can I give a new SAML assertion attribute a friendly name too?
      instructions:
      - text: Create a SAML provider mapping {name} that sets attribute {saml_name} to {expression}.
        slots:
          name: requestBody.name
          saml_name: requestBody.saml_name
          expression: requestBody.expression
      - text: Add assertion mapping {name} for SAML attribute {saml_name} with friendly name {friendly_name}.
        slots:
          name: requestBody.name
          saml_name: requestBody.saml_name
          friendly_name: requestBody.friendly_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/saml/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SAML provider property mapping
      effect: read
      questions:
      - Which SAML attribute name does a particular assertion mapping produce?
      - Can I view one SAML provider mapping's expression?
      instructions:
      - text: Show SAML provider mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Get the assertion attribute and expression of SAML provider mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/saml/{pm_uuid}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a SAML provider property mapping
      effect: write
      questions:
      - How do I overwrite an assertion mapping's name, SAML attribute and expression together?
      - Can I fully replace a SAML provider mapping definition?
      instructions:
      - text: Replace SAML provider mapping {mapping_id} with name {name}, attribute {saml_name} and expression {expression}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
          saml_name: requestBody.saml_name
          expression: requestBody.expression
      - text: Overwrite the whole SAML assertion mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/saml/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SAML provider property mapping
      effect: destructive
      questions:
      - How do I stop sending an attribute in SAML assertions by deleting its mapping?
      - Can I remove a SAML provider mapping entirely?
      instructions:
      - text: Delete SAML provider mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove the SAML assertion attribute mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/saml/{pm_uuid}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of a SAML provider property mapping
      effect: write
      questions:
      - Can I change just the friendly name on a SAML assertion mapping?
      - Is it possible to rename the SAML attribute without resending the expression?
      instructions:
      - text: Set only the friendly name of SAML provider mapping {mapping_id} to {friendly_name}.
        slots:
          mapping_id: path.pm_uuid
          friendly_name: requestBody.friendly_name
      - text: Change just the SAML attribute name on mapping {mapping_id} to {saml_name}.
        slots:
          mapping_id: path.pm_uuid
          saml_name: requestBody.saml_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/saml/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses a SAML provider mapping
      effect: read
      questions:
      - Which SAML providers include this assertion mapping?
      - Is a SAML provider mapping still attached to any application?
      instructions:
      - text: List what references SAML provider mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Check which SAML providers depend on assertion mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/scim/'].get
  update:
    x-apievangelist-phrasing:
      intent: List SCIM provider mappings
      effect: read
      questions:
      - Which mappings shape the users and groups I push to apps over SCIM?
      - Can I find outbound SCIM mappings by name?
      instructions:
      - text: List my SCIM provider mappings for outbound provisioning.
      - text: Find SCIM provider mappings named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/scim/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a SCIM provider mapping
      effect: write
      questions:
      - How do I customize the SCIM payload sent when provisioning users to an app?
      - Can I add my own expression for outbound SCIM attributes?
      instructions:
      - text: Create a SCIM provider mapping {name} with expression {expression}.
        slots:
          name: requestBody.name
          expression: requestBody.expression
      - text: Add a new outbound SCIM mapping called {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/scim/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SCIM provider mapping
      effect: read
      questions:
      - What does a particular outbound SCIM mapping send to the app?
      - Can I view one SCIM provider mapping's expression?
      instructions:
      - text: Show SCIM provider mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Get the expression of outbound SCIM mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/scim/{pm_uuid}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a SCIM provider mapping
      effect: write
      questions:
      - How do I fully overwrite an outbound SCIM provisioning mapping?
      - Can I replace the whole SCIM provider mapping definition at once?
      instructions:
      - text: Replace SCIM provider mapping {mapping_id} with name {name} and expression {expression}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
          expression: requestBody.expression
      - text: Overwrite the whole outbound SCIM mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/scim/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SCIM provider mapping
      effect: destructive
      questions:
      - How do I remove an outbound SCIM provisioning mapping?
      - Can I delete a SCIM provider mapping I no longer use?
      instructions:
      - text: Delete SCIM provider mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove the outbound SCIM mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/scim/{pm_uuid}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of a SCIM provider mapping
      effect: write
      questions:
      - Can I change only the expression of an outbound SCIM mapping?
      - Is it possible to rename a SCIM provider mapping and keep its code?
      instructions:
      - text: Update just the expression of SCIM provider mapping {mapping_id} to {expression}.
        slots:
          mapping_id: path.pm_uuid
          expression: requestBody.expression
      - text: Rename outbound SCIM mapping {mapping_id} to {name} only.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/scim/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses a SCIM provider mapping
      effect: read
      questions:
      - Which SCIM providers use this outbound mapping?
      - Is an outbound SCIM mapping still referenced anywhere?
      instructions:
      - text: List what references SCIM provider mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Check which SCIM providers depend on outbound mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/scope/'].get
  update:
    x-apievangelist-phrasing:
      intent: List OAuth2 scope mappings
      effect: read
      questions:
      - Which OAuth2 scopes can my apps request and what claims do they return?
      - Can I filter scope mappings by scope name, like email or profile?
      instructions:
      - text: List my OAuth2 scope mappings.
      - text: Find the scope mapping for scope {scope_name}.
        slots:
          scope_name: query.scope_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/scope/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an OAuth2 scope mapping
      effect: write
      questions:
      - How do I add a custom OAuth2 scope that returns extra claims?
      - Can I give a new scope a description shown to users on consent?
      instructions:
      - text: Create scope mapping {name} for scope {scope_name} returning {expression}.
        slots:
          name: requestBody.name
          scope_name: requestBody.scope_name
          expression: requestBody.expression
      - text: Add OAuth2 scope {scope_name} named {name} with consent description {description}.
        slots:
          scope_name: requestBody.scope_name
          name: requestBody.name
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/scope/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an OAuth2 scope mapping
      effect: read
      questions:
      - What claims does a particular scope mapping add to tokens?
      - Can I view one OAuth2 scope mapping and its description?
      instructions:
      - text: Show scope mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Get the expression and scope name of scope mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/scope/{pm_uuid}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an OAuth2 scope mapping
      effect: write
      questions:
      - How do I overwrite a scope mapping's name, scope and expression together?
      - Can I fully replace an OAuth2 scope mapping definition?
      instructions:
      - text: Replace scope mapping {mapping_id} with name {name}, scope {scope_name} and expression {expression}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
          scope_name: requestBody.scope_name
          expression: requestBody.expression
      - text: Overwrite the whole OAuth2 scope mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/scope/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an OAuth2 scope mapping
      effect: destructive
      questions:
      - How do I remove a custom OAuth2 scope?
      - Can I delete a scope mapping so apps can no longer request it?
      instructions:
      - text: Delete scope mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove the OAuth2 scope mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/scope/{pm_uuid}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of an OAuth2 scope mapping
      effect: write
      questions:
      - Can I change only the consent description of a scope?
      - Is it possible to update a scope mapping's claims expression by itself?
      instructions:
      - text: Set only the description of scope mapping {mapping_id} to {description}.
        slots:
          mapping_id: path.pm_uuid
          description: requestBody.description
      - text: Change just the claims expression of scope mapping {mapping_id} to {expression}.
        slots:
          mapping_id: path.pm_uuid
          expression: requestBody.expression
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/provider/scope/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses an OAuth2 scope mapping
      effect: read
      questions:
      - Which OAuth2 providers offer this scope mapping?
      - Is a scope mapping still used before I delete it?
      instructions:
      - text: List what references scope mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Check which OAuth2 providers depend on scope mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/kerberos/'].get
  update:
    x-apievangelist-phrasing:
      intent: List Kerberos source property mappings
      effect: read
      questions:
      - Which mappings turn Kerberos principals into authentik user attributes?
      - Can I list only the custom Kerberos source mappings, not the managed ones?
      instructions:
      - text: List my Kerberos source property mappings.
      - text: Find Kerberos source mappings named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/kerberos/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Kerberos source property mapping
      effect: write
      questions:
      - What do I need to add a mapping that sets user fields from a Kerberos realm?
      - Can I write my own expression for users imported from Kerberos?
      instructions:
      - text: Create a Kerberos source mapping {name} with expression {expression}.
        slots:
          name: requestBody.name
          expression: requestBody.expression
      - text: Add a new Kerberos attribute mapping called {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/kerberos/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Kerberos source property mapping
      effect: read
      questions:
      - What does a particular Kerberos source mapping set on the user?
      - Can I view one Kerberos mapping's expression?
      instructions:
      - text: Show Kerberos source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Get the expression of Kerberos mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/kerberos/{pm_uuid}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a Kerberos source property mapping
      effect: write
      questions:
      - Can I fully overwrite a Kerberos source mapping's name and expression?
      - Is there a way to resubmit a whole Kerberos mapping to replace it?
      instructions:
      - text: Replace Kerberos mapping {mapping_id} with name {name} and expression {expression}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
          expression: requestBody.expression
      - text: Overwrite the whole Kerberos source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/kerberos/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Kerberos source property mapping
      effect: destructive
      questions:
      - How do I remove a Kerberos source mapping?
      - Can I delete a custom Kerberos attribute mapping?
      instructions:
      - text: Delete Kerberos source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove the Kerberos attribute mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/kerberos/{pm_uuid}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of a Kerberos source property mapping
      effect: write
      questions:
      - Can I change only the expression on a Kerberos mapping?
      - Is renaming a Kerberos source mapping possible without resending its code?
      instructions:
      - text: Update just the expression of Kerberos mapping {mapping_id} to {expression}.
        slots:
          mapping_id: path.pm_uuid
          expression: requestBody.expression
      - text: Rename Kerberos source mapping {mapping_id} to {name} only.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/kerberos/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses a Kerberos source mapping
      effect: read
      questions:
      - Which Kerberos sources use this mapping?
      - Is a Kerberos attribute mapping still referenced by any realm?
      instructions:
      - text: List what references Kerberos mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Check which Kerberos sources depend on mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/ldap/'].get
  update:
    x-apievangelist-phrasing:
      intent: List LDAP source property mappings
      effect: read
      questions:
      - Which mappings copy LDAP directory attributes onto synced users and groups?
      - Can I search my LDAP source mappings, for example for mail or displayName?
      instructions:
      - text: List my LDAP source property mappings.
      - text: Search LDAP source mappings for {term}.
        slots:
          term: query.search
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/ldap/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an LDAP source property mapping
      effect: write
      questions:
      - How do I map a custom LDAP attribute onto users synced from my directory?
      - Can I add an expression-based mapping to my LDAP sync?
      instructions:
      - text: Create an LDAP source mapping {name} with expression {expression}.
        slots:
          name: requestBody.name
          expression: requestBody.expression
      - text: Add a new LDAP attribute mapping called {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/ldap/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an LDAP source property mapping
      effect: read
      questions:
      - Which directory attribute does a particular LDAP mapping read?
      - Can I view one LDAP source mapping in detail?
      instructions:
      - text: Show LDAP source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Get the expression of LDAP mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/ldap/{pm_uuid}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an LDAP source property mapping
      effect: write
      questions:
      - Can I overwrite an LDAP mapping's name and expression in one request?
      - Is it possible to fully replace an LDAP source mapping definition?
      instructions:
      - text: Replace LDAP mapping {mapping_id} with name {name} and expression {expression}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
          expression: requestBody.expression
      - text: Overwrite the whole LDAP source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/ldap/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an LDAP source property mapping
      effect: destructive
      questions:
      - How do I stop syncing an LDAP attribute by deleting its mapping?
      - Can I remove an LDAP source mapping permanently?
      instructions:
      - text: Delete LDAP source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove the LDAP attribute mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/ldap/{pm_uuid}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of an LDAP source property mapping
      effect: write
      questions:
      - Can I change only the expression on an LDAP mapping?
      - Is renaming an LDAP source mapping possible without touching its expression?
      instructions:
      - text: Update just the expression of LDAP mapping {mapping_id} to {expression}.
        slots:
          mapping_id: path.pm_uuid
          expression: requestBody.expression
      - text: Rename LDAP source mapping {mapping_id} to {name} only.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/ldap/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses an LDAP source mapping
      effect: read
      questions:
      - Which LDAP sources use this property mapping?
      - Is an LDAP attribute mapping still in use by any directory sync?
      instructions:
      - text: List what references LDAP mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Check which LDAP sources depend on mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/oauth/'].get
  update:
    x-apievangelist-phrasing:
      intent: List OAuth source property mappings
      effect: read
      questions:
      - Which mappings turn social login profile data into authentik user fields?
      - Can I filter OAuth source mappings by name?
      instructions:
      - text: List my OAuth source property mappings.
      - text: Find OAuth source mappings named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/oauth/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an OAuth source property mapping
      effect: write
      questions:
      - How do I map extra profile fields from an OAuth login source onto users?
      - Can I write an expression for users who sign in through an OAuth source?
      instructions:
      - text: Create an OAuth source mapping {name} with expression {expression}.
        slots:
          name: requestBody.name
          expression: requestBody.expression
      - text: Add a new social login attribute mapping called {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/oauth/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an OAuth source property mapping
      effect: read
      questions:
      - What does a particular OAuth source mapping set from the login profile?
      - Can I view one OAuth source mapping's expression?
      instructions:
      - text: Show OAuth source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Get the expression of social login mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/oauth/{pm_uuid}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace an OAuth source property mapping
      effect: write
      questions:
      - Can I fully overwrite an OAuth source mapping in one call?
      - Is resubmitting the whole OAuth source mapping the way to replace it?
      instructions:
      - text: Replace OAuth source mapping {mapping_id} with name {name} and expression {expression}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
          expression: requestBody.expression
      - text: Overwrite the whole OAuth source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/oauth/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an OAuth source property mapping
      effect: destructive
      questions:
      - How do I remove an OAuth source mapping?
      - Can I delete a social login attribute mapping I no longer need?
      instructions:
      - text: Delete OAuth source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove the social login mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/oauth/{pm_uuid}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of an OAuth source property mapping
      effect: write
      questions:
      - Can I change only the expression on an OAuth source mapping?
      - Is renaming an OAuth source mapping possible without resending its expression?
      instructions:
      - text: Update just the expression of OAuth source mapping {mapping_id} to {expression}.
        slots:
          mapping_id: path.pm_uuid
          expression: requestBody.expression
      - text: Rename OAuth source mapping {mapping_id} to {name} only.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/oauth/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses an OAuth source mapping
      effect: read
      questions:
      - Which OAuth login sources use this mapping?
      - Is a social login mapping still attached to any source?
      instructions:
      - text: List what references OAuth source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Check which OAuth sources depend on mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/plex/'].get
  update:
    x-apievangelist-phrasing:
      intent: List Plex source property mappings
      effect: read
      questions:
      - Which mappings set user fields for people who sign in with Plex?
      - Can I list only my own Plex source mappings, excluding managed ones?
      instructions:
      - text: List my Plex source property mappings.
      - text: Find Plex source mappings named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/plex/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Plex source property mapping
      effect: write
      questions:
      - What does it take to add a mapping for users coming from a Plex source?
      - Can I write a custom expression for Plex sign-ins?
      instructions:
      - text: Create a Plex source mapping {name} with expression {expression}.
        slots:
          name: requestBody.name
          expression: requestBody.expression
      - text: Add a new Plex attribute mapping called {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/plex/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Plex source property mapping
      effect: read
      questions:
      - What does a particular Plex source mapping set on the user?
      - Can I view one Plex mapping's expression?
      instructions:
      - text: Show Plex source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Get the expression of Plex mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/plex/{pm_uuid}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a Plex source property mapping
      effect: write
      questions:
      - Can I fully overwrite a Plex source mapping?
      - Is there a way to replace a Plex mapping's name and expression together?
      instructions:
      - text: Replace Plex mapping {mapping_id} with name {name} and expression {expression}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
          expression: requestBody.expression
      - text: Overwrite the whole Plex source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/plex/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Plex source property mapping
      effect: destructive
      questions:
      - How do I remove a Plex source mapping?
      - Can I delete a Plex attribute mapping for good?
      instructions:
      - text: Delete Plex source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove the Plex attribute mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/plex/{pm_uuid}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of a Plex source property mapping
      effect: write
      questions:
      - Can I change only the expression on a Plex mapping?
      - Is renaming a Plex source mapping possible without resending the rest?
      instructions:
      - text: Update just the expression of Plex mapping {mapping_id} to {expression}.
        slots:
          mapping_id: path.pm_uuid
          expression: requestBody.expression
      - text: Rename Plex source mapping {mapping_id} to {name} only.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/plex/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses a Plex source mapping
      effect: read
      questions:
      - Which Plex sources use this mapping?
      - Is a Plex attribute mapping still referenced anywhere?
      instructions:
      - text: List what references Plex mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Check which Plex sources depend on mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/saml/'].get
  update:
    x-apievangelist-phrasing:
      intent: List SAML source property mappings
      effect: read
      questions:
      - Which mappings read attributes from an upstream identity provider's SAML assertions?
      - Can I filter SAML source mappings by name?
      instructions:
      - text: List my SAML source property mappings.
      - text: Find SAML source mappings named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/saml/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a SAML source property mapping
      effect: write
      questions:
      - How do I map an incoming SAML assertion attribute onto the user who logs in?
      - Can I add an expression for users federated in through a SAML source?
      instructions:
      - text: Create a SAML source mapping {name} with expression {expression}.
        slots:
          name: requestBody.name
          expression: requestBody.expression
      - text: Add a new inbound SAML attribute mapping called {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/saml/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SAML source property mapping
      effect: read
      questions:
      - What does a particular SAML source mapping pull from incoming assertions?
      - Can I view one inbound SAML mapping's expression?
      instructions:
      - text: Show SAML source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Get the expression of inbound SAML mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/saml/{pm_uuid}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a SAML source property mapping
      effect: write
      questions:
      - Can I fully overwrite an inbound SAML source mapping?
      - Is it possible to replace a SAML source mapping's name and expression at once?
      instructions:
      - text: Replace SAML source mapping {mapping_id} with name {name} and expression {expression}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
          expression: requestBody.expression
      - text: Overwrite the whole inbound SAML mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/saml/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SAML source property mapping
      effect: destructive
      questions:
      - How do I remove a SAML source mapping?
      - Can I delete an inbound SAML attribute mapping?
      instructions:
      - text: Delete SAML source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove the inbound SAML attribute mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/saml/{pm_uuid}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of a SAML source property mapping
      effect: write
      questions:
      - Can I change only the expression on an inbound SAML mapping?
      - Is renaming a SAML source mapping possible without resending its expression?
      instructions:
      - text: Update just the expression of SAML source mapping {mapping_id} to {expression}.
        slots:
          mapping_id: path.pm_uuid
          expression: requestBody.expression
      - text: Rename inbound SAML mapping {mapping_id} to {name} only.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/saml/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses a SAML source mapping
      effect: read
      questions:
      - Which SAML sources use this inbound mapping?
      - Is an inbound SAML mapping still attached to a federation source?
      instructions:
      - text: List what references SAML source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Check which SAML sources depend on inbound mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/scim/'].get
  update:
    x-apievangelist-phrasing:
      intent: List SCIM source property mappings
      effect: read
      questions:
      - Which mappings handle users pushed into authentik by an external SCIM client?
      - Can I filter inbound SCIM source mappings by name?
      instructions:
      - text: List my SCIM source property mappings.
      - text: Find inbound SCIM source mappings named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/scim/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a SCIM source property mapping
      effect: write
      questions:
      - How do I map attributes from users provisioned into authentik over SCIM?
      - Can I add an expression for inbound SCIM users and groups?
      instructions:
      - text: Create a SCIM source mapping {name} with expression {expression}.
        slots:
          name: requestBody.name
          expression: requestBody.expression
      - text: Add a new inbound SCIM attribute mapping called {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/scim/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SCIM source property mapping
      effect: read
      questions:
      - What does a particular inbound SCIM mapping set on provisioned users?
      - Can I view one SCIM source mapping's expression?
      instructions:
      - text: Show SCIM source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Get the expression of inbound SCIM mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/scim/{pm_uuid}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a SCIM source property mapping
      effect: write
      questions:
      - Can I fully overwrite an inbound SCIM source mapping?
      - Is it possible to replace a SCIM source mapping's name and expression together?
      instructions:
      - text: Replace SCIM source mapping {mapping_id} with name {name} and expression {expression}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
          expression: requestBody.expression
      - text: Overwrite the whole inbound SCIM mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/scim/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SCIM source property mapping
      effect: destructive
      questions:
      - How do I remove an inbound SCIM source mapping?
      - Can I delete a SCIM source attribute mapping?
      instructions:
      - text: Delete SCIM source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove the inbound SCIM attribute mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/scim/{pm_uuid}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of a SCIM source property mapping
      effect: write
      questions:
      - Can I change only the expression on an inbound SCIM mapping?
      - Is renaming a SCIM source mapping possible without resending its code?
      instructions:
      - text: Update just the expression of SCIM source mapping {mapping_id} to {expression}.
        slots:
          mapping_id: path.pm_uuid
          expression: requestBody.expression
      - text: Rename inbound SCIM mapping {mapping_id} to {name} only.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/scim/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses a SCIM source mapping
      effect: read
      questions:
      - Which SCIM sources use this inbound mapping?
      - Is an inbound SCIM mapping still referenced before I remove it?
      instructions:
      - text: List what references SCIM source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Check which SCIM sources depend on inbound mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/telegram/'].get
  update:
    x-apievangelist-phrasing:
      intent: List Telegram source property mappings
      effect: read
      questions:
      - Which mappings set user fields for people who log in with Telegram?
      - Can I list only non-managed Telegram source mappings?
      instructions:
      - text: List my Telegram source property mappings.
      - text: Find Telegram source mappings named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/telegram/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Telegram source property mapping
      effect: write
      questions:
      - What's needed to add a mapping for users signing in through Telegram?
      - Can I write my own expression for Telegram login data?
      instructions:
      - text: Create a Telegram source mapping {name} with expression {expression}.
        slots:
          name: requestBody.name
          expression: requestBody.expression
      - text: Add a new Telegram attribute mapping called {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/telegram/{pm_uuid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Telegram source property mapping
      effect: read
      questions:
      - What does a particular Telegram source mapping set on the user?
      - Can I view one Telegram mapping's expression?
      instructions:
      - text: Show Telegram source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Get the expression of Telegram mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/telegram/{pm_uuid}/'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a Telegram source property mapping
      effect: write
      questions:
      - Can I fully overwrite a Telegram source mapping?
      - Can one request swap out a Telegram login mapping's name and its expression?
      instructions:
      - text: Replace Telegram mapping {mapping_id} with name {name} and expression {expression}.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
          expression: requestBody.expression
      - text: Overwrite the whole Telegram source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/telegram/{pm_uuid}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Telegram source property mapping
      effect: destructive
      questions:
      - How do I remove a Telegram source mapping?
      - Can I delete a Telegram attribute mapping for good?
      instructions:
      - text: Delete Telegram source mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Remove the Telegram attribute mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/telegram/{pm_uuid}/'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit part of a Telegram source property mapping
      effect: write
      questions:
      - Can I change only the expression on a Telegram mapping?
      - Is renaming a Telegram source mapping possible without resending the rest?
      instructions:
      - text: Update just the expression of Telegram mapping {mapping_id} to {expression}.
        slots:
          mapping_id: path.pm_uuid
          expression: requestBody.expression
      - text: Rename Telegram source mapping {mapping_id} to {name} only.
        slots:
          mapping_id: path.pm_uuid
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/propertymappings/source/telegram/{pm_uuid}/used_by/'].get
  update:
    x-apievangelist-phrasing:
      intent: See what uses a Telegram source mapping
      effect: read
      questions:
      - Which Telegram sources use this mapping?
      - Is a Telegram attribute mapping still referenced anywhere?
      instructions:
      - text: List what references Telegram mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      - text: Check which Telegram sources depend on mapping {mapping_id}.
        slots:
          mapping_id: path.pm_uuid
      method: generated
      generated: '2026-09-26'