Получение ID организации

Одного API-ключа (или access_token) для работы с API недостаточно: почти все методы маркетплейса выполняются в контексте организации, и её идентификатор передаётся прямо в URL — /openapi/v2/organisation/{organisationId}/....

Список организаций, доступных пользователю с текущим ключом или токеном, возвращает метод /me/memberships. Дополнительных разрешений (scope) для него не требуется — достаточно валидного API-ключа или access_token.

Запрос

Метод: GET URL: https://b2b.selfwork.ru/openapi/v2/me/memberships

curl --location "https://b2b.selfwork.ru/openapi/v2/me/memberships" \
--header "accept: application/json" \
--header "Authorization: Bearer ВАШ_API_КЛЮЧ"

Если API-ключ ограничен организациями, в ответе будут только они.

Пример ответа

{
  "requestId": "97c5678a-8c6a-4688-8452-68ab606fe049",
  "result": [
    {
      "organisation": {
        "id": "01961a2b-3c4d-7e5f-8a9b-0c1d2e3f4a5b",
        "name": "ООО Рога и Копыта"
      },
      "roles": [
        {
          "roleCode": "OWNER",
          "roleName": "Владелец",
          "active": true
        }
      ],
      "permissions": ["org.read", "org.update"],
      "joinedAt": "2026-03-17T12:00:00Z"
    }
  ],
  "success": true
}

Ответ приведён сокращённо — полный состав полей описан в разделе Контекст пользователя.

Что использовать как organisationId

Поле	Описание
result[].organisation.id	Идентификатор организации — подставляется в URL вместо {organisationId}
result[].organisation.name	Название организации — для выбора нужной, если их несколько
result[].permissions	Разрешения пользователя в этой организации

Пример подстановки:

POST https://b2b.selfwork.ru/openapi/v2/organisation/01961a2b-3c4d-7e5f-8a9b-0c1d2e3f4a5b/announcements

Если организаций несколько

Токен выдаётся пользователю, а пользователь может состоять сразу в нескольких организациях — тогда result содержит несколько элементов. Выберите нужную по organisation.name и проверьте, что в permissions есть права на планируемые операции.

Идентификатор организации не меняется, поэтому его можно сохранить в настройках интеграции. Но состав организаций и прав со временем меняется, поэтому перед запуском длительных сценариев значение стоит перепроверять.

Проверить актуальные роли и разрешения в рамках конкретной организации можно методом получения контекста.