Users
Dos endpoints para conocer quién eres frente a la API y quién más está en tu tenant. GET /v3/users/me identifica al principal detrás de la credencial (útil para verificar scopes y entorno); GET /v3/users/team lista a los miembros del equipo.
Las respuestas usan camelCase en el wire e ids opacos con prefijo (usr_, ten_). Los errores siguen problem+json (RFC 9457) con un code en UPPER_SNAKE. GET /v3/users/team es una colección acotada (object: "list", hasMore siempre false): su tamaño lo limitan los asientos del tenant, nunca necesita cursor. Cada respuesta trae headers RateLimit-*.
Get current user
GET /users/me
Devuelve el tenant y el usuario detrás de tu credencial, junto con los scopes que tiene tu API key y el entorno en que opera. Usa este endpoint como sonda de salud de tu credencial antes de una integración. Responde 200 (autenticado) o 401 (sin credencial válida) — nunca 403. Solo confirma tu propia identidad, así que no está protegido por ningún scope.
Ejemplo (cURL)
curl "https://api.allsign.io/v3/users/me" \
-H "Authorization: Bearer allsign_live_sk_..."
Respuestas
200 El usuario y tenant detrás de la credencial, con sus scopes y entorno. — UserMe
{
"id": "usr_1a2b3c4d5e6f7g8h",
"email": "tu@empresa.com",
"tenantId": "ten_9i8u7y6t5r4e3w2q",
"scopes": [
"document:read",
"document:write",
"analytics:read"
],
"environment": "live",
"authMode": "api_key",
"livemode": true
}List team members
GET /users/team
Lista a cada miembro de tu tenant con su rol. A diferencia de /users/me, este endpoint sí está protegido por un scope: expone datos de otras personas, así que requiere user:read.
Ejemplo (cURL)
curl "https://api.allsign.io/v3/users/team" \
-H "Authorization: Bearer allsign_live_sk_..."
Respuestas
200 Colección acotada (object: "list", hasMore siempre false) con los miembros del tenant. — TeamList
{
"object": "list",
"data": [
{
"id": "usr_1a2b3c4d5e6f7g8h",
"name": "Ana Ramírez",
"email": "ana@empresa.com",
"role": "owner"
},
{
"id": "usr_2b3c4d5e6f7g8h9i",
"name": "Luis Hernández",
"email": "luis@empresa.com",
"role": "member"
}
],
"hasMore": false,
"nextCursor": null,
"previousCursor": null,
"limit": null
}