Growth OS API

Listar alunos com resumo de uso

Alunos = usuários com ao menos uma matrícula (`enrollment`) em algum curso. Dado GLOBAL da rede — não filtra por workspace. Exclusivo da conta Accelera: a chave precisa do escopo `platform.read` E ser o workspace da conta Accelera; qualquer outra chave com o escopo leva 403 `forbidden_platform`. `lastLoginAt`/`lastActiveAt` vêm da sessão (Better Auth): login mais recente e última vez visto; `null` = nunca logou. `enrolledCourses`/`completedCourses`/`certificates` são contadores ALL-TIME (não filtram por período). `q` busca por nome ou e-mail (contém, sem diferenciar maiúsculas). `activeSince`/`activeBefore` (ISO-8601) recortam por `lastActiveAt`: `activeSince` é `>=`, `activeBefore` é `<`; aluno que nunca logou não casa com nenhum dos dois. Paginação por cursor keyset (`createdAt`, `id`); `limit` até 500.

GET
/platform/users

Alunos = usuários com ao menos uma matrícula (enrollment) em algum curso. Dado GLOBAL da rede — não filtra por workspace. Exclusivo da conta Accelera: a chave precisa do escopo platform.read E ser o workspace da conta Accelera; qualquer outra chave com o escopo leva 403 forbidden_platform.

lastLoginAt/lastActiveAt vêm da sessão (Better Auth): login mais recente e última vez visto; null = nunca logou. enrolledCourses/completedCourses/certificates são contadores ALL-TIME (não filtram por período). q busca por nome ou e-mail (contém, sem diferenciar maiúsculas). activeSince/activeBefore (ISO-8601) recortam por lastActiveAt: activeSince é >=, activeBefore é <; aluno que nunca logou não casa com nenhum dos dois. Paginação por cursor keyset (createdAt, id); limit até 500.

AutorizaçãoBearer <token>

Chave de API (gos_…)

Em: header

Parâmetros de consulta

q?string
Length1 <= length <= 200
activeSince?string
activeBefore?string
cursor?string
limit?integer
Range1 <= value <= 500
Default50

Corpo da resposta

application/json

curl -X GET "https://example.com/platform/users"
{  "data": [    {      "id": "string",      "name": "string",      "email": "string",      "createdAt": "string",      "lastLoginAt": "string",      "lastActiveAt": "string",      "enrolledCourses": -9007199254740991,      "completedCourses": -9007199254740991,      "certificates": -9007199254740991    }  ],  "nextCursor": "string"}