Referência
Tipos de atividade
Traduz o activity_type_id que aparece em atividades, e é obrigatório para criar uma.
GET {BASE_URL}/api-v1/activity-types # lista
GET {BASE_URL}/api-v1/activity-types/:id # detalheEste recurso ainda não está no ar. Ele existe só no endereço novo
({BASE_URL}/api-v1/activity-types), que ainda não foi publicado: hoje qualquer chamada para ele
devolve 404 not_found. Esta página existe para você já preparar a
integração — avisaremos aqui quando o endereço entrar no ar.
Escopo: catalogos:read (somente leitura).
Campos
| Campo | Tipo | Notas |
|---|---|---|
id | uuid | |
name | string | |
icon | string | |
is_meeting | boolean | |
default_online | boolean | |
sync_calendar | boolean | |
position | number | Devolvido como número. |
is_active | boolean | |
created_at | datetime |
Listar tipos de atividade
GET {BASE_URL}/api-v1/activity-types
| Parâmetro (query) | Tipo | Notas |
|---|---|---|
is_active | boolean | |
limit | number | Tamanho da página. Padrão 50, máximo 200. |
cursor | uuid | Próxima página — use o meta.next_cursor da resposta anterior. |
Ordenação: id crescente. Paginação por cursor.
curl "{BASE_URL}/api-v1/activity-types?is_active=true" \
-H "X-API-Key: vnd_sua_chave_aqui"{
"data": [ /* registros */ ],
"meta": { "next_cursor": "8f3c...", "has_more": true }
}Consultar um registro
GET {BASE_URL}/api-v1/activity-types/:id → o recurso completo, ou 404 not_found.
curl "{BASE_URL}/api-v1/activity-types/8f3c..." \
-H "X-API-Key: vnd_sua_chave_aqui"Erros
| HTTP | code | Quando |
|---|---|---|
401 | missing_api_key / invalid_api_key / revoked_api_key | Autenticação. |
403 | insufficient_scope | A chave não tem catalogos:read. |
404 | not_found | O registro não existe neste cliente. |
422 | invalid_cursor | O cursor enviado não é válido. |
405 | method_not_allowed | Método não suportado neste endereço. |
500 | internal_error | Falha interna. |
Catálogo completo em Erros.