Skip to content
ver .md original

Usuários

Consulte o diretório da organização, obtenha perfis de usuário e atualize metadados. Aceita tanto chaves de API quanto tokens Bearer da CLI.

GET/v1/me/Chave de APICLI AuthOAuth 2.0

Current authenticated identity

Returns the current authenticated user (or agent identity for API-Key requests). Supports include_email query.

Parâmetros de consulta

NomeTipoObrigatórioDescrição
include_emailbooleanOpcionalInclude email in response. Default false.

Erros

StatusQuando
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
curl -sS -X GET 'https://api.dailybot.com/v1/me/' -H 'X-API-KEY: $DAILYBOT_API_KEY'

Testar

Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.

GET/v1/users/Chave de APICLI AuthPaginação por número de página

List organization members

Paginated list of users. Supports search, only_active, include_email.

Parâmetros de consulta

NomeTipoObrigatórioDescrição
searchstringOpcionalFilter by name, email, or external ID (case-insensitive).
only_activebooleanOpcionalIf set, return only active users.
include_emailbooleanOpcionalInclude email in each user object.
pageintegerOpcionalPage number (page-number pagination).
page_sizeintegerOpcionalPage size (default 20, max 100).

Erros

StatusQuando
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
curl -sS -X GET 'https://api.dailybot.com/v1/users/' -H 'X-API-KEY: $DAILYBOT_API_KEY'

Testar

Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.

GET/v1/users/{uuid}/Chave de APICLI Auth

Retrieve a user by UUID

Retrieves a single user by their UUID.

Parâmetros de rota

NomeTipoObrigatórioDescrição
uuidstring (uuid)Obrigatório

Parâmetros de consulta

NomeTipoObrigatórioDescrição
include_emailbooleanOpcional

Erros

StatusQuando
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
404Not found or not visible
curl -sS -X GET 'https://api.dailybot.com/v1/users/{uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'

Testar

Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.

PATCH/v1/users/{uuid}/Chave de APICLI Auth

Update a user

Partially update a user profile.

Parâmetros de rota

NomeTipoObrigatórioDescrição
uuidstring (uuid)Obrigatório

Erros

StatusQuando
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
400Validation error
404Not found or not visible
curl -sS -X PATCH 'https://api.dailybot.com/v1/users/{uuid}/' -H 'X-API-KEY: $DAILYBOT_API_KEY'

Testar

Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.

PATCH/v1/users/{uuid}/update-metadata/Chave de APICLI Auth

Update user metadata

Merge arbitrary key/value metadata onto a user.

Parâmetros de rota

NomeTipoObrigatórioDescrição
uuidstring (uuid)Obrigatório

Erros

StatusQuando
401Missing/invalid/expired credential
403Authenticated but not permitted
429Throttled - Retry-After header set
400Validation error
404Not found or not visible
curl -sS -X PATCH 'https://api.dailybot.com/v1/users/{uuid}/update-metadata/' -H 'X-API-KEY: $DAILYBOT_API_KEY'

Testar

Este é um ajudante apenas de cópia — a requisição não é enviada do seu navegador. Cole o comando no seu terminal para executá-lo.

Usuários e Organização

Gerencie usuários, obtenha informações de contexto (/me), recupere detalhes da organização, atualize perfis e metadados, e convide membros.

Resumo de endpoints

Método Endpoint Descrição
GET /v1/me/ Informações do usuário autenticado + organização
GET /v1/organization/ Detalhes da organização
GET /v1/users/ Listar todos os usuários
GET /v1/users/{uuid}/ Obter um usuário específico
PATCH /v1/users/{uuid}/ Atualizar um usuário
POST /v1/invite-user/ Convidar um usuário (ver API de Convites)

GET /v1/users/

Retorna todos os usuários da organização. Paginado (ordenação padrão: full_name).

Parâmetros de query

Nome Tipo Padrão Descrição
page integer 1 Número de página. offset aceito como alias.
page_size integer 50 Itens por página (máx. 200). limit aceito como alias.
search string Busca sem distinção de maiúsculas em nome completo ou e-mail (máx. 256 chars).
is_active boolean Filtrar por status ativo.
role string Filtrar por papel: admin ou member.
curl "https://api.dailybot.com/v1/users/?is_active=true&search=alice&page_size=50" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

Resposta (200 OK):

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "usr_abc123",
      "email": "alice@empresa.com.br",
      "first_name": "Alice",
      "last_name": "Silva",
      "role": "member",
      "is_active": true,
      "timezone": "America/Sao_Paulo"
    }
  ]
}

PATCH /v1/users/{uuid}/

Atualiza o perfil ou metadados de um usuário. Apenas Administradores da Organização podem atualizar outros usuários.

Parâmetros do body

Nome Tipo Obrigatório Descrição
first_name string Não Nome do usuário.
last_name string Não Sobrenome do usuário.
timezone string Não Fuso horário IANA (ex. America/Sao_Paulo).
metadata object Não Metadados chave-valor personalizados do usuário.