Zum Hauptinhalt springen
POST
Mitglieder zum Arbeitsbereich hinzufügen
Für diesen Endpunkt sind ein Management-API-Schlüssel mit workspaces:write und eine Inhaber- oder Admin-Rolle erforderlich.
Personen treten einem Workspace über eine Einladung bei. Wer sie annimmt, erzeugt eine Beitrittsanfrage, und dieser Endpunkt genehmigt sie. Jeder Benutzer in user_ids muss eine ausstehende Beitrittsanfrage im Workspace haben. Andere Benutzer werden abgelehnt; sende ihnen zuerst eine Einladung. Bestehende Mitglieder behalten ihre Rolle. Die Rolle kann admin oder member sein. Ohne Rolle erhält jede Person die Rolle, mit der ihre Einladung erstellt wurde. Nur der Workspace-Inhaber kann Admins hinzufügen, und die Workspace-Inhaberschaft kann über diesen Endpunkt nicht vergeben werden. Jede Person wird einzeln genehmigt. Schlägt eine Genehmigung fehl, bleiben die zuvor genehmigten Personen im Workspace, und die übrigen werden nicht versucht. Die Antwort ist dann ein 409, dessen Listen approved, failed und not_attempted zeigen, wo der Vorgang angehalten hat. Behebe das Problem und sende die übrigen Benutzer erneut.

Autorisierungen

Authorization
string
header
erforderlich

Authentifizierung mit Bearer-Token

Pfadparameter

id
string
erforderlich

UUID oder Slug des Arbeitsbereichs.

Body

application/json
user_ids
string[]
erforderlich
Required array length: 1 - 100 elements
role
enum<string>
Verfügbare Optionen:
admin,
member

Antwort

Mitglieder hinzugefügt

added_count
integer
erforderlich
Erforderlicher Bereich: x >= 0
approved
string[]
erforderlich

Durch diese Anfrage hinzugefügte Benutzer, in der Reihenfolge ihrer Genehmigung.

failed
object[]
erforderlich

Der Benutzer, dessen Genehmigung fehlgeschlagen ist, mit dem Grund. Nachfolgende Benutzer werden nicht versucht.

not_attempted
string[]
erforderlich

Benutzer, die nicht versucht wurden, weil eine frühere Genehmigung fehlgeschlagen ist. Ihre Beitrittsanfragen sind weiterhin ausstehend.

error
string
message
string
data
object[]

Die Details der hinzugefügten Mitglieder. Fehlen, wenn sie nach den Genehmigungen nicht gelesen werden konnten; approved listet trotzdem, wer hinzugefügt wurde.

Zuletzt geändert am 16. November 2026