Пространства

Пространства: отдельные рабочие области кабинета. У каждого свои кампании, аккаунты и контакты.

Маршруты

GET/v1/workspaces

#Объект Workspace

Пространство: отдельная рабочая область кабинета со своими кампаниями.

Поля

objectstring
Тип объекта, всегда workspace.
idstring (uuid)
Идентификатор пространства.
namestring
Название пространства.
created_atstring (date-time) или null
Когда пространство создано. Может быть null у старых пространств.

Workspace

{
  "object": "workspace",
  "id": "3f6a9d21-8b4c-4e7f-a102-5c9e8d7b6a43",
  "name": "Основное пространство",
  "created_at": "2026-09-01T12:00:00.000Z"
}

#Список пространств

GET/v1/workspaces

Пространства в охвате ключа, от старых к новым. Доступен ключу с любым набором прав.

Право: любое право чтения
Вес запроса: 1

Параметры

limitinteger, в строке запросанеобязательный
Сколько объектов вернуть на странице. От 1 до 100. По умолчанию 50.
cursorstring, в строке запросанеобязательный
Значение next_cursor из предыдущего ответа. Остальные фильтры должны совпадать с первым запросом.

Ответ

Список: object, data (массив объектов Workspace), has_more, next_cursor. Подробнее в руководстве Пагинация.

Особые ошибки

cursor_mismatch: Курсор поврежден, выдан для другого маршрута или фильтров, либо права и охват ключа изменились.
scope_required: Ключ не имеет права на это чтение. Для текстов нужен также включенный «Текст сообщений».
not_found: Объект не найден или находится вне охвата ключа. Неизвестный путь тоже дает 404.
cursor_expired: Срок курсора истек: 15 минут для списков, 30 суток для ленты событий.

Общие ошибки описаны в руководстве Ошибки.

Запрос

curl https://api.melioralab.io/v1/workspaces \
  -H "Authorization: Bearer $MELIORA_API_KEY"

const res = await fetch('https://api.melioralab.io/v1/workspaces', {
  headers: { Authorization: `Bearer ${process.env.MELIORA_API_KEY}` },
});
if (!res.ok) throw new Error(`Meliora API: ${res.status}`);
const body = await res.json();

import os
import requests

resp = requests.get(
    "https://api.melioralab.io/v1/workspaces",
    headers={"Authorization": f"Bearer {os.environ['MELIORA_API_KEY']}"},
    timeout=15,
)
resp.raise_for_status()
body = resp.json()

Ответ

{
  "object": "list",
  "data": [
    {
      "object": "workspace",
      "id": "3f6a9d21-8b4c-4e7f-a102-5c9e8d7b6a43",
      "name": "Основное пространство",
      "created_at": "2026-09-01T12:00:00.000Z"
    },
    {
      "object": "workspace",
      "id": "7a2c5e81-3d9f-4b6a-8c40-1e5f7a9b2d68",
      "name": "Тестовые рассылки",
      "created_at": "2026-10-02T09:30:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}