Users

El endpoint de Users te permite consultar la información del usuario autenticado.

GET/v2/users/me

Get current user

Obtén el perfil del usuario asociado al API key actual. Si usas el header X-User-Id, devuelve el perfil del usuario impersonado (debe pertenecer al mismo tenant).

Response

Name
id
Type
string
Description
ID único del usuario (UUID).
Name
fullName
Type
string
Description
Nombre completo para mostrar.
Name
email
Type
string
Description
Email del usuario.
Name
tenantId
Type
string
Description
ID del tenant al que pertenece.
Name
orgId
Type
string
Description
ID de la organización.

Request

GET

/v2/users/me

curl "https://api.allsign.io/v2/users/me" \
  -H "Authorization: Bearer ALLSIGN_LIVE_SK"

Response (200)

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "fullName": "Ada Lovelace",
  "email": "ada@example.com",
  "tenantId": "1e2ec3d4-5b6a-7f89-0123-456789abcdef",
  "orgId": "7f89e0d1-2345-6789-abcd-ef0123456789"
}

GET/v2/users/team

List team members

Lista todos los miembros del tenant (workspace) del usuario autenticado. Es útil para obtener los UUIDs y usarlos con el parámetro forUserId en GET /v2/documents.

Permisos

Requiere rol admin u owner dentro del tenant.

Response

Name
data
Type
array
Description
Lista de miembros del equipo.
Name
data[].id
Type
string
Description
UUID del usuario. Úsalo como valor de forUserId en /v2/documents.
Name
data[].name
Type
string
Description
Nombre para mostrar.
Name
data[].email
Type
string
Description
Email del miembro.
Name
data[].role
Type
string
Description
Rol en el tenant: owner, admin, developer, member, viewer.
Name
meta.total
Type
number
Description
Total de miembros en el equipo.

Request

GET

/v2/users/team

curl "https://api.allsign.io/v2/users/team" \
  -H "Authorization: Bearer ALLSIGN_LIVE_SK"

Response (200)

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Ada Lovelace",
      "email": "ada@empresa.com",
      "role": "owner"
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "name": "Pedro García",
      "email": "pedro@empresa.com",
      "role": "admin"
    }
  ],
  "meta": { "total": 2 }
}

Uso con documentos

GET

/v2/documents?forUserId=...

# 1. Obtener miembros del equipo
curl "https://api.allsign.io/v2/users/team" \
  -H "Authorization: Bearer ALLSIGN_LIVE_SK"

# 2. Filtrar documentos de Pedro (creador, firmante o con acceso)
curl "https://api.allsign.io/v2/documents?scope=accessible&forUserId=660e8400-e29b-41d4-a716-446655440001" \
  -H "Authorization: Bearer ALLSIGN_LIVE_SK"