Listar contactos
O livro de endereços do workspace, com os vistos mais recentemente primeiro e os contactos a quem nunca foi enviado correio no fim. Todas as chaves do workspace leem as mesmas linhas, pelo que um contacto guardado por um membro é um contacto que todos os membros e todas as chaves veem. A paginação é por keyset: `limit` vai até 200 e assume 50 por omissão, e `nextCursor` volta como `cursor` enquanto `hasMore` for true.
Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.
GET /contacts
O livro de endereços do workspace, com os vistos mais recentemente primeiro e os contactos a quem nunca foi enviado correio no fim. Todas as chaves do workspace leem as mesmas linhas, pelo que um contacto guardado por um membro é um contacto que todos os membros e todas as chaves veem. A paginação é por keyset: limit vai até 200 e assume 50 por omissão, e nextCursor volta como cursor enquanto hasMore for true.
Exemplo
Requer contacts:read.
curl "$OE/contacts?limit=50" -H "$AUTH"{ "object": "list", "data": [ { "object": "contact", "email": "[email protected]", "name": "Ada Lovelace", "source": "auto", "notes": null, "lastSeenAt": "2026-08-29T08:19:08.000Z", "createdAt": "2026-08-01T10:00:00.000Z", "updatedAt": "2026-08-29T08:19:08.000Z" } ], "hasMore": false, "nextCursor": null}source é manual quando alguém guardou o endereço, na aplicação ou através de POST /contacts, e auto quando foi registado por um membro lhe ter enviado correio a partir do compositor. São afirmações materialmente diferentes (auto é prova de correspondência, manual é prova de intenção) e vale a pena ramificar por elas.
A ordem é lastSeenAt descendente com os nulos no fim, depois dos mais recentes para os mais antigos. Um contacto acabado de criar não tem lastSeenAt e fica ordenado no fim, não no topo.
O livro pertence ao workspace e não a quem guardou uma linha. Correio que chega de um endereço não cria nada.