# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for SCIM 2.0 User Management System Operations API
  version: 1.0.0
extends: openapi/vendasta-system-operations-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: 6
- target: $.paths['/{namespace}/ResourceTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List SCIM resource types supported
      effect: read
      questions:
      - Which SCIM resource types, like Users or Groups, does the platform support?
      - What resource types can I provision through the SCIM service?
      instructions:
      - text: List every SCIM resource type available in namespace {namespace}.
        slots:
          namespace: path.namespace
      - text: Show supported resource types for {namespace}, including only {attributes}.
        slots:
          namespace: path.namespace
          attributes: query.attributes
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{namespace}/ResourceTypes/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one SCIM resource type
      effect: read
      questions:
      - What endpoint and schema back the SCIM User resource type?
      - Can I inspect the definition of a single resource type by name?
      instructions:
      - text: Get resource type {id} in namespace {namespace}.
        slots:
          id: path.id
          namespace: path.namespace
      - text: Describe the SCIM resource type {id} for {namespace}.
        slots:
          id: path.id
          namespace: path.namespace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{namespace}/Schemas'].get
  update:
    x-apievangelist-phrasing:
      intent: List SCIM schemas
      effect: read
      questions:
      - Which data schemas can SCIM resource types use here?
      - Where can I see all attribute schemas the SCIM service defines?
      instructions:
      - text: List all SCIM schemas for namespace {namespace}.
        slots:
          namespace: path.namespace
      - text: Show schemas in {namespace} excluding attributes {excludedAttributes}.
        slots:
          namespace: path.namespace
          excludedAttributes: query.excludedAttributes
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{namespace}/Schemas/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one SCIM schema
      effect: read
      questions:
      - What attributes does the core User schema define?
      - Can I fetch one schema definition by its URN?
      instructions:
      - text: Get schema {id} in namespace {namespace}.
        slots:
          id: path.id
          namespace: path.namespace
      - text: Show the attribute definitions of SCIM schema {id} for {namespace}.
        slots:
          id: path.id
          namespace: path.namespace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{namespace}/ServiceProviderConfig'].get
  update:
    x-apievangelist-phrasing:
      intent: Get SCIM feature support config
      effect: read
      questions:
      - Which SCIM features, such as patch, filter or sort, does Vendasta support?
      - Does the SCIM service advertise its supported capabilities somewhere?
      instructions:
      - text: Get the service provider configuration for namespace {namespace}.
        slots:
          namespace: path.namespace
      - text: Tell me which SCIM features are enabled for {namespace}.
        slots:
          namespace: path.namespace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{namespace}/Bulk'].get
  update:
    x-apievangelist-phrasing:
      intent: Check SCIM bulk operation support
      effect: read
      questions:
      - Can I run many SCIM operations at once with a bulk request?
      - Is the optional SCIM Bulk endpoint supported yet?
      instructions:
      - text: Call the SCIM Bulk endpoint for namespace {namespace}.
        slots:
          namespace: path.namespace
      - text: Check whether bulk actions work in {namespace}.
        slots:
          namespace: path.namespace
      method: generated
      generated: '2026-10-01'