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

# Listar usuários

> Lista todos os usuários do escritório do solicitante, com busca por nome ou e-mail e filtro por papel. Informe `inboxId` para filtrar por uma inbox (workspace) específica. Use `page` e `limit` para paginar.



## OpenAPI

````yaml https://api.jurichat.com/docs/client/openapi.json get /user/
openapi: 3.1.0
info:
  title: JuriChat API — Documentação para Integradores
  description: ''
  version: 1.0.0
servers:
  - url: https://api.jurichat.com
    description: Production server
security:
  - apiKeyAuth: []
tags: []
paths:
  /user/:
    get:
      tags:
        - Users
      summary: Listar usuários
      description: >-
        Lista todos os usuários do escritório do solicitante, com busca por nome
        ou e-mail e filtro por papel. Informe `inboxId` para filtrar por uma
        inbox (workspace) específica. Use `page` e `limit` para paginar.
      parameters:
        - schema:
            anyOf:
              - type: string
              - type: number
          in: query
          name: page
          required: false
          description: Número da página.
        - schema:
            anyOf:
              - type: string
              - type: number
          in: query
          name: limit
          required: false
          description: Quantidade de itens por página.
        - schema:
            type: string
            pattern: ^[cC][^\s-]{8,}$
          in: query
          name: inboxId
          required: false
          description: >-
            ID da inbox (workspace). Filtro opcional: quando informado, lista
            apenas usuários vinculados a essa inbox.
        - schema:
            type: string
          in: query
          name: search
          required: false
          description: Busca por nome ou e-mail (correspondência parcial).
        - schema:
            type: string
            pattern: ^[cC][^\s-]{8,}$
          in: query
          name: roleId
          required: false
          description: Filtra usuários pelo ID do papel (role).
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          pattern: ^[cC][^\s-]{8,}$
                          description: ID do usuário.
                        name:
                          type: string
                          description: Nome do usuário.
                        email:
                          type: string
                          description: E-mail de acesso.
                        departments:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                description: ID do departamento.
                              name:
                                type: string
                                description: Nome do departamento.
                            required:
                              - id
                              - name
                            additionalProperties: false
                          description: Departamentos vinculados ao usuário.
                        contact:
                          type: string
                          description: Telefone ou WhatsApp cadastrado.
                        imageUrl:
                          type: string
                          nullable: true
                          description: URL de avatar. Null se não definido.
                        notificationSound:
                          type: string
                          description: Arquivo de som de notificação.
                        officeId:
                          type: string
                          description: ID do escritório ao qual o usuário pertence.
                        roleId:
                          type: string
                          description: ID do papel atribuído ao usuário.
                        createdAt:
                          type: string
                          format: date-time
                          description: Data e hora de criação.
                        role:
                          type: object
                          properties:
                            id:
                              type: string
                              description: ID do papel.
                            name:
                              type: string
                              description: Nome do papel.
                          required:
                            - id
                            - name
                          additionalProperties: false
                          description: Papel atribuído ao usuário.
                        office:
                          type: object
                          properties:
                            id:
                              type: string
                              description: ID do escritório.
                            name:
                              type: string
                              description: Nome do escritório.
                          required:
                            - id
                            - name
                          additionalProperties: false
                          description: Escritório ao qual o usuário pertence.
                        inboxes:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                description: ID da inbox.
                              name:
                                type: string
                                description: Nome da inbox.
                            required:
                              - id
                              - name
                            additionalProperties: false
                          nullable: true
                          description: Inboxes vinculadas ao usuário. Null se não houver.
                        lastInboxUsed:
                          type: string
                          nullable: true
                          description: ID da última inbox utilizada. Null se não houver.
                        onlyAssignedConversations:
                          type: boolean
                          description: >-
                            Quando verdadeiro, o usuário visualiza apenas
                            conversas atribuídas a ele.
                        userCanEdit:
                          type: boolean
                          description: >-
                            Indica se o solicitante pode editar este usuário.
                            Gestor pode editar todos; não-gestor não pode editar
                            usuários Gestores.
                        hasGoogleLinked:
                          type: boolean
                          description: Possui conta Google vinculada.
                        googleEmail:
                          type: string
                          nullable: true
                          description: >-
                            E-mail da conta Google vinculada. Null se não
                            houver.
                        hasPassword:
                          type: boolean
                          description: Possui senha cadastrada.
                      required:
                        - id
                        - name
                        - email
                        - departments
                        - contact
                        - imageUrl
                        - notificationSound
                        - officeId
                        - roleId
                        - createdAt
                        - role
                        - office
                        - inboxes
                        - lastInboxUsed
                        - onlyAssignedConversations
                        - userCanEdit
                        - hasGoogleLinked
                        - googleEmail
                        - hasPassword
                      additionalProperties: false
                    description: Usuários da página atual.
                  totalResults:
                    type: number
                    description: Total de registros encontrados.
                  totalPages:
                    type: number
                    description: Total de páginas para a quantidade solicitada.
                required:
                  - data
                  - totalResults
                  - totalPages
                additionalProperties: false
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  details: {}
                required:
                  - message
                  - statusCode
                additionalProperties: false
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-jurichat-api-key
      description: >-
        Chave de API do escritório (criada no painel). Envie o valor no header
        x-jurichat-api-key.

````