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.
Nesta página
Current authenticated identity
Returns the current authenticated user (or agent identity for API-Key requests). Supports include_email query.
Parâmetros de consulta
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| include_email | boolean | Opcional | Include email in response. Default false. |
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - 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.
List organization members
Paginated list of users. Supports search, only_active, include_email.
Parâmetros de consulta
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| search | string | Opcional | Filter by name, email, or external ID (case-insensitive). |
| only_active | boolean | Opcional | If set, return only active users. |
| include_email | boolean | Opcional | Include email in each user object. |
| page | integer | Opcional | Page number (page-number pagination). |
| page_size | integer | Opcional | Page size (default 20, max 100). |
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - 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.
Retrieve a user by UUID
Retrieves a single user by their UUID.
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| uuid | string (uuid) | Obrigatório | — |
Parâmetros de consulta
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| include_email | boolean | Opcional | — |
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 404 | Not 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.
Update a user
Partially update a user profile.
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| uuid | string (uuid) | Obrigatório | — |
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
| 404 | Not 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.
Update user metadata
Merge arbitrary key/value metadata onto a user.
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| uuid | string (uuid) | Obrigatório | — |
Erros
| Status | Quando |
|---|---|
| 401 | Missing/invalid/expired credential |
| 403 | Authenticated but not permitted |
| 429 | Throttled - Retry-After header set |
| 400 | Validation error |
| 404 | Not 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. |