La gestión de cuentas solo está disponible con una clave API institucional. Las claves API de nivel médico no tienen acceso a estos endpoints.
Las claves API institucionales pueden crear y recuperar cuentas de médicos dentro de su organización. Cada cuenta representa a un médico que puede usar el scribe de Telepatia a través de su integración.
Crear una cuenta
curl -X POST https://synapse.telepatia.ai/v1/institutional/accounts \
-H "Authorization: Bearer SU_CLAVE_API_INSTITUCIONAL" \
-H "Content-Type: application/json" \
-d '{
"name": "Dr. Jane Smith",
"email": "jane.smith@clinica.com",
"institutionalId": "DOCTOR-001"
}'
Respuesta:
{
"accountId": "acc_a1b2c3d4e5f6g7h8",
"name": "Dr. Jane Smith",
"email": "jane.smith@clinica.com",
"institutionalId": "DOCTOR-001",
"createdAt": "2026-02-20T10:00:00Z"
}
Guarde el accountId — puede usarlo para recuperar la cuenta más adelante.
Recuperar una cuenta
curl https://synapse.telepatia.ai/v1/institutional/accounts/acc_a1b2c3d4e5f6g7h8 \
-H "Authorization: Bearer SU_CLAVE_API_INSTITUCIONAL"
Respuesta:
{
"accountId": "acc_a1b2c3d4e5f6g7h8",
"name": "Dr. Jane Smith",
"email": "jane.smith@clinica.com",
"institutionalId": "DOCTOR-001",
"createdAt": "2026-02-20T10:00:00Z"
}