Přejít na dokumentaci
API

Načtení člena

Jeden člověk, jeho role a jeho adresy, podle id účtu.

GETapi.openemail.uk/members/{userId}

Spustí skutečné volání proti vašemu pracovnímu prostoru, s vaším vlastním klíčem.

GET /members/{userId}

Jeden člověk, jeho role a jeho adresy, podle id účtu.

Příklad

Vyžaduje members:read. Podle ID UŽIVATELE: userId z výpisu, ne jejich e-mailová adresa.

curl
curl "$OE/members/nQ8vBz1aRd4tYwKx7fQ2mN8vBz1aRd4t" -H "$AUTH"
Odpověď
{  "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"}

Vyhledávání podle e-mailu tu není. POST /members je jediné volání, které ho přijímá, protože je to jediné volání, jehož volající opravdu ještě žádné id uživatele nemá.

Id uživatele, které k tomuto workspace nepatří, je prosté 404. Je to jediný případ v tomto zdroji, který jednoznačně znamená „takový zdroj neexistuje“. Tentýž stav vyvolaný zápisem, který se nepodařilo přečíst zpět, se mapuje na 422, což je správné tam a špatné tady.

Čte se z úplného výpisu členů, a ne dotazem na jeden řádek, a to záměrně: člen je SJEDNOCENÍM řádku s rolí a množiny přístupů k adresám, přičemž kterékoli z nich může existovat bez toho druhého, a to sjednocení se počítá na jediném místě. Dotaz na jeden řádek by byl jeho druhou implementací a populace, kterou by tiše minul, jsou držitelé starších přístupů, kteří dnes tvoří většinu tabulky.