Получить участника
Один человек, его роль и его адреса, по идентификатору аккаунта.
Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.
GET /members/{userId}
Один человек, его роль и его адреса, по идентификатору аккаунта.
Пример
Требует members:read. ПО USER ID: по userId из списка, а не по адресу электронной почты.
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"}Поиска по адресу здесь нет. POST /members — единственный вызов, который его принимает, потому что это единственный вызов, у чьей вызывающей стороны действительно ещё нет идентификатора пользователя.
Идентификатор пользователя, которого нет в этом рабочем пространстве, — это обычный 404. Это единственный случай в данном ресурсе, который однозначно означает «такого ресурса нет». То же самое условие, возникшее при записи, которую не удалось прочитать обратно, отображается в 422, что там уместно, а здесь — нет.
Читается из полного списка участников, а не отдельным запросом одной строки, и это намеренно: участник — это ОБЪЕДИНЕНИЕ строки роли и набора выданных адресов, причём каждая из этих частей может существовать без другой, и это объединение вычисляется ровно в одном месте. Запрос одной строки был бы второй его реализацией, а тихо потерянной группой оказались бы держатели старых выданных доступов, которых в таблице сегодня большинство.