Ein Mitglied einladen
Per E-Mail, mit einer Rolle und optional mit Adressen und ganzen Domains, die mit der Annahme wirksam werden.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
POST /members
Per E-Mail, mit einer Rolle und optional mit Adressen und ganzen Domains, die mit der Annahme wirksam werden.
Beispiel
Benötigt members:write. Gibt 202 mit der Einladung zurück. Niemand ist im Workspace, bevor er sie angenommen hat. access ist standardmäßig member und gilt für jede ID in addressIds und domainIds.
curl -X POST "$OE/members" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "email": "[email protected]", "roleId": "role_2b81de079c1f0a4b7e05d386", "domainIds": ["93542ff8-2baa-4f2f-841d-5ceaa074ab0d"], "access": "member" }'{ "object": "invitation", "id": "winv_6bb640f5b99e47deb758f1f5", "email": "[email protected]", "role": { "id": "role_2b81de079c1f0a4b7e05d386", "name": "Support", "builtin": null }, "addresses": [], "domains": [ { "domainId": "93542ff8-2baa-4f2f-841d-5ceaa074ab0d", "domain": "acme.com", "access": "member" } ], "expiresAt": "2026-10-02T14:07:31.000Z", "delivered": true, "deliveryError": null, "createdAt": "2026-09-18T14:07:31.000Z"}ALLE WERDEN EINGELADEN. Ob die Adresse bereits ein OpenEmail-Konto hat oder nicht, die Antwort ist eine Einladung und ein 202, nie ein Mitglied. Niemand wird ohne Annahme in einen Workspace gesetzt, und dieser Endpunkt hält sich an dieselbe Regel wie die App. Jemand, der bereits im Workspace ist, wird mit member_is_owner abgelehnt, einem 422: Ändern Sie stattdessen mit PATCH /members/{userId} und den Grant-Aufrufen, was diese Person darf.
Die Einladung trägt die Rolle, die Adressen und die ganzen Domains, die Sie nennen, und gewährt genau diese in dem Moment, in dem sie angenommen wird. Vorher wird nichts gewährt. Eine ganze Domain umfasst jede Adresse darauf, auch solche, die nach dem Versand der Einladung angelegt werden.
POST statt PUT auf eine Benutzer-ID, weil der Aufrufer die Benutzer-ID nicht kennt und womöglich jemanden einlädt, der noch kein Konto hat. Er kennt eine E-Mail-Adresse.
Ein zweites Mal innerhalb von zehn Minuten zu fragen ergibt invitation_too_soon, ein 409. Danach wird die eine offene Einladung aufgefrischt, ein neuer Link erzeugt und der alte zurückgezogen, statt eine zweite zu versenden.
delivered: false heißt, dass die Einladung existiert, die E-Mail den Mailserver aber nicht verlassen hat. deliveryError sagt, was der Server gesagt hat. Es hat sie nichts erreicht, versenden Sie sie also nach Ablauf der Sperrfrist erneut aus der App.
invitedBy bleibt bewusst null, statt dem Workspace-Inhaber zugeschrieben zu werden. Die Spalte hält fest, welche PERSON jemanden eingeladen hat, und ein API-Schlüssel ist keine Person.
Der Workspace-Inhaber wird mit member_is_owner abgelehnt, einem 422. Er ist kein Mitglied und kann auch keines werden.