Passer au contenu principal
POST
Ajouter des membres à l’espace de travail
Ce point de terminaison nécessite une clé API de gestion avec workspaces:write et un rôle de propriétaire ou d’administrateur.
Les personnes rejoignent un espace de travail via une invitation : elles l’acceptent, ce qui crée une demande d’adhésion, et ce point de terminaison l’approuve. Chaque utilisateur de user_ids doit avoir une demande d’adhésion en attente dans l’espace de travail. Les autres utilisateurs sont refusés ; envoyez-leur d’abord une invitation. Les membres existants conservent leur rôle. Le rôle peut être admin ou member. Sans rôle, chaque personne reçoit le rôle avec lequel son invitation a été créée. Seul le propriétaire de l’espace de travail peut ajouter des administrateurs, et la propriété de l’espace de travail ne peut pas être attribuée via ce point de terminaison. Chaque personne est approuvée séparément. Si une approbation échoue, les personnes approuvées avant restent dans l’espace de travail et les suivantes ne sont pas tentées. La réponse est alors un 409 dont les listes approved, failed et not_attempted indiquent où le traitement s’est arrêté ; corrigez le problème et renvoyez les utilisateurs restants.

Autorisations

Authorization
string
header
requis

Authentification par jeton Bearer

Paramètres de chemin

id
string
requis

UUID ou slug de l’espace de travail.

Corps

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

Réponse

Membres ajoutés

added_count
integer
requis
Plage requise: x >= 0
approved
string[]
requis

Utilisateurs ajoutés par cette requête, dans l’ordre de leur approbation.

failed
object[]
requis

L’utilisateur dont l’approbation a échoué, avec la raison. Les utilisateurs suivants ne sont pas tentés.

not_attempted
string[]
requis

Utilisateurs non tentés parce qu’une approbation précédente a échoué. Leurs demandes d’adhésion restent en attente.

error
string
message
string
data
object[]

Les détails des membres ajoutés. Omis s’ils n’ont pas pu être relus après les approbations ; approved indique toujours qui a été ajouté.

Dernière modification le 16 novembre 2026