Участники

Фильтр участников

Метод API предназначен для поиска и получения списка участников организации с использованием расширенных фильтров. Требует доступ org.members.read.

Запрос

Метод: POST URL: https://b2b.selfwork.ru/openapi/v2/organisation/{organisationId}/members/filter

Path Parameters

Параметр	Тип	Обязательное поле	Описание	Пример
organisationId	string (uuid)	Да	ID организации	550e8400-e29b-41d4-a716-446655440000

Общая структура запроса описана в разделе Фильтрация: общая структура.

Доступные фильтры (filters)

Имя (name)	Тип значения (value)	Описание
USER_ID	string (uuid) или массив	ID пользователя
ROLE_ID	string (uuid) или массив	ID роли (см. раздел «Роли»)
STATUS	string или array[string]	Статус участника: ACTIVE, ARCHIVED

Организация всегда берётся из пути, фильтр ORGANISATION_ID передавать не нужно.

Доступные сортировки (order)

Поле (field)	Описание
JOINED_AT	Дата вступления в организацию
CREATED_AT	Дата создания записи участника

Пример запроса

curl --location "https://b2b.selfwork.ru/openapi/v2/organisation/550e8400-e29b-41d4-a716-446655440000/members/filter" \
--header "accept: application/json" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ВАШ_API_КЛЮЧ" \
--data '{
    "filters": [],
    "pagination": {
        "limit": 10,
        "lastId": null
    }
}'

Пример успешного ответа

{
  "requestId": "97c5678a-8c6a-4688-8452-68ab606fe049",
  "success": true,
  "result": {
    "lastId": "01961a2b-0001-7e5f-8a9b-0c1d2e3f4a5b",
    "items": [
      {
        "id": "01961a2b-0001-7e5f-8a9b-0c1d2e3f4a5b",
        "roles": [
          {
            "id": "01961a2b-0010-7e5f-8a9b-0c1d2e3f4a5b",
            "memberId": "01961a2b-0001-7e5f-8a9b-0c1d2e3f4a5b",
            "roleId": "019d06af-5e5d-7313-b8ba-df1640767435",
            "roleCode": "OWNER",
            "roleName": "Владелец",
            "active": true,
            "createdAt": "2026-03-17T12:00:00Z"
          }
        ],
        "joinedAt": "2026-03-17T12:00:00Z",
        "createdAt": "2026-03-17T12:00:00Z",
        "updatedAt": "2026-03-17T12:00:00Z",
        "email": "user@example.com",
        "firstName": "Иван",
        "lastName": "Иванов",
        "middleName": "Иванович"
      }
    ]
  }
}

Описание полей ответа

Поле	Тип	Описание
requestId	string	Уникальный идентификатор запроса
success	boolean	Статус выполнения запроса (true/false)
result	object	Контейнер с данными ответа
result.lastId	string|number	ID последнего элемента в текущем списке (для пагинации)
result.items	array[obj]	Массив найденных участников
id	string (uuid)	Идентификатор членства
roles	array[obj]	Роли участника в организации (см. поля роли ниже)
joinedAt	string	Дата вступления
createdAt	string	Дата создания записи
updatedAt	string	Дата обновления
email	string (email)	Email пользователя
firstName	string	Имя пользователя
lastName	string	Фамилия пользователя
middleName	string	Отчество пользователя

 

Деталка участника

Метод API возвращает подробную информацию об одном участнике организации. Требует доступ org.members.read.

Запрос

Метод: GET URL: https://b2b.selfwork.ru/openapi/v2/organisation/{organisationId}/members/{memberId}

Path Parameters

Параметр	Тип	Обязательное поле	Описание	Пример
organisationId	string (uuid)	Да	ID организации	550e8400-e29b-41d4-a716-446655440000
memberId	string	Да	Идентификатор участника	01961a2b-0001-7e5f-8a9b-0c1d2e3f4a5b

Пример запроса

curl -X 'GET' \
  "https://b2b.selfwork.ru/openapi/v2/organisation/550e8400-e29b-41d4-a716-446655440000/members/01961a2b-0001-7e5f-8a9b-0c1d2e3f4a5b" \
  -H "accept: application/json" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ"

Пример успешного ответа

