Перейти к содержимому

Организации

Эндпоинты только для чтения для организаций, в которых вы состоите. Все пути находятся на https://api.recordmeeting.com и требуют API-ключ. См. Аутентификация.

Чтобы получить список записей организации, используйте Список записей с organization_id.

GET /v1/organizations

Возвращает все организации, в которых вы состоите.

{
"data": [
{
"id": "org_uuid",
"name": "Acme Inc.",
"role": "ADMIN",
"member_count": 12
}
]
}
РольОписание
OWNERПолный контроль над организацией
ADMINУправляет настройками, участниками и папками
EDITORСоздаёт, редактирует и просматривает записи
VIEWERДоступ только для просмотра

GET /v1/organizations/:id/folders

Возвращает активные папки организации. Вы должны быть участником.

{
"data": [
{
"id": "folder_uuid",
"name": "Product team",
"icon": null
}
]
}

icon это имя значка папки или null.


GET /v1/organizations/:id/members

Возвращает участников организации. Вы должны быть участником.

{
"data": [
{
"id": "user_uuid",
"email": "alice@example.com",
"name": "Alice",
"role": "EDITOR"
}
],
"emails_included": true
}

Адреса электронной почты возвращаются лишь тогда, когда ваша роль в организации имеет значение OWNER или ADMIN. Для других ролей каждое поле email равно null, а emails_included равно false.


КодHTTP-статусЗначение
FORBIDDEN403Вы не являетесь участником этой организации