Ein Mitglied abrufen
Eine Person, ihre Rolle und ihre Adressen, nach Konto-ID.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
GET /members/{userId}
Eine Person, ihre Rolle und ihre Adressen, nach Konto-ID.
Beispiel
Benötigt members:read. Nach BENUTZER-ID: die userId aus der Liste, nicht die E-Mail-Adresse.
curl "$OE/members/nQ8vBz1aRd4tYwKx7fQ2mN8vBz1aRd4t" -H "$AUTH"{ "object": "member", "userId": "nQ8vBz1aRd4tYwKx7fQ2mN8vBz1aRd4t", "email": "[email protected]", "name": "Sam Okonjo", "image": null, "role": { "id": "role_2b81de079c1f0a4b7e05d386", "name": "Support", "builtin": null }, "implied": false, "permissions": [ "emails:send", "emails:read", "threads:read", "threads:write", "labels:read", "labels:write", "contacts:read" ], "addresses": [ { "addressId": "2b81de07-9c1f-4a4b-8e05-d3862c1f0a44", "address": "[email protected]", "access": "member" } ], "createdAt": "2026-08-12T14:20:00.000Z"}Eine Suche per E-Mail gibt es hier nicht. POST /members ist der eine Aufruf, der eine annimmt, weil es der eine Aufruf ist, dessen Aufrufer tatsächlich noch keine Benutzer-ID hat.
Eine Benutzer-ID, die nicht zu diesem Workspace gehört, ergibt ein schlichtes 404. Es ist der eine Fall in dieser Ressource, der eindeutig „keine solche Ressource“ bedeutet. Dieselbe Bedingung, ausgelöst von einem Schreibvorgang, der nicht zurückgelesen werden konnte, wird auf 422 abgebildet – dort richtig und hier falsch.
Bewusst aus der vollständigen Mitgliederliste gelesen statt über eine Einzelzeilen-Abfrage: Ein Mitglied ist die VEREINIGUNG aus einer Rollenzeile und einer Menge von Adress-Grants, von denen jedes ohne das andere existieren kann, und diese Vereinigung wird an genau einer Stelle berechnet. Eine Einzelzeilen-Abfrage wäre eine zweite Implementierung davon, und die Gruppe, die sie stillschweigend übergehen würde, sind die Altbestands-Grant-Inhaber, die heute den Großteil der Tabelle ausmachen.