Saltar al contenido principal
POST
Añadir miembros al espacio de trabajo
Este endpoint requiere una clave de API de gestión con workspaces:write y el rol de propietario o administrador.
Las personas se unen a un espacio de trabajo mediante una invitación: la aceptan, lo que crea una solicitud de acceso, y este endpoint la aprueba. Cada usuario de user_ids debe tener una solicitud de acceso pendiente en el espacio de trabajo. Los demás usuarios se rechazan, así que envíales antes una invitación. Quienes ya son miembros conservan su rol. El rol puede ser admin o member. Sin rol, cada persona recibe el rol con el que se creó su invitación. Solo el propietario del espacio de trabajo puede añadir administradores, y la propiedad del espacio de trabajo no se puede asignar mediante este endpoint. Cada persona se aprueba por separado. Si una aprobación falla, las personas aprobadas antes siguen en el espacio de trabajo y las demás no se intentan. La respuesta es entonces un 409 cuyas listas approved, failed y not_attempted muestran dónde se detuvo, para que puedas corregir el problema y volver a enviar los usuarios restantes.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Parámetros de ruta

id
string
requerido

UUID o slug del espacio de trabajo.

Cuerpo

application/json
user_ids
string[]
requerido
Required array length: 1 - 100 elements
role
enum<string>
Opciones disponibles:
admin,
member

Respuesta

Miembros añadidos

added_count
integer
requerido
Rango requerido: x >= 0
approved
string[]
requerido

Usuarios añadidos por esta solicitud, en el orden en que se aprobaron.

failed
object[]
requerido

El usuario cuya aprobación falló, con el motivo. Los usuarios posteriores no se intentan.

not_attempted
string[]
requerido

Usuarios que no se intentaron porque falló una aprobación anterior. Sus solicitudes de acceso siguen pendientes.

error
string
message
string
data
object[]

Los datos de los miembros añadidos. Se omiten si no se pudieron leer después de las aprobaciones; approved sigue indicando quién se añadió.

Última modificación el 16 de noviembre de 2026