> ## Documentation Index
> Fetch the complete documentation index at: https://docs.visitoai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List staff available for conversation assignment

> Use to discover active staff/operator IDs for conversation or review assignment. These are business team accounts, not guest contacts or WhatsApp recipients. To find a guest by name, use list_conversations with contactQuery and channel, then check participant.displayName and participant.phone. Requires conversations:assignment:read.



## OpenAPI

````yaml /openapi.json get /conversations/assignable-operators
openapi: 3.0.3
info:
  title: Visito M2M API
  version: 1.0.0
  description: >-
    Tenant-scoped server-to-server API for channels, conversations, commerce,
    custom AI tools, and WhatsApp templates. Send operations are asynchronous
    and return queued acknowledgements. Expansion adds conversation controls,
    knowledge, sales opportunities, delivery status, reporting, and signed
    webhooks.
servers:
  - url: https://platform-api.visitoai.com/m2m/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Channels
  - name: Conversations
  - name: Commerce
  - name: Custom tools
  - name: WhatsApp templates
  - name: Properties
  - name: Knowledge
  - name: Sales CRM
  - name: Delivery
  - name: Reporting
  - name: Webhooks
paths:
  /conversations/assignable-operators:
    get:
      tags:
        - Conversations
      summary: List staff available for conversation assignment
      description: >-
        Use to discover active staff/operator IDs for conversation or review
        assignment. These are business team accounts, not guest contacts or
        WhatsApp recipients. To find a guest by name, use list_conversations
        with contactQuery and channel, then check participant.displayName and
        participant.phone. Requires conversations:assignment:read.
      operationId: m2mGetConversationsAssignableOperators
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssignableOperators'
        default:
          $ref: '#/components/responses/Error'
components:
  schemas:
    AssignableOperators:
      type: object
      properties:
        operators:
          type: array
          items:
            type: object
            required:
              - operatorId
              - displayName
              - email
              - role
              - active
            properties:
              operatorId:
                type: string
              displayName:
                type: string
              email:
                type: string
                format: email
              role:
                type: string
                enum:
                  - admin
                  - user
              active:
                type: boolean
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              example: M2M_AUTH_INSUFFICIENT_SCOPE
            message:
              type: string
            details:
              type: object
              additionalProperties: true
      example:
        error:
          code: M2M_AUTH_INSUFFICIENT_SCOPE
          message: M2M credential does not have required scope.
          details:
            requiredScopes:
              - conversations:write
            missingScopes:
              - conversations:write
  responses:
    Error:
      description: Structured error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Visito M2M API key
      description: Server-side tenant-scoped credential created from Build > API Keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.