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.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:404 member_not_found porque no son miembros humanos.
2. Agregar y listar miembros
Agregar miembros es exclusivo de cuentas de empresa. Si omitesrole, el
valor predeterminado es operator:
3. Cambiar el rol
Solo un owner de una cuenta de empresa puede cambiar roles. Los valores permitidos sonowner, operator y viewer.
4. Bloquear o desbloquear un miembro
Deshabilitar un miembro revoca inmediatamente todas sus sesiones. Usaactive 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 usaPOST /v1/me/password.
Errores y recuperación
Consulta la referencia de errores para el catálogo completo.
¿Un operator puede agregar o editar miembros?
¿Un operator puede agregar o editar miembros?
No. Los operators pueden operar los productos de la cuenta, pero no
administrar miembros ni credenciales. La acción la debe realizar un owner.
¿Puedo usar una API key para administrar miembros?
¿Puedo usar una API key para administrar miembros?
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.¿Qué ocurre al deshabilitar un miembro?
¿Qué ocurre al deshabilitar un miembro?
Todas sus sesiones se revocan inmediatamente. Un owner debe reactivarlo antes
de que pueda volver a iniciar sesión.
¿Cómo cambio mi propia contraseña?
¿Cómo cambio mi propia contraseña?
Usa
POST /v1/me/password. El endpoint de administración es para otro
miembro y devuelve self_action_forbidden si lo usas contigo mismo.