# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Postman SCIM API
  version: 1.0.0
extends: openapi/postman-scim-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: 12
- target: $.paths['/scim/v2/Groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List SCIM groups
      effect: read
      questions:
      - Which user groups has my identity provider provisioned in Postman over SCIM?
      - Can I filter SCIM groups by display name?
      instructions:
      - text: List all SCIM groups in my Postman team.
      - text: Find SCIM groups matching the filter {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/scim/v2/Groups'].post
  update:
    x-apievangelist-phrasing:
      intent: Provision a group via SCIM
      effect: write
      questions:
      - How do I provision a new user group and its members through SCIM?
      - Does creating a SCIM group also create accounts for members who don't have one?
      instructions:
      - text: Create a SCIM group named {displayName}.
        slots:
          displayName: requestBody.displayName
      - text: Provision group {displayName} with members {members}.
        slots:
          displayName: requestBody.displayName
          members: requestBody.members
      method: generated
      generated: '2026-09-26'
- target: $.paths['/scim/v2/Groups/{groupId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SCIM group
      effect: read
      questions:
      - Who is in a particular SCIM-provisioned group?
      - Can I look up one SCIM group by its ID?
      instructions:
      - text: Get SCIM group {groupId}.
        slots:
          groupId: path.groupId
      - text: Show the members of SCIM group {groupId}.
        slots:
          groupId: path.groupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/scim/v2/Groups/{groupId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SCIM group
      effect: destructive
      questions:
      - What happens to member accounts when I delete a SCIM group?
      - How do I deprovision a whole group from Postman?
      instructions:
      - text: Delete SCIM group {groupId}.
        slots:
          groupId: path.groupId
      - text: Deprovision group {groupId} from the team.
        slots:
          groupId: path.groupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/scim/v2/Groups/{groupId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a SCIM group or change its members
      effect: write
      questions:
      - How do I add or remove members from a SCIM group?
      - Can I rename a group through SCIM PATCH operations?
      instructions:
      - text: 'Apply these SCIM operations to group {groupId}: {Operations}.'
        slots:
          groupId: path.groupId
          Operations: requestBody.Operations
      - text: Update the membership of SCIM group {groupId}.
        slots:
          groupId: path.groupId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/scim/v2/ResourceTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List supported SCIM resource types
      effect: read
      questions:
      - Which SCIM resource types does Postman support?
      - Are both Users and Groups available as SCIM resources?
      instructions:
      - text: List the SCIM resource types supported by the team.
      - text: Show the SCIM schema resource types available.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/scim/v2/ServiceProviderConfig'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the SCIM service provider config
      effect: read
      questions:
      - Which SCIM operations like PATCH, filtering or bulk are supported?
      - What does the SCIM service provider configuration say about authentication?
      instructions:
      - text: Get the SCIM service provider configuration.
      - text: Show which SCIM features the service provider supports.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/scim/v2/Users'].get
  update:
    x-apievangelist-phrasing:
      intent: List SCIM users
      effect: read
      questions:
      - Which team members are provisioned through SCIM?
      - Can I find a SCIM user by their userName with a filter?
      instructions:
      - text: List all SCIM users on the team.
      - text: Find SCIM users matching {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/scim/v2/Users'].post
  update:
    x-apievangelist-phrasing:
      intent: Provision a user via SCIM
      effect: write
      questions:
      - How do I provision a new team member through SCIM?
      - What happens if the email I provision over SCIM already has an account?
      instructions:
      - text: Provision a SCIM user with username {userName}.
        slots:
          userName: requestBody.userName
      - text: Create SCIM user {userName} with external ID {externalId}.
        slots:
          userName: requestBody.userName
          externalId: requestBody.externalId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/scim/v2/Users/{userId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SCIM user
      effect: read
      questions:
      - Is a specific team member active according to SCIM?
      - Can I look up one SCIM user's details by ID?
      instructions:
      - text: Get SCIM user {userId}.
        slots:
          userId: path.userId
      - text: Show the SCIM record for team member {userId}.
        slots:
          userId: path.userId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/scim/v2/Users/{userId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a SCIM user's attributes
      effect: write
      questions:
      - How do I replace a user's name and active flag with a full SCIM PUT?
      - Can I reactivate a deactivated account by setting active to true in a full update?
      instructions:
      - text: Replace SCIM user {userId}'s name with {name} using a full update.
        slots:
          userId: path.userId
          name: requestBody.name
      - text: Set active to {active} on SCIM user {userId} with a PUT.
        slots:
          active: requestBody.active
          userId: path.userId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/scim/v2/Users/{userId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a SCIM user, e.g. deactivate
      effect: write
      questions:
      - How do I deactivate a single team member with a SCIM PATCH operation?
      - Can I change just one attribute of a SCIM user without sending the whole record?
      instructions:
      - text: Patch SCIM user {userId} to deactivate the account.
        slots:
          userId: path.userId
      - text: Apply a partial SCIM PATCH to user {userId}.
        slots:
          userId: path.userId
      method: generated
      generated: '2026-09-26'