O gerenciamento de contas só está disponível com uma chave API institucional. Chaves API de nível médico não têm acesso a esses endpoints.
Chaves API institucionais podem criar e recuperar contas de médicos dentro da sua organização. Cada conta representa um médico que pode usar o scribe da Telepatia através da sua integração.
Criar uma conta
curl -X POST https://synapse.telepatia.ai/v1/institutional/accounts \
-H "Authorization: Bearer SUA_CHAVE_API_INSTITUCIONAL" \
-H "Content-Type: application/json" \
-d '{
"name": "Dr. Jane Smith",
"email": "jane.smith@clinica.com",
"institutionalId": "DOCTOR-001"
}'
Resposta:
{
"accountId": "acc_a1b2c3d4e5f6g7h8",
"name": "Dr. Jane Smith",
"email": "jane.smith@clinica.com",
"institutionalId": "DOCTOR-001",
"createdAt": "2026-02-20T10:00:00Z"
}
Guarde o accountId — você pode usá-lo pra recuperar a conta depois.
Recuperar uma conta
curl https://synapse.telepatia.ai/v1/institutional/accounts/acc_a1b2c3d4e5f6g7h8 \
-H "Authorization: Bearer SUA_CHAVE_API_INSTITUCIONAL"
Resposta:
{
"accountId": "acc_a1b2c3d4e5f6g7h8",
"name": "Dr. Jane Smith",
"email": "jane.smith@clinica.com",
"institutionalId": "DOCTOR-001",
"createdAt": "2026-02-20T10:00:00Z"
}