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

# Read operator profile

> Returns the authenticated operator's own document — name, photo, phone,
roles and notification settings.

The operator token only carries the id, the e-mail and the roles, so this is
where the rest of the profile comes from. It takes no parameters: the
identity is the scope, and there is deliberately no way to ask for another
operator's record here.

`operatorPassword` and `operatorToken` are never returned, and
`operatorPhoto` comes back resolved through the storage service, never as
the stored address: a legacy bucket address becomes its cdn URL. A storage
failure degrades the photo link, never the response.



## OpenAPI

````yaml /api/services-api.yaml get /v1/operators/me
openapi: 3.0.3
info:
  description: >-
    Talqui is an omnichannel customer service platform that unifies
    conversations from WhatsApp, Instagram, Telegram, and many other channels
    into a single attendant panel, alongside a broader ecosystem of plugins and
    integrations. This API gives developers programmatic access to Talqui's
    services layer, exposing the operations needed to read and manage tenants,
    conversations, plugins, and related resources that power that platform.


    Authentication is available on behalf of an Operator (the default for this
    API), a Plugin Connection, or a Plugin — see the [Talqui authentication
    guide](https://docs.talqui.chat/guides/introduction/authentication/) for how
    each token is obtained and when to use it.


    Need help or have questions not covered here? Reach out to
    support@talqui.com.
  license:
    name: ISC
    url: https://opensource.org/license/isc-license-txt
  title: Talqui - Services API
  version: 0.65.0
servers:
  - description: Production
    url: https://services-api.talqui.chat
security: []
tags:
  - name: Tenants
  - name: Settings
  - name: Analytics
  - name: Campaigns
  - name: Campaigns models
  - name: Contacts
  - name: Handoff links
  - name: Inboxes
  - name: Messages
  - name: Notifications
  - name: Sessions
  - name: Operators
  - name: Plugins
  - name: Setup
  - name: Uploads
paths:
  /v1/operators/me:
    get:
      tags:
        - Operators
      summary: Read operator profile
      description: >-
        Returns the authenticated operator's own document — name, photo, phone,

        roles and notification settings.


        The operator token only carries the id, the e-mail and the roles, so
        this is

        where the rest of the profile comes from. It takes no parameters: the

        identity is the scope, and there is deliberately no way to ask for
        another

        operator's record here.


        `operatorPassword` and `operatorToken` are never returned, and

        `operatorPhoto` comes back resolved through the storage service, never
        as

        the stored address: a legacy bucket address becomes its cdn URL. A
        storage

        failure degrades the photo link, never the response.
      operationId: ReadOperatorProfileController
      parameters: []
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  data:
                    additionalProperties: false
                    properties:
                      operator:
                        additionalProperties: false
                        description: The authenticated operator.
                        properties:
                          createdAt:
                            description: When the operator was created.
                            format: date-time
                            type: string
                          lastSignInAt:
                            description: When the operator last signed in.
                            format: date-time
                            nullable: true
                            type: string
                          lastTenantID:
                            description: The tenant the operator was last working in.
                            nullable: true
                            type: string
                          operatorEmail:
                            description: E-mail address (also the login identifier).
                            type: string
                          operatorFirstname:
                            description: Given name.
                            type: string
                          operatorID:
                            description: The operator identifier.
                            type: string
                          operatorLastname:
                            description: Family name.
                            type: string
                          operatorMeta:
                            additionalProperties: {}
                            description: Arbitrary metadata attached to the operator.
                            type: object
                          operatorPhone:
                            description: Phone number, when set.
                            nullable: true
                            type: string
                          operatorPhoto:
                            description: Avatar URL, when set.
                            nullable: true
                            type: string
                          operatorRoles:
                            description: Platform-wide roles, e.g. `superuser`.
                            items:
                              type: string
                            type: array
                          operatorSettings:
                            additionalProperties: false
                            description: Notification preferences and push tokens.
                            properties:
                              notificationSettings:
                                additionalProperties: false
                                properties:
                                  allDisabled:
                                    description: >-
                                      Master switch — silences every
                                      notification for this operator.
                                    type: boolean
                                  allowSounds:
                                    description: >-
                                      Whether the web app may play a
                                      notification sound.
                                    type: boolean
                                  onMessageInbound:
                                    description: Notify on an inbound message.
                                    type: boolean
                                  onOperatorMentioned:
                                    description: Notify when mentioned in an internal note.
                                    type: boolean
                                  onSessionCreated:
                                    description: Notify when a session is opened.
                                    type: boolean
                                  onSessionQueued:
                                    description: Notify when a session enters the queue.
                                    type: boolean
                                  tokens:
                                    additionalProperties: false
                                    description: Push tokens registered per platform.
                                    properties:
                                      mobile:
                                        description: >-
                                          FCM token of the mobile app, when one is
                                          registered.
                                        nullable: true
                                        type: string
                                      web:
                                        description: >-
                                          FCM token of the browser session, when
                                          one is registered.
                                        nullable: true
                                        type: string
                                    required:
                                      - web
                                      - mobile
                                    type: object
                                required:
                                  - allDisabled
                                  - onSessionCreated
                                  - onSessionQueued
                                  - onMessageInbound
                                  - allowSounds
                                  - tokens
                                type: object
                            required:
                              - notificationSettings
                            type: object
                          organizationID:
                            description: The Talqui organization this operator belongs to.
                            type: string
                          updatedAt:
                            description: When the operator was last updated.
                            format: date-time
                            type: string
                        required:
                          - operatorID
                          - operatorFirstname
                          - operatorLastname
                          - operatorPhoto
                          - operatorPhone
                          - operatorEmail
                          - operatorRoles
                          - operatorMeta
                          - lastSignInAt
                          - lastTenantID
                          - createdAt
                          - updatedAt
                        type: object
                    required:
                      - operator
                    type: object
                required:
                  - data
                type: object
          description: Response for status 200.
        '400':
          content:
            application/json:
              schema:
                properties:
                  errors:
                    items:
                      $ref: '#/components/schemas/MissingOperatorIDError'
                    maxItems: 1
                    minItems: 1
                    type: array
                required:
                  - errors
                type: object
          description: >-
            MissingOperatorIDError (error_code 1063): the resolved identity
            carries no operatorID.
        '401':
          content:
            application/json:
              schema:
                properties:
                  errors:
                    items:
                      $ref: '#/components/schemas/UnauthorizedError'
                    maxItems: 1
                    minItems: 1
                    type: array
                required:
                  - errors
                type: object
          description: 'UnauthorizedError (error_code 1003): missing/invalid operator token.'
        '404':
          content:
            application/json:
              schema:
                properties:
                  errors:
                    items:
                      $ref: '#/components/schemas/OperatorNotFoundError'
                    maxItems: 1
                    minItems: 1
                    type: array
                required:
                  - errors
                type: object
          description: >-
            OperatorNotFoundError (error_code 1064): the operator no longer
            exists.
        '500':
          content:
            application/json:
              schema:
                properties:
                  errors:
                    items:
                      $ref: '#/components/schemas/UnknownError'
                    maxItems: 1
                    minItems: 1
                    type: array
                required:
                  - errors
                type: object
          description: >-
            UnknownError (error_code 5999): Unexpected internal error not
            otherwise documented for this endpoint.
components:
  schemas:
    MissingOperatorIDError:
      additionalProperties: false
      properties:
        error:
          enum:
            - MissingOperatorIDError
          type: string
        error_code:
          enum:
            - 1063
          type: number
        message:
          example: operatorID is required.
          type: string
        statusCode:
          enum:
            - 400
          type: number
      required:
        - statusCode
        - error
        - error_code
        - message
      type: object
    UnauthorizedError:
      additionalProperties: false
      properties:
        error:
          enum:
            - UnauthorizedError
          type: string
        error_code:
          enum:
            - 1003
          type: number
        message:
          example: You are not authorized to perform this request.
          type: string
        statusCode:
          enum:
            - 401
          type: number
      required:
        - statusCode
        - error
        - error_code
        - message
      type: object
    OperatorNotFoundError:
      additionalProperties: false
      properties:
        error:
          enum:
            - OperatorNotFoundError
          type: string
        error_code:
          enum:
            - 1064
          type: number
        message:
          example: Operator not found.
          type: string
        statusCode:
          enum:
            - 404
          type: number
      required:
        - statusCode
        - error
        - error_code
        - message
      type: object
    UnknownError:
      additionalProperties: false
      properties:
        error:
          enum:
            - UnknownError
          type: string
        error_code:
          enum:
            - 5999
          type: number
        message:
          example: For some unknown reason your request has not succeeded.
          type: string
        statusCode:
          enum:
            - 500
          type: number
      required:
        - statusCode
        - error
        - error_code
        - message
      type: object

````

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