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

Personalização

Estado privado por usuário em /v1/me/.... Não exige elegibilidade de Etiquetas: qualquer membro autenticado pode usar preferências, visões salvas e Featured.

Preferência vazia: GET /v1/me/dashboard-preferences/{surface}/ sem estado salvo responde 200:

{"surface": "forms_home", "schema_version": 1, "filters": {}, "updated_at": null}

DELETE de preferências é idempotente (204). Escritas aceitam filters canônico; o legado payload ainda é aceito (filters vence se ambos forem enviados).

Quando Etiquetas estão indisponíveis, preferências podem manter filtros de etiqueta em repouso, mas as respostas os omitem com o aviso labels_feature_unavailable.

Featured é privado por usuário — is_featured nas listagens reflete apenas o chamador.

GET /v1/users/

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

Parâmetros de query

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": "[email protected]",
      "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