Invitar miembros

Agregar a un compañero de equipo cuesta un enlace. Un administrador crea la invitación, usted le envía la URL y esa persona se une a la organización en cuanto la abre con la sesión iniciada y elige Aceptar invitación.

Antes de empezar

Requisito	Por qué
Usted es administrador de la organización activa	Las invitaciones son una acción exclusiva de administradores
El espacio de trabajo activo no es el personal	Los espacios de trabajo personales no pueden tener miembros

Si el selector de la parte superior de la barra lateral dice Personal, cree primero una organización; consulte Cambiar de organización.

Crear una invitación

1. Abra Equipo en la barra lateral.
2. Elija Invitar.
3. Escriba la dirección de correo del compañero de equipo.
4. Elija un rol: Miembro — desplegar y usar la API o Administrador — acceso total.
5. Elija Crear invitación.

Superheat devuelve un enlace:

https://cloud.superheat.xyz/join?token=<token>

Cópielo antes de cerrar el diálogo. El token se muestra exactamente una vez y no se puede recuperar después. Si lo pierde, revoque la invitación y cree otra.

Trate el enlace como una credencial de todos modos

La invitación está vinculada a la dirección de correo que escribió: solo alguien con la sesión iniciada con esa dirección —la de su inicio de sesión actual, no la que figuraba cuando se creó su cuenta— puede aceptarla. A cualquier otra persona que abra el enlace se le dice que la invitación no existe o que se envió a otra dirección, incluso con un token perfectamente válido.

Es una restricción real, no una formalidad — pero el token sigue viajando en una URL, donde se filtra a través de enlaces pegados y cabeceras Referer. Envíelo directamente a la persona en lugar de a un canal compartido, y revóquelo si acaba donde no debía.

Cómo acepta su compañero de equipo

Hay dos vías, y ambas terminan en la misma pertenencia.

Vía	Qué hace esa persona
El enlace	Inicia sesión, abre /join?token=… y elige Aceptar invitación
En la consola	Inicia sesión con la dirección de correo invitada y luego acepta el aviso del panel que dice "Le han invitado a …"

Ambas rutas requieren iniciar sesión como la dirección invitada; el aviso es una comodidad, no una segunda forma de entrar.

Abrir el enlace muestra qué se acepta antes de que ocurra nada: Unirse a y el nombre de su organización, quién le invitó y con qué rol, y cuándo vence la invitación. Una invitación de administrador añade una línea que detalla lo que pueden hacer los administradores. Aceptar invitación une a la persona; Ahora no deja la invitación sin usar.

Tras aceptar mediante el enlace, la página dice Te uniste a y el nombre de su organización, y pregunta si cambiar a ella ahora: Cambiar a ella, o Quedarme en el espacio actual. Nada cambia de espacio de trabajo sin preguntar. Si todavía no tiene cuenta, primero crea una con el mismo flujo sin contraseña; consulte Crear una cuenta.

Si algo sale mal:

Mensaje	Qué ocurrió
Esta invitación ya se usó.	Cada invitación es de un solo uso. Cree otra.
Esta invitación venció. Pide a un administrador que envíe una nueva.	Las invitaciones duran 7 días desde su creación.
Esta invitación no existe o se envió a una dirección de correo distinta de la de tu sesión.	La invitación fue revocada —o retirada porque el administrador que la envió fue eliminado o pasó a ser miembro—, el token es incorrecto o está truncado, o usted inició sesión con una dirección distinta de la invitada. Cierre sesión y vuelva a entrar con la dirección invitada.
Esta invitación ya no es válida: quien la envió ya no es administrador. Pide una nueva a un administrador actual.	El administrador que la creó ya no es administrador de la organización, así que la invitación ya no lleva su autoridad.
Falta el token de invitación	La URL se abrió sin su parte ?token=. Copie el enlace completo.

Invitaciones pendientes

La página Equipo lista todas las invitaciones que aún no se han aceptado y que no han caducado, con el rol y la fecha de vencimiento. Los administradores ven esta lista; los miembros no.

• Revocar elimina la invitación. El enlace deja de funcionar de inmediato.
• Una invitación desaparece de la lista en cuanto se acepta, se revoca o cumple 7 días.
• Eliminar a un administrador, o convertirlo en miembro, retira todas las invitaciones que creó y que siguen pendientes.

Desde la API

Crear una invitación es una acción de administrador, así que requiere un token de sesión. Una clave de API shk_ se rechaza en todos los endpoints de administración, incluso cuando quien la creó es administrador.

curl -X POST "$SUPERHEAT_API/v1/orgs/current/invites" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Org-Id: $ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"email": "teammate@company.com", "role": "member"}'

{
  "invite": {
    "id": "0f1c9e2a-8a1e-4a1b-9a52-2f3f0b6f6a11",
    "email": "teammate@company.com",
    "role": "member",
    "created_at": "2026-03-04T10:12:00Z",
    "expires_at": "2026-03-11T10:12:00Z"
  },
  "invite_url": "https://cloud.superheat.xyz/join?token=…"
}

invite_url es el único lugar donde aparece el token.

Endpoint	Quién puede llamarlo
POST /v1/orgs/current/invites	Administradores, solo con token de sesión
GET /v1/orgs/current/invites	Administradores: invitaciones no aceptadas y no caducadas
DELETE /v1/orgs/current/invites/{invite_id}	Administradores: revocar
GET /v1/orgs/invites/pending	Cualquier usuario con sesión iniciada: invitaciones dirigidas a su correo
POST /v1/orgs/invites/preview	Cualquier usuario con sesión iniciada, cuerpo {"token": "…"}: devuelve org_id, org_name, role, inviter y expires_at sin aceptar
POST /v1/orgs/invites/{invite_id}/accept	El usuario invitado, al aceptar una de ellas
POST /v1/orgs/invites/accept	Cualquier usuario con sesión iniciada, con el cuerpo {"token": "…"}

Qué obtiene un miembro nuevo el primer día

De inmediato comparte el saldo de créditos de la organización, sus instancias, sus plantillas, sus claves de API y su registro de uso. No comparte sus claves SSH: esas quedan en la cuenta de cada usuario. Consulte Roles y permisos para saber exactamente qué puede hacer un miembro, y Cambiar de organización para saber qué se queda del otro lado del límite.

Relacionado

• Roles y permisos
• Cambiar de organización
• Organizaciones