Saltar al contenido principal
Las cuentas de empresa pueden entregar a cada usuario humano solo el acceso que necesita. Usa el portal para la administración habitual o la API de Account cuando la gestión de miembros forme parte de un back-office controlado.
Estos endpoints requieren una sesión de miembro humano. Las API keys pueden consultar recursos de la cuenta, pero no tienen perfil de miembro ni pueden administrar miembros.

Roles y permisos

viewer es de solo lectura: no puede crear ni cambiar operaciones, credenciales, miembros o ajustes de la cuenta. Mantén al menos un owner en cada cuenta de empresa.

Administrar miembros en el portal

1

Abre los ajustes de la cuenta de empresa

Inicia sesión como owner, abre los ajustes de la cuenta de empresa y entra en la sección de miembros.
2

Agrega o selecciona un miembro

Al agregar un miembro, indica email, una contraseña de al menos ocho caracteres y uno de los tres roles. Al editarlo, selecciónalo antes de cambiar su rol o estado.
3

Confirma la acción

Para agregar un miembro, cambiar un rol, bloquear o desbloquear un login, o restablecer una contraseña, completa el desafío OTP member_add cuando el portal lo solicite. La acción se aplica inmediatamente después de confirmar.
Un owner no puede bloquear su propio login. Pide a otro owner que lo haga. El último owner tampoco puede ser degradado.

Administrar miembros con la API

Todos los ejemplos usan un token de sesión humana:

1. Consultar tu perfil de miembro

Este endpoint distingue al miembro que inició sesión de la cuenta de empresa:
Las API keys reciben 404 member_not_found porque no son miembros humanos.

2. Agregar y listar miembros

Agregar miembros es exclusivo de cuentas de empresa. Si omites role, el valor predeterminado es operator:
La respuesta es el miembro creado:
Lista los miembros antes de mostrar un formulario de edición:

3. Cambiar el rol

Solo un owner de una cuenta de empresa puede cambiar roles. Los valores permitidos son owner, operator y viewer.

4. Bloquear o desbloquear un miembro

Deshabilitar un miembro revoca inmediatamente todas sus sesiones. Usa active para desbloquear el login.

5. Restablecer una contraseña

Restablecer la contraseña también revoca todas las sesiones del miembro. Para cambiar tu propia contraseña usa POST /v1/me/password.

Errores y recuperación

Consulta la referencia de errores para el catálogo completo.
No. Los operators pueden operar los productos de la cuenta, pero no administrar miembros ni credenciales. La acción la debe realizar un owner.
No. La administración requiere una sesión humana. Las API keys no tienen perfil de miembro y GET /v1/me/member devuelve member_not_found.
Todas sus sesiones se revocan inmediatamente. Un owner debe reactivarlo antes de que pueda volver a iniciar sesión.
Usa POST /v1/me/password. El endpoint de administración es para otro miembro y devuelve self_action_forbidden si lo usas contigo mismo.
Última modificación el 6 de noviembre de 2026