{
  "requestId": "97c5678a-8c6a-4688-8452-68ab606fe049",
  "success": true,
  "result": {
    "id": "01961a2b-0001-7e5f-8a9b-0c1d2e3f4a5b",
    "roles": [
      {
        "id": "01961a2b-0010-7e5f-8a9b-0c1d2e3f4a5b",
        "memberId": "01961a2b-0001-7e5f-8a9b-0c1d2e3f4a5b",
        "roleId": "019d06af-5e5d-7313-b8ba-df1640767435",
        "roleCode": "OWNER",
        "roleName": "Владелец",
        "active": true,
        "createdAt": "2026-03-17T12:00:00Z"
      }
    ],
    "joinedAt": "2026-03-17T12:00:00Z",
    "createdAt": "2026-03-17T12:00:00Z",
    "updatedAt": "2026-03-17T12:00:00Z",
    "email": "user@example.com",
    "firstName": "Иван",
    "lastName": "Иванов",
    "middleName": "Иванович"
  }
}

Описание полей ответа

Поле	Тип	Описание
requestId	string	Уникальный идентификатор запроса
success	boolean	Статус выполнения запроса (true/false)
result	object	Объект участника (MemberInfoApiDto)
id	string (uuid)	Идентификатор членства
roles	array[obj]	Роли участника в организации (см. поля роли ниже)
joinedAt	string	Дата вступления
createdAt	string	Дата создания записи
updatedAt	string	Дата обновления
email	string (email)	Email пользователя
firstName	string	Имя пользователя
lastName	string	Фамилия пользователя
middleName	string	Отчество пользователя

Поля роли (объект roles[])

Поле	Тип	Описание	Пример
id	string (uuid)	Идентификатор назначения	01961a2b-0010-7e5f-8a9b-0c1d2e3f4a5b
memberId	string (uuid)	Идентификатор членства	01961a2b-0001-7e5f-8a9b-0c1d2e3f4a5b
roleId	string (uuid)	Идентификатор роли	019d06af-5e5d-7313-b8ba-df1640767435
roleCode	string	Технический код роли	OWNER
roleName	string	Человекочитаемое название роли	Владелец
active	boolean	Активность назначения	true
createdAt	string	Дата создания	2026-03-17T12:00:00Z

 

Редактирование роли

Метод API позволяет деактивировать или реактивировать назначенную участнику роль. Требует доступ org.members.roles.edit.

Запрос

Метод: PATCH URL: https://b2b.selfwork.ru/openapi/v2/organisation/{organisationId}/members/{memberId}/roles/{memberRoleId}

Path Parameters

Параметр	Тип	Обязательное поле	Описание	Пример
organisationId	string (uuid)	Да	ID организации	550e8400-e29b-41d4-a716-446655440000
memberId	string	Да	Идентификатор участника	01961a2b-0001-7e5f-8a9b-0c1d2e3f4a5b
memberRoleId	string	Да	Идентификатор роли участника	01961a2b-0010-7e5f-8a9b-0c1d2e3f4a5b

Request Body

Поле	Тип	Обязательное поле	Описание
active	boolean	Да	Деактивация (false) / реактивация (true)

Пример запроса

curl -X 'PATCH' \
  "https://b2b.selfwork.ru/openapi/v2/organisation/550e8400-e29b-41d4-a716-446655440000/members/01961a2b-0001-7e5f-8a9b-0c1d2e3f4a5b/roles/01961a2b-0010-7e5f-8a9b-0c1d2e3f4a5b" \
  -H "accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -d '{
    "active": false
}'

Пример успешного ответа

{
  "requestId": "97c5678a-8c6a-4688-8452-68ab606fe049",
  "success": true,
  "result": {
    "id": "01961a2b-0010-7e5f-8a9b-0c1d2e3f4a5b",
    "memberId": "01961a2b-0001-7e5f-8a9b-0c1d2e3f4a5b",
    "roleId": "019d06af-5e5d-7313-b8ba-df1640767435",
    "roleCode": "OWNER",
    "roleName": "Владелец",
    "active": false,
    "createdAt": "2026-03-17T12:00:00Z"
  }
}

Описание полей ответа

Поле	Тип	Описание
requestId	string	Уникальный идентификатор запроса
success	boolean	Статус выполнения запроса (true/false)
result	object	Объект назначения роли (MemberRoleInfoDto)
id	string (uuid)	Идентификатор назначения
memberId	string (uuid)	Идентификатор членства
roleId	string (uuid)	Идентификатор роли
roleCode	string	Технический код роли
roleName	string	Человекочитаемое название роли
active	boolean	Активность назначения
createdAt	string	Дата создания