API

Содержание

Я хочу …

Выбери, что задумал; ниже только нужные для этого шаги. Полный справочник — дальше внизу.

Создай бота в одной из своих групп, в меню группы в разделе «Боты → Мои боты», с картинкой, именем и @именем. Его токен ты увидишь только один раз.
Поделись его ссылкой «Добавить бота» или отправь его в каталог ботов, где он появится после проверки командой; тот, кто может управлять ролями в группе, принимает его с правами, на которые соглашается.
Получай события его групп потоком (GET /v2/events/stream) или на свой адрес и пиши через POST /v2/channels/{id}/messages. Подробнее в Боты.
Зарегистрируй команды (PUT /v2/me/commands) и отвечай карточками и кнопками; музыку бот играет с местом в голосовом канале (POST /v2/channels/{id}/voice).

Обзор

v2 позволяет твоим собственным программам общаться с tellmelo: один ключ на запрос, в ответ JSON, все списки листаются одинаково. Действуют те же правила, что и в приложении.

Каждый путь начинается с https://api.tellmelo.com/v2.
Запросы и ответы — JSON в UTF-8. Имена полей, коды и значения английские и остаются английскими.
Ключ действует как твой аккаунт: чего ты не видишь в приложении, он тоже не прочитает.

https://api.tellmelo.com/v2

Быстрый старт

Создай ключ в «Раздел для разработчиков → API» и скопируй его. Он показывается только один раз.
Вызови с ним корень. В ответе — версия, права ключа и сколько запросов осталось в этой минуте.
Все пути работают одинаково: ключ в заголовке, в ответ JSON, для списков items и next.

curl -H "Authorization: Bearer tm_key_…" https://api.tellmelo.com/v2

{
  "name": "tellmelo",
  "version": "2.20",
  "scope": "read write",
  "rateLimit": {
    "limit": 120,
    "remaining": 117
  },
  "docs": "/developers/docs",
  "spec": "/api/v2/openapi.json"
}

Дальше: /me для твоего профиля, /posts для публичных постов, /feed для твоей ленты.

Попробовать

Выбери задачу, заполни поля и скопируй запрос или отправь его отсюда. Перед записью мы спросим. Код читает ключ из TELLMELO_KEY.

Задача

read Версия API и название этого сервера.

curl \
  -H "Authorization: Bearer $TELLMELO_KEY" \
  "https://api.tellmelo.com/v2"

Твой ключХранится только на этой странице, пока ты её не закроешь.

Твой ключ

До 10 ключей на аккаунт, у каждого имя, свои права и при желании срок действия. Ключ начинается с tm_key_ и показывается только один раз. Потерял? Обнови его, старое значение перестанет работать.

Ты создаёшь его в «Раздел для разработчиков → API». Он передаётся в заголовке запроса:

curl -H "Authorization: Bearer tm_key_…" \
  https://api.tellmelo.com/v2/posts

Или, если так удобнее, в отдельном заголовке:

curl -H "X-Tellmelo-Key: tm_key_…" https://api.tellmelo.com/v2

Не в URL: он попал бы в логи и в историю браузера.

Тот же ключ загружает изображения: каждый url ведёт на /api/media; передавай ключ в заголовке и там.

curl -H "Authorization: Bearer tm_key_…" \
  -o picture.webp "https://api.tellmelo.com/media?id=…"

Что может ключ

Ключ всегда может читать, а если ты разрешишь, ещё писать, дарить, загружать медиа и управлять группами. У каждого пути ниже указано, что ему нужно:

read: чтение. Публичные публикации, профили, группы и теги, а также твоя лента, уведомления, сообщения и каналы твоих групп.
write: действия. Публиковать, отвечать, голосовать, отправлять сообщения, писать в чате группы, подписываться, вступать, блокировать, отмечать уведомления прочитанными.
gifts: дарить. Из квоты партнёра участнику и подарки под новым постом. Отдельное право, чтобы ключ для публикаций никогда ничего не мог раздать.
media: своя медиатека. Загрузка, изменение, публикация и удаление GIF и видео. Отдельное право, потому что загрузки расходуют видеобаллы аккаунта. Для поиска общих GIF и видео достаточно read.
groups: управлять группами. Роли, каналы, категории, пригласительные ссылки, канал ленты, удаления, заглушения, исключения и баны — насколько твой аккаунт это может в группе. Отдельное право, чтобы ключ для публикаций никогда не менял, кто что может в группе.

Чего не может ни один ключ

Ни один ключ не достаёт до пароля, адреса эл. почты, типа аккаунта, места, роли, удаления, сеансов, push-устройств и других ключей, а также до администрирования и руководства группами. Что защищает пароль, ни один ключ не может.

Боты

Бот — это отдельный аккаунт вида bot для групп: без пароля и почты, им управляет твоя программа с собственным ключом. Он использует тот же API, что и любой аккаунт, и может в группах всё, что разрешает его роль там.

В одной из своих групп открой меню группы и в разделе «Боты → Мои боты» создай бота с картинкой, обложкой, именем, именем пользователя и описанием. Токен показывается только один раз; у него права read, write, media и groups.
Поделись ссылкой на бота или отправь его в каталог ботов; он появится там, как только команда его проверит. Тот, кто может управлять ролями в группе, выбирает права; бот вступает и получает собственную роль.
Твоя программа отправляет токен как Authorization: Bearer …, читает события своих групп потоком и работает с маршрутами из разделов Боты, Каналы и Группы.

Небольшой бот, который читает события потоком и отвечает на команду /ping словом pong только спросившему:

// Node 18 or newer: reads the events of the bot's groups as they happen and answers /ping.
const BASE = 'https://api.tellmelo.com/v2';
const KEY = process.env.TELLMELO_BOT_TOKEN;
const call = (method, path, body) =>
  fetch(BASE + path, {
    method,
    headers: { Authorization: 'Bearer ' + KEY, 'Content-Type': 'application/json' },
    body: body && JSON.stringify(body),
  }).then((r) => r.json());

await call('PUT', '/me/commands', { commands: [{ name: 'ping', description: 'Answers pong' }] });

let last = '';
for (;;) {
  // The stream closes after ten minutes; Last-Event-ID goes on where it stopped.
  const res = await fetch(BASE + '/events/stream', {
    headers: { Authorization: 'Bearer ' + KEY, ...(last && { 'Last-Event-ID': last }) },
  });
  const reader = res.body.pipeThrough(new TextDecoderStream()).getReader();
  let buffer = '';
  for (;;) {
    const { value, done } = await reader.read();
    if (done) break;
    buffer += value;
    let end;
    while ((end = buffer.indexOf('

')) >= 0) {
      const data = buffer.slice(0, end).split('
').find((l) => l.startsWith('data: '));
      buffer = buffer.slice(end + 2);
      if (!data) continue;
      const event = JSON.parse(data.slice(6));
      last = event.id;
      if (event.type === 'command' && event.data.command === 'ping')
        await call('POST', '/interactions/' + event.data.interaction + '/reply', { text: 'pong', private: true });
    }
  }
}

Тот же бот на Python, получающий события постранично:

# Python 3 with requests: the same bot, reading the events page by page.
import os, time, requests

BASE = 'https://api.tellmelo.com/v2'
H = {'Authorization': 'Bearer ' + os.environ['TELLMELO_BOT_TOKEN']}
requests.put(BASE + '/me/commands', headers=H,
             json={'commands': [{'name': 'ping', 'description': 'Answers pong'}]})

since = '0'
while True:
    page = requests.get(BASE + '/events', headers=H, params={'since': since}).json()
    for event in page['items']:
        if event['type'] == 'command' and event['data']['command'] == 'ping':
            requests.post(f"{BASE}/interactions/{event['data']['interaction']}/reply",
                          headers=H, json={'text': 'pong'})
    since = page['next'] or since
    time.sleep(2)

Что бот может делать в группе, определяет его роль там, а не токен. Роль носит его имя; группа меняет её права в ролях в настройках группы и удаляет бота в меню группы в разделе «Боты → В этой группе».
До 5 ботов на аккаунт; в группе — столько, сколько позволяют её бонусы. Бот пишет не больше 30 сообщений в минуту в одной группе, не находится через поиск и пишет только тем, кто написал ему первым. Действуют ограничения.
События приходят и на собственный HTTPS-адрес (с подписью, как вебхуки, и повторами). Кроме того: команды (PUT /v2/me/commands) с ответами для всех или только спросившему, карточки и кнопки в сообщениях и музыка в голосовых каналах (POST /v2/channels/{id}/voice): всё в разделе Боты.

Запросы и ответы

JSON везде. Каждый ответ — application/json в UTF-8, включая ошибки. Только изображения приходят изображениями.
Что ты отправляешь. POST передаёт свои поля как JSON в теле. Если поле есть и в URL, побеждает тело.
Время — миллисекунды с 1 января 1970 года, UTC.
ID — строки. Сравнивай их только целиком.
Каждое поле присутствует всегда. Отсутствующее — null; списки могут быть пустыми.
Тексты — обычный текст, ровно как написаны. #теги, @имена и ссылки остаются как есть, как и собственные эмодзи сервера в виде :имя:; их картинки перечислены в /emojis.
Изображения — относительные адреса, /api/media?id=…. Без ключа в заголовке получишь 401.

Страницы

Каждый список принимает limit и cursor и отвечает items и next. Отправь next обратно как cursor, чтобы получить следующую страницу; если next пуст, всё. Курсор непрозрачен: не разбирай его и не составляй сам.

{ "items": [ … ], "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx" }

curl -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/posts?limit=20&cursor=MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"

Без limit — 20 записей, максимум 50. Некоторые списки не листаются; их next всегда null.

Только новое

Каждый ответ несёт ETag. Отправь его в следующий раз как If-None-Match: если ничего не изменилось, получишь 304 без тела.

ETag: W/"3Qk1mJ7fQe2Yb0sVxT9aL4pNdRc"
If-None-Match: W/"3Qk1mJ7fQe2Yb0sVxT9aL4pNdRc"  →  304

Исключения: у /feed нет ETag, потому что его порядок всё время меняется, а записи никогда не отвечают 304.

Лимиты

Ключ может делать 120 запросов в минуту, 600 с тарифом «Организация», если администрация не задала иначе. Сверх этого ты получишь 429, и ничего не выполнится. Подожди минуту и отправь запрос снова.

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 1758624060

Записи также учитываются в лимитах приложения, например сколько постов за несколько минут. Это тоже отвечает 429 с rate_limited.

Заголовки

Кроме ключа, никакие заголовки не обязательны.

Что ты отправляешь

Заголовок	Значение
`Authorization`	Несёт ключ: `Bearer tm_key_…`. Обычный способ.
`X-Tellmelo-Key`	Ключ, как альтернатива `Authorization`.
`Content-Type`	`application/json`, для запроса с телом.
`If-None-Match`	`ETag` последнего ответа. Если с тех пор ничего не изменилось, ответ — `304` без тела.

Что приходит в ответ

Заголовок	Значение
`ETag`	Отпечаток этого ответа (`W/`). Отправь его обратно как `If-None-Match`.
`X-RateLimit-Limit`	Сколько запросов в минуту может делать этот ключ.
`X-RateLimit-Remaining`	Сколько из них осталось в текущей минуте.
`X-RateLimit-Reset`	Когда начнётся следующая минута, в секундах с 1970 года, UTC.
`X-Tellmelo-Scope`	Что может этот ключ: `read` или `read write`.
`Retry-After`	При `429`: сколько секунд подождать перед новым запросом.
`WWW-Authenticate`	При `401` без ключа: `Bearer`.
`Cache-Control`	`no-store`: ни один прокси не может кэшировать ответ. Проверить его ты всё равно можешь по `ETag`.

Когда что-то не работает

Ошибки приходят в JSON: фиксированный английский код в error для программы и фраза в message для людей, плюс соответствующий код статуса. Сравнивай только код; фраза может меняться.

{ "error": "rate_limited",
  "message": "Too many requests. Try again in a minute.",
  "limit": 120 }

Некоторые ошибки несут ещё одно поле: docs при 401 из-за отсутствия ключа, limit при 429.

Статус	Код	Значение
`400`	`bad_request`	Запрос нельзя прочитать, не хватает обязательного поля или значение недопустимо.
`401`	`key_missing`	В заголовке нет ключа.
`401`	`key_invalid`	Ключ недействителен: опечатка, замена или аккаунт заблокирован.
`401`	`unauthorized`	Отклонено как без входа, по причине, не связанной с ключом.
`403`	`scope_missing`	У ключа нет нужного права, обычно `write`.
`403`	`account_data_locked`	Данные аккаунта, такие как пароль, адрес эл. почты или удаление, ключам недоступны.
`403`	`forbidden`	Твоему аккаунту это нельзя, например из-за отозванного права или блокировки.
`403`	`timed_out`	Заглушение сейчас не даёт твоему аккаунту писать в этой группе.
`404`	`unknown_path`	Такого пути нет или нет с этим методом.
`404`	`not_found`	Не найдено, или тебе нельзя это видеть.
`409`	`conflict`	Конфликтует с уже существующим, например имя занято.
`409`	`feed_off`	Канал ленты этой группы выключен.
`413`	`too_large`	Слишком велико для этого сервера.
`422`	`unprocessable`	Читается, но в таком виде невозможно.
`429`	`rate_limited`	Слишком много запросов. Ничего не произошло; подожди и попробуй снова.
`500`	`internal_error`	На сервере что-то пошло не так.

Версии

Версия указана в пути. Пока там v2, пути и поля остаются прежними; новое только добавляется.

Дополнения увеличивают второе число. У каждого пути указано, с какой версии он есть.

2.20: PUT /v2/roles/{id}/selfGET /v2/eventsGET /v2/events/streamGET /v2/me/commandsPUT /v2/me/commandsPOST /v2/interactions/{id}/replyGET /v2/communities/{id}/emojisPOST /v2/communities/{id}/emojisDELETE /v2/communities/{id}/emojis/{name}PUT /v2/communities/{id}/channels/shapePOST /v2/channels/{id}/voice
2.19: POST /v2/replies/{id}/votePOST /v2/replies/{id}/pickGET /v2/posts/{id}/replies/waitingPOST /v2/replies/{id}/decideGET /v2/posts/{id}/replies/plannedPUT /v2/me/planned-replies/{id}POST /v2/me/planned-replies/{id}/sendDELETE /v2/me/planned-replies/{id}GET /v2/posts/{id}/reply-settingsPUT /v2/posts/{id}/reply-settingsPOST /v2/posts/{id}/coauthorDELETE /v2/posts/{id}/coauthorPOST /v2/posts/{id}/pinPOST /v2/conversations/{with}/plannedGET /v2/me/planned-messagesPOST /v2/me/planned-messages/{id}/sendDELETE /v2/me/planned-messages/{id}GET /v2/profiles/{handle}/followersGET /v2/profiles/{handle}/followingGET /v2/me/relationsGET /v2/me/collectionsPOST /v2/me/collectionsPUT /v2/me/collections/{id}DELETE /v2/me/collections/{id}GET /v2/me/collections/{id}/postsPOST /v2/me/collections/{id}/postsGET /v2/profiles/{handle}/eventsPOST /v2/me/eventsPUT /v2/me/events/{id}DELETE /v2/me/events/{id}GET /v2/me/events/{id}/signupsPOST /v2/events/{id}/signupPOST /v2/me/picturesPUT /v2/me/profileGET /v2/me/emojisPOST /v2/me/emojis/picturesPOST /v2/me/emojisDELETE /v2/me/emojis/{name}PUT /v2/me/emojis/sharingGET /v2/me/webhooksPOST /v2/me/webhooksDELETE /v2/me/webhooks/{id}POST /v2/me/webhooks/{id}/testPOST /v2/communitiesPUT /v2/communities/{id}GET /v2/communities/{id}/botsGET /v2/communities/{id}/voice
2.16: PUT /v2/communities/{id}/members/{member}/timeoutDELETE /v2/communities/{id}/members/{member}/timeoutGET /v2/communities/{id}/bansPUT /v2/communities/{id}/bans/{member}DELETE /v2/communities/{id}/bans/{member}
2.15: GET /v2/communities/{id}/channelsGET /v2/channels/{id}/messagesGET /v2/communities/{id}/membersGET /v2/communities/{id}/rolesGET /v2/communities/{id}/bellGET /v2/invites/{code}POST /v2/channels/{id}/messagesPOST /v2/channels/{id}/readDELETE /v2/channel-messages/{id}PUT /v2/communities/{id}/bellPOST /v2/invites/{code}/joinPOST /v2/communities/{id}/rolesPUT /v2/roles/{id}DELETE /v2/roles/{id}PUT /v2/communities/{id}/roles/orderPUT /v2/roles/{id}/members/{member}POST /v2/communities/{id}/channelsPUT /v2/channels/{id}DELETE /v2/channels/{id}PUT /v2/communities/{id}/channels/orderGET /v2/channels/{id}/overridesPUT /v2/channels/{id}/overrides/{role}POST /v2/communities/{id}/categoriesPUT /v2/categories/{id}DELETE /v2/categories/{id}PUT /v2/communities/{id}/feedGET /v2/communities/{id}/invitesPOST /v2/communities/{id}/invitesDELETE /v2/invites/{code}POST /v2/channel-messages/{id}/removePOST /v2/communities/{id}/posts/{post}/removeDELETE /v2/communities/{id}/members/{member}GET /v2/communities/{id}/log
2.14: GET /v2/mediaGET /v2/media/mineGET /v2/media/{id}POST /v2/media/uploadsPUT /v2/media/uploads/{upload}POST /v2/media/{id}DELETE /v2/media/{id}
2.12: GET /v2/me/scheduledPOST /v2/posts/{id}/schedulePOST /v2/posts/{id}/editPOST /v2/replies/{id}/editDELETE /v2/replies/{id}POST /v2/replies/{id}/likeDELETE /v2/conversations/{with}/messages/{id}GET /v2/partner/quotaGET /v2/partner/giftsPOST /v2/partner/giftsGET /v2/gift-dropsPOST /v2/gift-drops
2.1: GET /v2/emojisPOST /v2/conversations/{with}/read
2.0: GET /v2GET /v2/postsGET /v2/posts/{id}GET /v2/posts/{id}/repliesGET /v2/profiles/{handle}GET /v2/profiles/{handle}/postsGET /v2/communitiesGET /v2/communities/{id}GET /v2/communities/{id}/postsGET /v2/tagsGET /v2/searchGET /v2/meGET /v2/feedGET /v2/notificationsGET /v2/conversationsGET /v2/conversations/{with}/messagesPOST /v2/postsDELETE /v2/posts/{id}POST /v2/posts/{id}/repliesPOST /v2/posts/{id}/votePOST /v2/relationsPOST /v2/conversations/{with}/messagesPOST /v2/notifications/read

https://api.tellmelo.com/v1/ больше нет: старые пути отвечают 410 и называют новый путь в теле.

Конечные точки

Все пути одним взглядом, затем каждый с примером.

Путь	Право	Для чего
Вход
GET`/v2`	`read`	Версия API и название этого сервера.
Посты
GET`/v2/posts`	`read`	Публичные посты, сначала новые.
GET`/v2/posts/{id}`	`read`	Один пост по его `id`.
POST`/v2/posts`	`write`	Опубликовать пост.
DELETE`/v2/posts/{id}`	`write`	Удалить один из своих постов.
GET`/v2/me/scheduled`	`read`	Твои посты, которые ещё не вышли, и чего они ждут.
POST`/v2/posts/{id}/schedule`	`write`	Изменить, когда выйдет запланированный пост или когда пост удалится сам.
POST`/v2/posts/{id}/edit`	`write`	Изменить текст своего поста.
GET`/v2/posts/{id}/reply-settings`	`read`	Кто может отвечать на твой пост, ждут ли ответы одобрения и медленный режим.
PUT`/v2/posts/{id}/reply-settings`	`write`	Изменить настройки ответов своего поста. То, что не указано, остаётся как есть.
POST`/v2/posts/{id}/coauthor`	`write`	Принять или отклонить приглашение стать соавтором.
DELETE`/v2/posts/{id}/coauthor`	`write`	Выйти из соавторов или, как автор, убрать соавтора с поста.
POST`/v2/posts/{id}/pin`	`write`	Закрепить свой пост вверху профиля или открепить его.
Ответы
GET`/v2/posts/{id}/replies`	`read`	Ответы на пост, без заблокированных аккаунтов.
POST`/v2/posts/{id}/replies`	`write`	Ответить на пост.
POST`/v2/replies/{id}/edit`	`write`	Изменить текст своего ответа.
DELETE`/v2/replies/{id}`	`write`	Удалить свой ответ.
POST`/v2/replies/{id}/like`	`write`	Проголосовать «за» ответ (с тех пор как ответы оценивают голосами, отметка «нравится» — это голос «за») или отозвать голос; голос «против» остаётся.
POST`/v2/replies/{id}/vote`	`write`	Проголосовать за ответ или против него либо отозвать свой голос. Возвращает твой голос и итоговый рейтинг.
POST`/v2/replies/{id}/pick`	`write`	Отметить ответ под своим постом как лучший или снять отметку.
GET`/v2/posts/{id}/replies/waiting`	`read`	Ответы под постом, ожидающие одобрения: под твоим — все, иначе только твои.
POST`/v2/replies/{id}/decide`	`write`	Одобрить или отклонить ожидающий ответ под своим постом. Отклонённый удаляется.
GET`/v2/posts/{id}/replies/planned`	`read`	Твои ответы под постом, запланированные на потом.
PUT`/v2/me/planned-replies/{id}`	`write`	Изменить текст или время запланированного ответа. Неудавшийся снова ждёт.
POST`/v2/me/planned-replies/{id}/send`	`write`	Отправить запланированный ответ сразу.
DELETE`/v2/me/planned-replies/{id}`	`write`	Удалить запланированный ответ.
Опросы
POST`/v2/posts/{id}/vote`	`write`	Принять участие в опросе.
Профили
GET`/v2/profiles/{handle}`	`read`	Профиль по его короткому имени.
GET`/v2/profiles/{handle}/posts`	`read`	Публичные посты одного профиля, сначала новые.
GET`/v2/profiles/{handle}/events`	`read`	Предстоящие события профиля, ближайшие сначала.
POST`/v2/me/events`	`write`	Создать событие. Возвращает его `id`.
PUT`/v2/me/events/{id}`	`write`	Изменить своё событие. Все поля задаются заново.
DELETE`/v2/me/events/{id}`	`write`	Удалить своё событие.
GET`/v2/me/events/{id}/signups`	`read`	Кто записался на твоё событие.
POST`/v2/events/{id}/signup`	`write`	Записаться на событие или отменить запись.
Группы
GET`/v2/communities`	`read`	Открытые группы этого сервера; с `mine=true` — группы твоего аккаунта.
GET`/v2/communities/{id}`	`read`	Одна группа по её `id`.
GET`/v2/communities/{id}/posts`	`read`	Публикации канала ленты группы, сначала новые.
GET`/v2/communities/{id}/members`	`read`	Участники группы с их ролями.
GET`/v2/communities/{id}/roles`	`read`	Роли группы, сначала высшая, @everyone последней.
GET`/v2/communities/{id}/bell`	`read`	Какие уведомления присылает тебе группа.
GET`/v2/invites/{code}`	`read`	Группа за ссылкой-приглашением, до вступления.
PUT`/v2/roles/{id}/self`	`write`	Взять или снять роль на выбор.
GET`/v2/communities/{id}/emojis`	`read`	Собственные эмодзи группы.
PUT`/v2/communities/{id}/bell`	`write`	Настроить, какие уведомления присылает тебе группа.
POST`/v2/invites/{code}/join`	`write`	Вступить в группу по ссылке-приглашению.
GET`/v2/communities/{id}/bots`	`read`	Боты группы и то, что разрешает их роль.
Каналы
GET`/v2/communities/{id}/channels`	`read`	Каналы группы, которые ты видишь, по порядку.
GET`/v2/channels/{id}/messages`	`read`	Сообщения чат-канала, сначала новые.
POST`/v2/channels/{id}/messages`	`write`	Написать сообщение в чат-канал.
POST`/v2/channels/{id}/read`	`write`	Отметить чат-канал прочитанным до момента времени.
DELETE`/v2/channel-messages/{id}`	`write`	Удалить своё сообщение в чат-канале.
GET`/v2/communities/{id}/voice`	`read`	Кто сейчас в голосовых каналах группы, по каналам.
Управление группами
POST`/v2/communities/{id}/emojis`	`groups`	Добавить эмодзи группе.
DELETE`/v2/communities/{id}/emojis/{name}`	`groups`	Удалить эмодзи из группы.
POST`/v2/communities/{id}/roles`	`groups`	Создать роль.
PUT`/v2/roles/{id}`	`groups`	Изменить название, цвет и права роли.
DELETE`/v2/roles/{id}`	`groups`	Удалить роль.
PUT`/v2/communities/{id}/roles/order`	`groups`	Задать порядок ролей.
PUT`/v2/roles/{id}/members/{member}`	`groups`	Выдать участнику роль или забрать её.
POST`/v2/communities/{id}/channels`	`groups`	Создать чат-канал.
PUT`/v2/channels/{id}`	`groups`	Изменить название, тему и категорию канала.
DELETE`/v2/channels/{id}`	`groups`	Удалить чат-канал вместе с сообщениями.
PUT`/v2/communities/{id}/channels/order`	`groups`	Задать порядок категорий и чат-каналов.
PUT`/v2/communities/{id}/channels/shape`	`groups`	Задать форму всех символов каналов группы.
GET`/v2/channels/{id}/overrides`	`groups`	Что роли могут в канале иначе, чем в группе.
PUT`/v2/channels/{id}/overrides/{role}`	`groups`	Задать, что роль может в канале иначе.
POST`/v2/communities/{id}/categories`	`groups`	Создать категорию для каналов.
PUT`/v2/categories/{id}`	`groups`	Переименовать категорию.
DELETE`/v2/categories/{id}`	`groups`	Удалить категорию.
PUT`/v2/communities/{id}/feed`	`groups`	Включить или выключить канал ленты группы.
GET`/v2/communities/{id}/invites`	`groups`	Ссылки-приглашения группы, которые ещё действуют.
POST`/v2/communities/{id}/invites`	`groups`	Создать ссылку-приглашение.
DELETE`/v2/invites/{code}`	`groups`	Отозвать ссылку-приглашение.
POST`/v2/channel-messages/{id}/remove`	`groups`	Удалить из канала сообщение другого участника.
POST`/v2/communities/{id}/posts/{post}/remove`	`groups`	Удалить публикацию из группы.
DELETE`/v2/communities/{id}/members/{member}`	`groups`	Исключить участника из группы.
PUT`/v2/communities/{id}/members/{member}/timeout`	`groups`	Заглушить участника.
DELETE`/v2/communities/{id}/members/{member}/timeout`	`groups`	Снять заглушение.
GET`/v2/communities/{id}/bans`	`groups`	Действующие баны группы.
PUT`/v2/communities/{id}/bans/{member}`	`groups`	Забанить участника.
DELETE`/v2/communities/{id}/bans/{member}`	`groups`	Снять бан.
GET`/v2/communities/{id}/log`	`groups`	Журнал руководства: кто что удалил и почему.
POST`/v2/communities`	`groups`	Создать группу. Возвращает её `id`; ты её основатель.
PUT`/v2/communities/{id}`	`groups`	Изменить группу, которой ты руководишь. Что не указано, остаётся как есть.
Боты
GET`/v2/events`	`read`	События из групп бота начиная с события, постранично.
GET`/v2/events/stream`	`read`	События из групп бота, как только они происходят (server-sent events).
GET`/v2/me/commands`	`read`	Команды бота.
PUT`/v2/me/commands`	`write`	Задать команды бота, все сразу.
POST`/v2/interactions/{id}/reply`	`write`	Ответить на команду или кнопку.
POST`/v2/channels/{id}/voice`	`write`	Занять место в голосовом канале, чтобы проигрывать музыку или звук.
Обзор
GET`/v2/tags`	`read`	Теги, которые сейчас в ходу.
GET`/v2/search`	`read`	Поиск по постам, именам, коротким именам и тегам.
GET`/v2/emojis`	`read`	Собственные эмодзи сервера с адресами их картинок.
GIF и видео
GET`/v2/media`	`read`	Общие GIF или видео, сначала самые используемые.
GET`/v2/media/mine`	`media`	Твоя медиатека, сначала новое.
GET`/v2/media/{id}`	`read`	GIF или видео — твоё или общее.
POST`/v2/media/uploads`	`media`	Начать загрузку.
PUT`/v2/media/uploads/{upload}`	`media`	Отправить фрагмент файла.
POST`/v2/media/{id}`	`media`	Изменить одно из твоих GIF или видео.
DELETE`/v2/media/{id}`	`media`	Удалить одно из твоих GIF или видео.
Твой аккаунт
GET`/v2/me`	`read`	Твой собственный профиль с `id`, который ждут остальные пути.
GET`/v2/feed`	`read`	Твоя собственная лента в том виде, как её собирает приложение.
POST`/v2/me/pictures`	`write`	Загрузить изображение в виде байтов. Возвращает `id` и `url`; затем `id` используется как аватар, обложка или в посте.
PUT`/v2/me/profile`	`profile`	Изменить профиль: имя, «О себе», аватар, обложку и цвет профиля. Что не указано, остаётся как есть.
GET`/v2/me/emojis`	`read`	Твои собственные эмодзи.
POST`/v2/me/emojis/pictures`	`profile`	Загрузить изображение для своего эмодзи в виде байтов.
POST`/v2/me/emojis`	`profile`	Создать свой эмодзи. Возвращает все твои эмодзи.
DELETE`/v2/me/emojis/{name}`	`profile`	Удалить свой эмодзи. Возвращает остальные.
PUT`/v2/me/emojis/sharing`	`profile`	Решить, могут ли подписчики использовать твои эмодзи в своих текстах.
GET`/v2/me/webhooks`	`webhooks`	Твои вебхуки и их состояние.
POST`/v2/me/webhooks`	`webhooks`	Создать вебхук. Возвращает `id` и секрет для подписей, только в этот раз.
DELETE`/v2/me/webhooks/{id}`	`webhooks`	Удалить вебхук.
POST`/v2/me/webhooks/{id}/test`	`webhooks`	Отправить проверку на вебхук.
Уведомления
GET`/v2/notifications`	`read`	Твои уведомления, сначала новые.
POST`/v2/notifications/read`	`write`	Отметить уведомления прочитанными.
Сообщения
GET`/v2/conversations`	`read`	Твой ящик: по строке на переписку, сначала самая свежая.
GET`/v2/conversations/{with}/messages`	`read`	Сообщения одной переписки, сначала новые.
POST`/v2/conversations/{with}/messages`	`write`	Отправить сообщение в переписку.
POST`/v2/conversations/{with}/read`	`write`	Отметить все сообщения переписки прочитанными.
DELETE`/v2/conversations/{with}/messages/{id}`	`write`	Удалить своё сообщение.
POST`/v2/conversations/{with}/planned`	`write`	Запланировать сообщение на потом. Возвращает `id` запланированного сообщения.
GET`/v2/me/planned-messages`	`read`	Твои сообщения, которые ещё будут отправлены, по времени.
POST`/v2/me/planned-messages/{id}/send`	`write`	Отправить сейчас задержанное или неудавшееся запланированное сообщение.
DELETE`/v2/me/planned-messages/{id}`	`write`	Удалить запланированное сообщение до отправки.
Связи
POST`/v2/relations`	`write`	Отметить, сохранить, репостнуть, подписаться, вступить, заблокировать, скрыть — в зависимости от `kind`.
GET`/v2/profiles/{handle}/followers`	`read`	Кто подписан на профиль, новые сначала.
GET`/v2/profiles/{handle}/following`	`read`	На кого подписан профиль, новые сначала.
GET`/v2/me/relations`	`read`	Кого ты заблокировал, скрыл или заблокировал только для сообщений, новые сначала.
Подборки
GET`/v2/me/collections`	`read`	Твои подборки с числом постов в них.
POST`/v2/me/collections`	`write`	Создать подборку. Возвращает её `id`.
PUT`/v2/me/collections/{id}`	`write`	Переименовать подборку.
DELETE`/v2/me/collections/{id}`	`write`	Удалить подборку.
GET`/v2/me/collections/{id}/posts`	`read`	Посты подборки, как во вкладке сохранённого.
POST`/v2/me/collections/{id}/posts`	`write`	Положить пост в подборку или убрать его.
Подарки
GET`/v2/partner/quota`	`read`	Сколько ещё осталось в твоей квоте для подарков.
GET`/v2/partner/gifts`	`read`	Что ты подарил из квоты, кому и когда – сначала новые.
POST`/v2/partner/gifts`	`gifts`	Подарить участнику месяцы тарифа или искры из своей квоты.
GET`/v2/gift-drops`	`read`	Твои подарки под постами: сколько мест ещё свободно и как они оплачены.
POST`/v2/gift-drops`	`gifts`	Опубликовать пост с подарками, которые могут забрать другие.

Вход

Первый запрос любой программы: работает ли ключ и что ему можно?

GET`/v2`

Версия API и название этого сервера.

Право read
с ETag
с v2.0

Без слеша в конце: https://api.tellmelo.com/v2/ перенаправляет на https://api.tellmelo.com/v2 с 308, и не каждая программа следует за этим.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2"

Ответ

Отвечает одним Service.

Пример

{
  "name": "tellmelo",
  "version": "2.20",
  "scope": "read write",
  "rateLimit": {
    "limit": 120,
    "remaining": 117
  },
  "docs": "/developers/docs",
  "spec": "/api/v2/openapi.json"
}

Возможные статусы: 200304401429

Посты

Читать публичные посты, публиковать свои и снова удалять их.

GET`/v2/posts`

Публичные посты, сначала новые.

Право read
с пагинацией
с ETag
с v2.0

На публичных путях counts.likes и counts.reposts всегда 0, а pinned — false.

Посты в группах находятся не здесь, а в /communities/{id}/posts.

Параметры

Имя	Тип	Значение
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/posts?limit=20"

Ответ

Отвечает страницей Post в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
      "text": "The bees are back in the garden 🐝 #garden",
      "kind": "poll",
      "author": {
        "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
        "handle": "mara",
        "name": "Mara 🌻",
        "verified": true,
        "accountKind": "person"
      },
      "community": {
        "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
        "name": "Urban Gardening"
      },
      "media": [
        {
          "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
          "kind": "image",
          "poster": null,
          "ai": "without"
        }
      ],
      "poll": {
        "options": [
          {
            "text": "Lavender",
            "votes": 12
          },
          {
            "text": "Sunflowers",
            "votes": 7
          },
          {
            "text": "Clover",
            "votes": 3
          }
        ],
        "total": 22,
        "multiple": false,
        "endsAt": null,
        "running": true,
        "resultsVisible": true,
        "myVotes": [
          0
        ]
      },
      "quotes": null,
      "continues": null,
      "counts": {
        "replies": 4,
        "likes": 31,
        "reposts": 2
      },
      "pinned": false,
      "giftDrop": {
        "item": "plan",
        "quantity": 3,
        "places": 10,
        "left": 4,
        "audience": "followers",
        "newAccounts": false,
        "status": "open",
        "claimed": true
      },
      "createdAt": 1758624000000
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200304401429

GET`/v2/posts/{id}`

Один пост по его id.

Право read
с ETag
с v2.0

На публичных путях counts.likes и counts.reposts всегда 0, а pinned — false.

Посты в группах находятся не здесь, а в /communities/{id}/posts.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` поста.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1"

Ответ

Отвечает одним Post.

Пример

{
  "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
  "text": "The bees are back in the garden 🐝 #garden",
  "kind": "poll",
  "author": {
    "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
    "handle": "mara",
    "name": "Mara 🌻",
    "verified": true,
    "accountKind": "person"
  },
  "community": {
    "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
    "name": "Urban Gardening"
  },
  "media": [
    {
      "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
      "kind": "image",
      "poster": null,
      "ai": "without"
    }
  ],
  "poll": {
    "options": [
      {
        "text": "Lavender",
        "votes": 12
      },
      {
        "text": "Sunflowers",
        "votes": 7
      },
      {
        "text": "Clover",
        "votes": 3
      }
    ],
    "total": 22,
    "multiple": false,
    "endsAt": null,
    "running": true,
    "resultsVisible": true,
    "myVotes": [
      0
    ]
  },
  "quotes": null,
  "continues": null,
  "counts": {
    "replies": 4,
    "likes": 31,
    "reposts": 2
  },
  "pinned": false,
  "giftDrop": {
    "item": "plan",
    "quantity": 3,
    "places": 10,
    "left": 4,
    "audience": "followers",
    "newAccounts": false,
    "status": "open",
    "claimed": true
  },
  "createdAt": 1758624000000
}

Возможные статусы: 200304400401404429

POST`/v2/posts`

Опубликовать пост.

Право write
с v2.0

Посту нужен текст или опрос. Длину, варианты опроса и темп задаёт сервер; сверх этого ты получишь 400 или 429.

Прикрепляй изображения, GIF или видео через media. GIF или видео идёт отдельно. Общие GIF и видео других участников можно использовать в tellmelo.

Пост для близких друзей или с соавтором выходит сразу, не в группе и не по расписанию. Оба варианта сразу нельзя.

Параметры

Имя	Тип	Значение
`text`в теле	`string`необязательно	Текст поста, ответа или сообщения.
`community`в теле	`string`необязательно	`id` группы, в канал ленты которой идёт публикация; канал должен быть включён, и тебе нужно право на это. Без него публикация не относится ни к одной группе.
`quotes`в теле	`string`необязательно	`id` поста, который цитирует этот.
`poll`в теле	`string[]`необязательно	Варианты ответа списком текстов.
`media`в теле	`string[]`необязательно	ID изображений, загруженных в приложении, или GIF или видео из медиатеки (с 2.14).
`audience`в теле	`string`необязательно	Кто видит пост: `everyone` — все, кому можно, `close` — только близкие друзья.`everyoneclose`
`coauthor`в теле	`string`необязательно	`id` аккаунта, который ты приглашаешь в соавторы. Вы должны быть подписаны друг на друга.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"text":"The bees are back in the garden 🐝 #garden","audience":"everyone"}' \
  "https://api.tellmelo.com/v2/posts"

Ответ

Отвечает одним Created.

Пример

{
  "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
  "scheduledFor": null,
  "deleteAt": null
}

Возможные статусы: 200400401403429

DELETE`/v2/posts/{id}`

Удалить один из своих постов.

Право write
с v2.0

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` поста.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

GET`/v2/me/scheduled`

Твои посты, которые ещё не вышли, и чего они ждут.

Право read
с ETag
с v2.12

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/scheduled"

Ответ

Отвечает страницей ScheduledPost в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
      "text": "Market day tomorrow – see you at the bee stand! #garden",
      "communityId": null,
      "publishAt": 1758710400000,
      "deleteAt": null,
      "waitingFor": "time",
      "createdAt": 1758624000000
    }
  ],
  "next": null
}

Возможные статусы: 200304401429

POST`/v2/posts/{id}/schedule`

Изменить, когда выйдет запланированный пост или когда пост удалится сам.

Право write
с v2.12

Только свои посты. Пока подарки поста не оплачены, его нельзя запланировать.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` поста.
`publishAt`в теле	`integer`необязательно	Когда выйдет запланированный пост, в миллисекундах с 1970 года.
`deleteAt`в теле	`integer`необязательно	Когда пост удалится сам, в миллисекундах с 1970 года.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/schedule"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

POST`/v2/posts/{id}/edit`

Изменить текст своего поста.

Право write
с v2.12

Только в пределах времени на правку, которое даёт твой тариф. Запланированные посты править нельзя.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` поста.
`text`в теле	`string`обязательно	Текст поста, ответа или сообщения.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"text":"The bees are back in the garden 🐝🌻 #garden"}' \
  "https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/edit"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

GET`/v2/posts/{id}/reply-settings`

Кто может отвечать на твой пост, ждут ли ответы одобрения и медленный режим.

Право read
с ETag
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` поста.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/reply-settings"

Ответ

Отвечает одним ReplySettings.

Пример

{
  "audience": "following",
  "approval": false,
  "slow": "auto"
}

Возможные статусы: 200304400401404429

PUT`/v2/posts/{id}/reply-settings`

Изменить настройки ответов своего поста. То, что не указано, остаётся как есть.

Право write
с v2.19

Только свои посты.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` поста.
`audience`в теле	`string`необязательно	Кто может отвечать: все, аккаунты, на которые ты подписан, упомянутые или никто.`allfollowingmentionednobody`
`approval`в теле	`boolean`необязательно	Появляются ли ответы только после твоего одобрения.
`slow`в теле	`string`необязательно	Медленный режим: `auto` включается сам, когда приходит много ответов, `on` всегда, `off` никогда.`autoonoff`

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"audience":"following","approval":false,"slow":"auto"}' \
  "https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/reply-settings"

Ответ

Отвечает одним ReplySettings.

Пример

{
  "audience": "following",
  "approval": false,
  "slow": "auto"
}

Возможные статусы: 200400401403404429

POST`/v2/posts/{id}/coauthor`

Принять или отклонить приглашение стать соавтором.

Право write
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` поста.
`accept`в теле	`boolean`обязательно	`true` принимает приглашение, `false` отклоняет.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"accept":true}' \
  "https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/coauthor"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

DELETE`/v2/posts/{id}/coauthor`

Выйти из соавторов или, как автор, убрать соавтора с поста.

Право write
с v2.19

Для соавтора и автора поста.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` поста.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/coauthor"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

POST`/v2/posts/{id}/pin`

Закрепить свой пост вверху профиля или открепить его.

Право write
с v2.19

Только свои видимые посты. Сколько можно закрепить, зависит от подписки.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` поста.
`active`в теле	`boolean`обязательно	`true` закрепляет пост, `false` открепляет.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"active":true}' \
  "https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/pin"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

Ответы

Ответы под постом, списком с parentId.

GET`/v2/posts/{id}/replies`

Ответы на пост, без заблокированных аккаунтов.

Право read
с пагинацией
с ETag
с v2.0

Список плоский и идёт в порядке написания; parentId превращает его в дерево. Страница всегда содержит целые ветки. Ответы заблокированных аккаунтов исключены.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` поста.
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/replies?limit=20"

Ответ

Отвечает страницей Reply в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a",
      "text": "Same here, the lavender is full of them.",
      "kind": "post",
      "author": {
        "id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
        "handle": "jon",
        "name": "Jon",
        "verified": false,
        "accountKind": "person"
      },
      "community": null,
      "media": [],
      "poll": null,
      "quotes": null,
      "continues": null,
      "counts": {
        "replies": 0,
        "likes": 3,
        "reposts": 0
      },
      "pinned": false,
      "giftDrop": null,
      "createdAt": 1758624600000,
      "postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
      "parentId": null
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200304400401404429

POST`/v2/posts/{id}/replies`

Ответить на пост.

Право write
с v2.0

В медленном режиме — один ответ на человека раз в 10 минут, иначе 429. Автор и аккаунты, на которые он подписан, освобождены.

Через media — не больше одного изображения, GIF или видео.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` поста.
`text`в теле	`string`обязательно	Текст поста, ответа или сообщения.
`parentId`в теле	`string`необязательно	`id` ответа, на который отвечает этот. Без него — прямо к посту.
`media`в теле	`string[]`необязательно	ID изображений, загруженных в приложении, или GIF или видео из медиатеки (с 2.14).
`publishAt`в теле	`integer`необязательно	Когда опубликовать ответ, в миллисекундах с 1970 года. Без этого он уходит сразу.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"text":"Same here, the lavender is full of them."}' \
  "https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/replies"

Ответ

Отвечает одним Created.

Пример

{
  "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
  "scheduledFor": null,
  "deleteAt": null
}

Возможные статусы: 200400401403404429

POST`/v2/replies/{id}/edit`

Изменить текст своего ответа.

Право write
с v2.12

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	id ответа.
`text`в теле	`string`обязательно	Текст поста, ответа или сообщения.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"text":"Same here, the lavender and the clover are full of them."}' \
  "https://api.tellmelo.com/v2/replies/9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a/edit"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

DELETE`/v2/replies/{id}`

Удалить свой ответ.

Право write
с v2.12

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	id ответа.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/replies/9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

POST`/v2/replies/{id}/like`

Проголосовать «за» ответ (с тех пор как ответы оценивают голосами, отметка «нравится» — это голос «за») или отозвать голос; голос «против» остаётся.

Право write
с v2.12
устарело

Устарело с 2.19: используй POST /replies/{id}/vote. Пока этот маршрут остаётся.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	id ответа.
`active`в теле	`boolean`обязательно	`true` устанавливает связь, `false` снимает её.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"active":true}' \
  "https://api.tellmelo.com/v2/replies/9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a/like"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

POST`/v2/replies/{id}/vote`

Проголосовать за ответ или против него либо отозвать свой голос. Возвращает твой голос и итоговый рейтинг.

Право write
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	id ответа.
`vote`в теле	`string`обязательно	`up` — за, `down` — против, `none` отзывает твой голос.`updownnone`

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"vote":"up"}' \
  "https://api.tellmelo.com/v2/replies/9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a/vote"

Ответ

Отвечает одним ReplyVote.

Пример

{
  "vote": "up",
  "score": 12
}

Возможные статусы: 200400401403404429

POST`/v2/replies/{id}/pick`

Отметить ответ под своим постом как лучший или снять отметку.

Право write
с v2.19

Только под своими постами и только ответы прямо на пост. Новая отметка заменяет старую.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	id ответа.
`active`в теле	`boolean`обязательно	`true` отмечает ответ, `false` снимает отметку.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"active":true}' \
  "https://api.tellmelo.com/v2/replies/9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a/pick"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

GET`/v2/posts/{id}/replies/waiting`

Ответы под постом, ожидающие одобрения: под твоим — все, иначе только твои.

Право read
с ETag
с v2.19

Ждут ли ответы одобрения, автор задаёт в настройках ответов.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` поста.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/replies/waiting"

Ответ

Отвечает страницей Reply в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a",
      "text": "Same here, the lavender is full of them.",
      "kind": "post",
      "author": {
        "id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
        "handle": "jon",
        "name": "Jon",
        "verified": false,
        "accountKind": "person"
      },
      "community": null,
      "media": [],
      "poll": null,
      "quotes": null,
      "continues": null,
      "counts": {
        "replies": 0,
        "likes": 3,
        "reposts": 0
      },
      "pinned": false,
      "giftDrop": null,
      "createdAt": 1758624600000,
      "postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
      "parentId": null
    }
  ],
  "next": null
}

Возможные статусы: 200304400401404429

POST`/v2/replies/{id}/decide`

Одобрить или отклонить ожидающий ответ под своим постом. Отклонённый удаляется.

Право write
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	id ответа.
`approve`в теле	`boolean`обязательно	`true` одобряет ответ, `false` отклоняет.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"approve":true}' \
  "https://api.tellmelo.com/v2/replies/9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a/decide"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

GET`/v2/posts/{id}/replies/planned`

Твои ответы под постом, запланированные на потом.

Право read
с ETag
с v2.19

Ответ планируется через publishAt при ответе. Не более 20 запланированных ответов одновременно.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` поста.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/replies/planned"

Ответ

Отвечает страницей PlannedReply в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9",
      "parentId": null,
      "text": "Count me in for Saturday!",
      "publishAt": 1758710400000,
      "state": "waiting"
    }
  ],
  "next": null
}

Возможные статусы: 200304400401404429

PUT`/v2/me/planned-replies/{id}`

Изменить текст или время запланированного ответа. Неудавшийся снова ждёт.

Право write
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` запланированного ответа.
`text`в теле	`string`необязательно	Текст поста, ответа или сообщения.
`publishAt`в теле	`integer`необязательно	Когда опубликовать ответ, в миллисекундах с 1970 года. Без этого он уходит сразу.

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"text":"See you there!","publishAt":1758700000000}' \
  "https://api.tellmelo.com/v2/me/planned-replies/3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

POST`/v2/me/planned-replies/{id}/send`

Отправить запланированный ответ сразу.

Право write
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` запланированного ответа.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/planned-replies/3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9/send"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

DELETE`/v2/me/planned-replies/{id}`

Удалить запланированный ответ.

Право write
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` запланированного ответа.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/planned-replies/3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

Опросы

Опрос — это пост, у которого задан poll. У голосования свой путь.

POST`/v2/posts/{id}/vote`

Принять участие в опросе.

Право write
с v2.0

Голоса по вариантам равны null, пока ты не проголосовал или опрос не закончился. total есть всегда.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` поста.
`option`в теле	`integer`обязательно	Какой вариант, считая с 0. При множественном выборе вызывай по разу на вариант.
`retract`в теле	`boolean`необязательно	`true` отзывает голос.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"option":0}' \
  "https://api.tellmelo.com/v2/posts/5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1/vote"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

Профили

Публичные профили по короткому имени и то, что они опубликовали.

GET`/v2/profiles/{handle}`

Профиль по его короткому имени.

Право read
с ETag
с v2.0

Параметры

Имя	Тип	Значение
`handle`в пути	`string`обязательно	Короткое имя профиля, регистр букв не важен.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/profiles/mara"

Ответ

Отвечает одним Profile.

Пример

{
  "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
  "handle": "mara",
  "name": "Mara 🌻",
  "verified": true,
  "accountKind": "person",
  "about": "Beekeeper, allotment, too many seeds. :tellmelo:",
  "website": "https://mara-imkerei.example/",
  "websiteVerified": true,
  "followers": 148,
  "createdAt": 1750848000000
}

Возможные статусы: 200304400401404429

GET`/v2/profiles/{handle}/posts`

Публичные посты одного профиля, сначала новые.

Право read
с пагинацией
с ETag
с v2.0

На публичных путях counts.likes и counts.reposts всегда 0, а pinned — false.

Посты в группах находятся не здесь, а в /communities/{id}/posts.

Параметры

Имя	Тип	Значение
`handle`в пути	`string`обязательно	Короткое имя профиля, регистр букв не важен.
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/profiles/mara/posts?limit=20"

Ответ

Отвечает страницей Post в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
      "text": "The bees are back in the garden 🐝 #garden",
      "kind": "poll",
      "author": {
        "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
        "handle": "mara",
        "name": "Mara 🌻",
        "verified": true,
        "accountKind": "person"
      },
      "community": {
        "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
        "name": "Urban Gardening"
      },
      "media": [
        {
          "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
          "kind": "image",
          "poster": null,
          "ai": "without"
        }
      ],
      "poll": {
        "options": [
          {
            "text": "Lavender",
            "votes": 12
          },
          {
            "text": "Sunflowers",
            "votes": 7
          },
          {
            "text": "Clover",
            "votes": 3
          }
        ],
        "total": 22,
        "multiple": false,
        "endsAt": null,
        "running": true,
        "resultsVisible": true,
        "myVotes": [
          0
        ]
      },
      "quotes": null,
      "continues": null,
      "counts": {
        "replies": 4,
        "likes": 31,
        "reposts": 2
      },
      "pinned": false,
      "giftDrop": {
        "item": "plan",
        "quantity": 3,
        "places": 10,
        "left": 4,
        "audience": "followers",
        "newAccounts": false,
        "status": "open",
        "claimed": true
      },
      "createdAt": 1758624000000
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200304400401404429

GET`/v2/profiles/{handle}/events`

Предстоящие события профиля, ближайшие сначала.

Право read
с ETag
с v2.19

Только пока подписка профиля включает события. Ничего между аккаунтами, которые заблокировали друг друга.

Параметры

Имя	Тип	Значение
`handle`в пути	`string`обязательно	Короткое имя профиля, регистр букв не важен.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/profiles/mara/events"

Ответ

Отвечает страницей Event в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "2a3b4c5d-6e7f-4809-9a1b-2c3d4e5f6a7b",
      "title": "Seed swap",
      "startsAt": 1758883200000,
      "endsAt": 1758890400000,
      "place": "Community garden",
      "description": "Bring seeds, take seeds.",
      "signups": {
        "count": 14,
        "going": true
      }
    }
  ],
  "next": null
}

Возможные статусы: 200304400401404429

POST`/v2/me/events`

Создать событие. Возвращает его id.

Право write
с v2.19

Нужна подписка с событиями, иначе 403. Сколько может быть предстоящих, зависит от подписки.

Параметры

Имя	Тип	Значение
`title`в теле	`string`обязательно	Название.
`startsAt`в теле	`integer`обязательно	Начало, в миллисекундах с 1970 года.
`endsAt`в теле	`integer`необязательно	Конец, в миллисекундах с 1970 года. Необязательно.
`place`в теле	`string`необязательно	Где оно проходит.
`description`в теле	`string`необязательно	Описание.
`signups`в теле	`boolean`необязательно	Можно ли записаться. Нужна подписка с записью.
`capacity`в теле	`integer`необязательно	Сколько человек могут записаться максимум. Без указания — без ограничения.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"title":"Seed swap","startsAt":1758700000000,"place":"Community garden","signups":true,"capacity":30}' \
  "https://api.tellmelo.com/v2/me/events"

Ответ

Отвечает одним Made.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}

Возможные статусы: 200400401403429

PUT`/v2/me/events/{id}`

Изменить своё событие. Все поля задаются заново.

Право write
с v2.19

Уже начавшееся событие сохраняет своё начало.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` события.
`title`в теле	`string`обязательно	Название.
`startsAt`в теле	`integer`обязательно	Начало, в миллисекундах с 1970 года.
`endsAt`в теле	`integer`необязательно	Конец, в миллисекундах с 1970 года. Необязательно.
`place`в теле	`string`необязательно	Где оно проходит.
`description`в теле	`string`необязательно	Описание.
`signups`в теле	`boolean`необязательно	Можно ли записаться. Нужна подписка с записью.
`capacity`в теле	`integer`необязательно	Сколько человек могут записаться максимум. Без указания — без ограничения.

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"title":"Seed swap","startsAt":1758700000000,"place":"Community garden","signups":true,"capacity":30}' \
  "https://api.tellmelo.com/v2/me/events/2a3b4c5d-6e7f-4809-9a1b-2c3d4e5f6a7b"

Ответ

Отвечает одним Made.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}

Возможные статусы: 200400401403404429

DELETE`/v2/me/events/{id}`

Удалить своё событие.

Право write
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` события.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/events/2a3b4c5d-6e7f-4809-9a1b-2c3d4e5f6a7b"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

GET`/v2/me/events/{id}/signups`

Кто записался на твоё событие.

Право read
с ETag
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` события.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/events/2a3b4c5d-6e7f-4809-9a1b-2c3d4e5f6a7b/signups"

Ответ

Отвечает страницей EventSignup в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
      "handle": "mara",
      "name": "Mara 🌻",
      "at": 1758624000000
    }
  ],
  "next": null
}

Возможные статусы: 200304400401404429

POST`/v2/events/{id}/signup`

Записаться на событие или отменить запись.

Право write
с v2.19

Только для событий с записью, не для своих. Если мест нет, 409.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` события.
`going`в теле	`boolean`обязательно	`true` записывает тебя, `false` отменяет запись.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"going":true}' \
  "https://api.tellmelo.com/v2/events/2a3b4c5d-6e7f-4809-9a1b-2c3d4e5f6a7b/signup"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

Группы

Открытые группы и твои собственные, их публикации, участники, роли и ссылки-приглашения.

GET`/v2/communities`

Открытые группы этого сервера; с mine=true — группы твоего аккаунта.

Право read
с ETag
с v2.0

Отсортированы по числу участников и без пагинации; next всегда null.

Параметры

Имя	Тип	Значение
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`mine`в query	`boolean`необязательно	`true` — группы твоего аккаунта, включая внутренние и скрытые, по названию.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities?limit=20"

Ответ

Отвечает страницей Community в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
      "name": "Urban Gardening",
      "handle": "urbangardening",
      "description": "Balconies, allotments, rooftops: whatever grows.",
      "tags": [
        "garden",
        "bees"
      ],
      "members": 312,
      "joinPolicy": "open",
      "visibility": "open",
      "feedChannel": true,
      "sparks": 24,
      "perks": [
        "tint",
        "welcome"
      ],
      "membership": {
        "leader": null,
        "roles": [
          "4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"
        ],
        "permissions": [
          "attach",
          "invite",
          "send",
          "view"
        ],
        "mutedUntil": null
      }
    }
  ],
  "next": null
}

Возможные статусы: 200304401429

GET`/v2/communities/{id}`

Одна группа по её id.

Право read
с ETag
с v2.0

Внутренние и скрытые группы — только если твой аккаунт в них состоит.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60"

Ответ

Отвечает одним Community.

Пример

{
  "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
  "name": "Urban Gardening",
  "handle": "urbangardening",
  "description": "Balconies, allotments, rooftops: whatever grows.",
  "tags": [
    "garden",
    "bees"
  ],
  "members": 312,
  "joinPolicy": "open",
  "visibility": "open",
  "feedChannel": true,
  "sparks": 24,
  "perks": [
    "tint",
    "welcome"
  ],
  "membership": {
    "leader": null,
    "roles": [
      "4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"
    ],
    "permissions": [
      "attach",
      "invite",
      "send",
      "view"
    ],
    "mutedUntil": null
  }
}

Возможные статусы: 200304400401404429

GET`/v2/communities/{id}/posts`

Публикации канала ленты группы, сначала новые.

Право read
с пагинацией
с ETag
с v2.0

На публичных путях counts.likes и counts.reposts всегда 0, а pinned — false.

Если канал ленты выключен, путь отвечает 409 с feed_off.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/posts?limit=20"

Ответ

Отвечает страницей Post в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
      "text": "The bees are back in the garden 🐝 #garden",
      "kind": "poll",
      "author": {
        "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
        "handle": "mara",
        "name": "Mara 🌻",
        "verified": true,
        "accountKind": "person"
      },
      "community": {
        "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
        "name": "Urban Gardening"
      },
      "media": [
        {
          "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
          "kind": "image",
          "poster": null,
          "ai": "without"
        }
      ],
      "poll": {
        "options": [
          {
            "text": "Lavender",
            "votes": 12
          },
          {
            "text": "Sunflowers",
            "votes": 7
          },
          {
            "text": "Clover",
            "votes": 3
          }
        ],
        "total": 22,
        "multiple": false,
        "endsAt": null,
        "running": true,
        "resultsVisible": true,
        "myVotes": [
          0
        ]
      },
      "quotes": null,
      "continues": null,
      "counts": {
        "replies": 4,
        "likes": 31,
        "reposts": 2
      },
      "pinned": false,
      "giftDrop": {
        "item": "plan",
        "quantity": 3,
        "places": 10,
        "left": 4,
        "audience": "followers",
        "newAccounts": false,
        "status": "open",
        "claimed": true
      },
      "createdAt": 1758624000000
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200304400401404429

GET`/v2/communities/{id}/members`

Участники группы с их ролями.

Право read
с ETag
с v2.15

Сначала руководство, затем по высшей роли; не больше 300.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/members"

Ответ

Отвечает страницей GroupMember в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
      "handle": "jon",
      "name": "Jon",
      "bot": false,
      "leader": null,
      "roles": [
        "4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"
      ],
      "mutedUntil": null
    }
  ],
  "next": null
}

Возможные статусы: 200304400401404429

GET`/v2/communities/{id}/roles`

Роли группы, сначала высшая, @everyone последней.

Право read
с ETag
с v2.15

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/roles"

Ответ

Отвечает страницей Role в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8",
      "name": "Gardeners",
      "everyone": false,
      "color": "green",
      "permissions": [
        "attach",
        "invite",
        "send",
        "view"
      ],
      "members": 24,
      "editable": true,
      "selfable": false
    }
  ],
  "next": null
}

Возможные статусы: 200304400401404429

GET`/v2/communities/{id}/bell`

Какие уведомления присылает тебе группа.

Право read
с ETag
с v2.15

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/bell"

Ответ

Отвечает одним Bell.

Пример

{
  "level": "important"
}

Возможные статусы: 200304400401404429

GET`/v2/invites/{code}`

Группа за ссылкой-приглашением, до вступления.

Право read
с ETag
с v2.15

Параметры

Имя	Тип	Значение
`code`в пути	`string`обязательно	Код ссылки-приглашения, конец её адреса.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/invites/k7Qm2xPa"

Ответ

Отвечает одним InvitePreview.

Пример

{
  "community": {
    "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
    "name": "Urban Gardening",
    "members": 312,
    "rules": [
      "Be kind.",
      "No advertising."
    ]
  },
  "member": false
}

Возможные статусы: 200304400401404429

PUT`/v2/roles/{id}/self`

Взять или снять роль на выбор.

Право write
с v2.20

Только роли, которые руководство предлагает на выбор (selfable), и только для своего аккаунта.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` роли.
`active`в теле	`boolean`необязательно	`false` забирает роль; иначе она выдаётся.

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"active":true}' \
  "https://api.tellmelo.com/v2/roles/4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8/self"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

GET`/v2/communities/{id}/emojis`

Собственные эмодзи группы.

Право read
с ETag
с v2.20

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/emojis"

Ответ

Отвечает страницей GroupEmoji в виде `items` и `next`.

Пример

{
  "items": [
    {
      "name": "seedling",
      "url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
      "animated": false
    }
  ],
  "next": null
}

Возможные статусы: 200304400401404429

PUT`/v2/communities/{id}/bell`

Настроить, какие уведомления присылает тебе группа.

Право write
с v2.15

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`level`в теле	`string`обязательно	Какие уведомления приходят.`allimportantoff`

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"level":"important"}' \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/bell"

Ответ

Отвечает одним Bell.

Пример

{
  "level": "important"
}

Возможные статусы: 200400401403404429

POST`/v2/invites/{code}/join`

Вступить в группу по ссылке-приглашению.

Право write
с v2.15

Параметры

Имя	Тип	Значение
`code`в пути	`string`обязательно	Код ссылки-приглашения, конец её адреса.
`rules`в теле	`boolean`необязательно	`true`, если ты принимаешь правила группы; нужно, если они есть.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/invites/k7Qm2xPa/join"

Ответ

Отвечает одним Joined.

Пример

{
  "community": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60"
}

Возможные статусы: 200400401403404429

GET`/v2/communities/{id}/bots`

Боты группы и то, что разрешает их роль.

Право read
с ETag
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/bots"

Ответ

Отвечает страницей GroupBot в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
      "handle": "gardenbot",
      "name": "Garden bot",
      "description": "Reminds the group of watering days.",
      "permissions": [
        "send",
        "view"
      ]
    }
  ],
  "next": null
}

Возможные статусы: 200304400401404429

Каналы

Каналы твоих групп и их чат: читать, писать, отмечать прочитанным.

GET`/v2/communities/{id}/channels`

Каналы группы, которые ты видишь, по порядку.

Право read
с ETag
с v2.15

Канал ленты (kind: feed) есть здесь, только пока он включён; его публикации приходят через /communities/{id}/posts.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/channels"

Ответ

Отвечает страницей Channel в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a",
      "kind": "chat",
      "name": "harvest",
      "topic": "What came in this week",
      "category": {
        "id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
        "name": "Garden",
        "symbol": {
          "emoji": null,
          "icon": null,
          "image": null,
          "color": null,
          "shape": null
        }
      },
      "unread": 3,
      "permissions": [
        "view",
        "send"
      ],
      "symbol": {
        "emoji": "🌻",
        "icon": null,
        "image": null,
        "color": "amber",
        "shape": "circle"
      }
    }
  ],
  "next": null
}

Возможные статусы: 200304400401404429

GET`/v2/channels/{id}/messages`

Сообщения чат-канала, сначала новые.

Право read
с пагинацией
с ETag
с v2.15

До 50 сообщений на странице. Сообщений аккаунтов, которые ты заблокировал или которые заблокировали тебя, нет.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` канала.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.
`thread`в query	`string`необязательно	Сообщение, ветку которого читают: оно и ответы на него вместо чата.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a/messages"

Ответ

Отвечает страницей ChannelMessage в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "61a2b3c4-d5e6-4f70-8192-a3b4c5d6e7f8",
      "text": "@jon the first tomatoes are ripe 🍅",
      "author": {
        "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
        "handle": "mara",
        "name": "Mara 🌻",
        "bot": false
      },
      "media": [
        {
          "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
          "kind": "image",
          "poster": null,
          "ai": "without"
        }
      ],
      "replyTo": "72b3c4d5-e6f7-4081-92a3-b4c5d6e7f809",
      "roleColor": "green",
      "threadOf": null,
      "threadCount": 3,
      "card": null,
      "buttons": [],
      "createdAt": 1758631200000
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200304400401404429

POST`/v2/channels/{id}/messages`

Написать сообщение в чат-канал.

Право write
с v2.15

@имя уведомляет участника, @everyone с соответствующим правом — всех, не чаще шести раз в час.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` канала.
`text`в теле	`string`необязательно	Текст поста, ответа или сообщения.
`replyTo`в теле	`string`необязательно	`id` сообщения в том же канале, на которое ты отвечаешь.
`media`в теле	`string[]`необязательно	ID изображений, загруженных в приложении, или GIF или видео из медиатеки (с 2.14).
`thread`в теле	`string`необязательно	Сообщение чата, в ветке которого отвечают; без него сообщение уходит в чат.
`card`в теле	`object`необязательно	Карточка `{ title, text, color, fields: [{ name, value }] }`, не больше 10 полей.
`buttons`в теле	`object[]`необязательно	До 5 кнопок, каждая `{ id, label, style }` со `style` `primary`, `secondary` или `danger`. Нажатие приходит как событие `interaction`.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"text":"Who has seeds to swap?"}' \
  "https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a/messages"

Ответ

Отвечает одним Made.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}

Возможные статусы: 200400401403404429

POST`/v2/channels/{id}/read`

Отметить чат-канал прочитанным до момента времени.

Право write
с v2.15

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` канала.
`at`в теле	`integer`обязательно	До какого момента прочитано, в миллисекундах, обычно `createdAt` самого нового сообщения.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a/read"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

DELETE`/v2/channel-messages/{id}`

Удалить своё сообщение в чат-канале.

Право write
с v2.15

Только свои сообщения; чужие удаляет руководство с правом groups.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` сообщения в чат-канале.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/channel-messages/61a2b3c4-d5e6-4f70-8192-a3b4c5d6e7f8"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

GET`/v2/communities/{id}/voice`

Кто сейчас в голосовых каналах группы, по каналам.

Право read
с ETag
с v2.19

Только каналы, которые ты можешь видеть. Без медиасервера список пуст.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/voice"

Ответ

Отвечает страницей VoiceRoom в виде `items` и `next`.

Пример

{
  "items": [
    {
      "channel": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a",
      "people": [
        {
          "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
          "handle": "mara",
          "name": "Mara 🌻",
          "muted": false,
          "deaf": false,
          "camera": false,
          "screen": true
        }
      ]
    }
  ],
  "next": null
}

Возможные статусы: 200304400401404429

Управление группами

То, что умеют настройки группы в приложении, с правом groups. Что может твой аккаунт, решает группа так же, как в приложении: руководство, роли и их порядок.

POST`/v2/communities/{id}/emojis`

Добавить эмодзи группе.

Право groups
с v2.20

Только тот, кто может управлять каналами группы. Изображение загружается как собственное эмодзи (POST /me/emojis/pictures); имя занимается один раз среди всех эмодзи.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`name`в теле	`string`обязательно	Имя, которым ты пишешь эмодзи, как `:имя:`.
`picture`в теле	`string`обязательно	`id` из `POST /me/emojis/pictures`.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"seedling","picture":"8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9"}' \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/emojis"

Ответ

Отвечает страницей GroupEmoji в виде `items` и `next`.

Пример

{
  "items": [
    {
      "name": "seedling",
      "url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
      "animated": false
    }
  ],
  "next": null
}

Возможные статусы: 200400401403404429

DELETE`/v2/communities/{id}/emojis/{name}`

Удалить эмодзи из группы.

Право groups
с v2.20

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`name`в пути	`string`обязательно	Имя эмодзи, без двоеточий.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/emojis/seedling"

Ответ

Отвечает страницей GroupEmoji в виде `items` и `next`.

Пример

{
  "items": [
    {
      "name": "seedling",
      "url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
      "animated": false
    }
  ],
  "next": null
}

Возможные статусы: 200400401403404429

POST`/v2/communities/{id}/roles`

Создать роль.

Право groups
с v2.15

Только роли ниже твоей высшей и только права, которые есть у тебя самого; руководство стоит над всеми.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`name`в теле	`string`необязательно	Название роли; @everyone сохраняет своё.
`color`в теле	`string`необязательно	Цвет; пусто — без цвета.`indigovioletroseambergreenteal`
`permissions`в теле	`string[]`необязательно	Права: `view`, `send`, `attach`, `post_feed`, `invite`, `mention_everyone`, `moderate`, `timeout_members`, `kick_members`, `ban_members`, `manage_channels`, `manage_roles`.
`selfable`в теле	`boolean`необязательно	`true`: участники берут роль сами. Только для ролей, которые позволяют не больше, чем участвовать (view, send, attach, voice_connect, voice_speak, voice_video).

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Gardeners","permissions":["view","send","invite"],"selfable":false}' \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/roles"

Ответ

Отвечает одним Made.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}

Возможные статусы: 200400401403404429

PUT`/v2/roles/{id}`

Изменить название, цвет и права роли.

Право groups
с v2.15

Заменяет название, цвет и права; то, что ты не укажешь, станет пустым.

Только роли ниже твоей высшей и только права, которые есть у тебя самого; руководство стоит над всеми.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` роли.
`name`в теле	`string`необязательно	Название роли; @everyone сохраняет своё.
`color`в теле	`string`необязательно	Цвет; пусто — без цвета.`indigovioletroseambergreenteal`
`permissions`в теле	`string[]`необязательно	Права: `view`, `send`, `attach`, `post_feed`, `invite`, `mention_everyone`, `moderate`, `timeout_members`, `kick_members`, `ban_members`, `manage_channels`, `manage_roles`.
`selfable`в теле	`boolean`необязательно	`true`: участники берут роль сами. Только для ролей, которые позволяют не больше, чем участвовать (view, send, attach, voice_connect, voice_speak, voice_video).

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Gardeners","permissions":["view","send","invite"],"selfable":false}' \
  "https://api.tellmelo.com/v2/roles/4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"

Ответ

Отвечает одним Made.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}

Возможные статусы: 200400401403404429

DELETE`/v2/roles/{id}`

Удалить роль.

Право groups
с v2.15

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` роли.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/roles/4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

PUT`/v2/communities/{id}/roles/order`

Задать порядок ролей.

Право groups
с v2.15

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`roles`в теле	`string[]`обязательно	`id` всех ролей ниже твоей самой высокой, самая высокая первой; для руководства — все, кроме @everyone.

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/roles/order"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

PUT`/v2/roles/{id}/members/{member}`

Выдать участнику роль или забрать её.

Право groups
с v2.15

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` роли.
`member`в пути	`string`обязательно	`id` аккаунта участника.
`active`в теле	`boolean`необязательно	`false` забирает роль; иначе она выдаётся.

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"active":true}' \
  "https://api.tellmelo.com/v2/roles/4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8/members/d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

POST`/v2/communities/{id}/channels`

Создать чат-канал.

Право groups
с v2.15

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`name`в теле	`string`необязательно	Название без `#`; пусто — название, которое приложение даёт на каждом языке.
`topic`в теле	`string`необязательно	Тема, которая показывается над каналом.
`category`в теле	`string`необязательно	`id` категории, в которую попадает канал; пусто — без категории.
`emoji`в теле	`string`необязательно	Эмодзи в качестве символа.
`icon`в теле	`string`необязательно	Символ из набора приложения, по имени.`homehashmegaphonevolumemessagehelpinfobellcalendarbookbookmarkpinshieldstarheartsparklesflamezaptrophygiftrocketlightbulbcodewrenchbriefcasegraduationpalettecamerafilmmusicgamepaddumbbellleafflowerpawsunmooncloudglobemapcoffeepizzasmile`
`image`в теле	`string`необязательно	ID картинки, загруженной через `/media/emoji`.
`color`в теле	`string`необязательно	Цвет плитки.`brandindigovioletroseambergreentealred`
`shape`в теле	`string`необязательно	Форма плитки; без неё — круг.`circlesquaretrianglediamondhexagonoctagonshieldstar`

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"harvest","emoji":"🌻","color":"amber"}' \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/channels"

Ответ

Отвечает одним Made.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}

Возможные статусы: 200400401403404429

PUT`/v2/channels/{id}`

Изменить название, тему и категорию канала.

Право groups
с v2.15

Заменяет название, тему и категорию; то, что ты не укажешь, станет пустым.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` канала.
`name`в теле	`string`необязательно	Название без `#`; пусто — название, которое приложение даёт на каждом языке.
`topic`в теле	`string`необязательно	Тема, которая показывается над каналом.
`category`в теле	`string`необязательно	`id` категории, в которую попадает канал; пусто — без категории.
`emoji`в теле	`string`необязательно	Эмодзи в качестве символа.
`icon`в теле	`string`необязательно	Символ из набора приложения, по имени.`homehashmegaphonevolumemessagehelpinfobellcalendarbookbookmarkpinshieldstarheartsparklesflamezaptrophygiftrocketlightbulbcodewrenchbriefcasegraduationpalettecamerafilmmusicgamepaddumbbellleafflowerpawsunmooncloudglobemapcoffeepizzasmile`
`image`в теле	`string`необязательно	ID картинки, загруженной через `/media/emoji`.
`color`в теле	`string`необязательно	Цвет плитки.`brandindigovioletroseambergreentealred`
`shape`в теле	`string`необязательно	Форма плитки; без неё — круг.`circlesquaretrianglediamondhexagonoctagonshieldstar`

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"harvest","emoji":"🌻","color":"amber"}' \
  "https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"

Ответ

Отвечает одним Made.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}

Возможные статусы: 200400401403404429

DELETE`/v2/channels/{id}`

Удалить чат-канал вместе с сообщениями.

Право groups
с v2.15

Канал ленты нельзя удалить, только выключить.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` канала.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

PUT`/v2/communities/{id}/channels/order`

Задать порядок категорий и чат-каналов.

Право groups
с v2.15

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`categories`в теле	`string[]`обязательно	`id` всех категорий группы в новом порядке.
`channels`в теле	`string[]`обязательно	`id` всех чат-каналов группы в новом порядке.

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/channels/order"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

PUT`/v2/communities/{id}/channels/shape`

Задать форму всех символов каналов группы.

Право groups
с v2.20

Только руководство группы.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`shape`в теле	`string`необязательно	Форма всех символов группы; если не указана, у каждого канала своя.`circlesquaretrianglediamondhexagonoctagonshieldstar`

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/channels/shape"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

GET`/v2/channels/{id}/overrides`

Что роли могут в канале иначе, чем в группе.

Право groups
с ETag
с v2.15

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` канала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a/overrides"

Ответ

Отвечает страницей ChannelOverride в виде `items` и `next`.

Пример

{
  "items": [
    {
      "role": "4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8",
      "allow": [
        "send"
      ],
      "deny": []
    }
  ],
  "next": null
}

Возможные статусы: 200304400401403404429

PUT`/v2/channels/{id}/overrides/{role}`

Задать, что роль может в канале иначе.

Право groups
с v2.15

Не для ролей на уровне твоей высшей роли или выше.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` канала.
`role`в пути	`string`обязательно	`id` роли.
`allow`в теле	`string[]`необязательно	Что роль может здесь дополнительно: в чате `view`, `send`, `attach`, `mention_everyone`, `moderate`, в канале ленты `view` и `post_feed`.
`deny`в теле	`string[]`необязательно	Что роль здесь не может, из тех же прав. Оба пустых списка снимают отличие.

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"allow":["view"],"deny":["send"]}' \
  "https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a/overrides/4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

POST`/v2/communities/{id}/categories`

Создать категорию для каналов.

Право groups
с v2.15

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`name`в теле	`string`обязательно	Название категории.
`emoji`в теле	`string`необязательно	Эмодзи в качестве символа.
`icon`в теле	`string`необязательно	Символ из набора приложения, по имени.`homehashmegaphonevolumemessagehelpinfobellcalendarbookbookmarkpinshieldstarheartsparklesflamezaptrophygiftrocketlightbulbcodewrenchbriefcasegraduationpalettecamerafilmmusicgamepaddumbbellleafflowerpawsunmooncloudglobemapcoffeepizzasmile`
`image`в теле	`string`необязательно	ID картинки, загруженной через `/media/emoji`.
`color`в теле	`string`необязательно	Цвет плитки.`brandindigovioletroseambergreentealred`

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Garden","emoji":"🌻","color":"amber"}' \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/categories"

Ответ

Отвечает одним Made.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}

Возможные статусы: 200400401403404429

PUT`/v2/categories/{id}`

Переименовать категорию.

Право groups
с v2.15

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` категории.
`name`в теле	`string`обязательно	Название категории.
`emoji`в теле	`string`необязательно	Эмодзи в качестве символа.
`icon`в теле	`string`необязательно	Символ из набора приложения, по имени.`homehashmegaphonevolumemessagehelpinfobellcalendarbookbookmarkpinshieldstarheartsparklesflamezaptrophygiftrocketlightbulbcodewrenchbriefcasegraduationpalettecamerafilmmusicgamepaddumbbellleafflowerpawsunmooncloudglobemapcoffeepizzasmile`
`image`в теле	`string`необязательно	ID картинки, загруженной через `/media/emoji`.
`color`в теле	`string`необязательно	Цвет плитки.`brandindigovioletroseambergreentealred`

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Garden","emoji":"🌻","color":"amber"}' \
  "https://api.tellmelo.com/v2/categories/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"

Ответ

Отвечает одним Made.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}

Возможные статусы: 200400401403404429

DELETE`/v2/categories/{id}`

Удалить категорию.

Право groups
с v2.15

Её каналы остаются, без категории.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` категории.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/categories/9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

PUT`/v2/communities/{id}/feed`

Включить или выключить канал ленты группы.

Право groups
с v2.15

Когда он выключен, публикации хранятся, но видят их только авторы.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`on`в теле	`boolean`обязательно	`true` включает канал ленты, `false` выключает.

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/feed"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

GET`/v2/communities/{id}/invites`

Ссылки-приглашения группы, которые ещё действуют.

Право groups
с ETag
с v2.15

Руководство видит все, остальные — только свои.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/invites"

Ответ

Отвечает страницей InviteLink в виде `items` и `next`.

Пример

{
  "items": [
    {
      "code": "k7Qm2xPa",
      "url": "https://tellmelo.com/groups?join=k7Qm2xPa",
      "createdBy": {
        "id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
        "handle": "jon",
        "name": "Jon",
        "bot": false
      },
      "createdAt": 1758624000000,
      "expiresAt": 1759228800000,
      "uses": 3,
      "maxUses": 10
    }
  ],
  "next": null
}

Возможные статусы: 200304400401403404429

POST`/v2/communities/{id}/invites`

Создать ссылку-приглашение.

Право groups
с v2.15

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

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`days`в теле	`integer`необязательно	Сколько дней действует ссылка; без этого — пока её не отзовут.`1730`
`uses`в теле	`integer`необязательно	Сколько раз можно использовать ссылку; без этого — без ограничений.`151025100`

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"days":7,"uses":10}' \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/invites"

Ответ

Отвечает одним Made.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}

Возможные статусы: 200400401403404429

DELETE`/v2/invites/{code}`

Отозвать ссылку-приглашение.

Право groups
с v2.15

Параметры

Имя	Тип	Значение
`code`в пути	`string`обязательно	Код ссылки-приглашения, конец её адреса.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/invites/k7Qm2xPa"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

POST`/v2/channel-messages/{id}/remove`

Удалить из канала сообщение другого участника.

Право groups
с v2.15

С записью в журнале группы и не больше 60 в час, как в приложении.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` сообщения в чат-канале.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/channel-messages/61a2b3c4-d5e6-4f70-8192-a3b4c5d6e7f8/remove"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

POST`/v2/communities/{id}/posts/{post}/remove`

Удалить публикацию из группы.

Право groups
с v2.15

С записью в журнале группы и не больше 60 в час, как в приложении.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`post`в пути	`string`обязательно	`id` поста.
`reason`в теле	`string`обязательно	Обоснование, которое прочитает участник.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Advertising for another site, despite rule 2."}' \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/posts/post/remove"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

DELETE`/v2/communities/{id}/members/{member}`

Исключить участника из группы.

Право groups
с v2.15

С 2.16 это исключение: участник может вернуться. Кто должен остаться за дверью, получает бан.

Только с нужным правом и только для участников ниже твоей высшей роли; соруководителей — только основатель.

С записью в журнале группы и не больше 60 в час, как в приложении.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`member`в пути	`string`обязательно	`id` аккаунта участника.
`reason`в теле	`string`обязательно	Обоснование, которое прочитает участник.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"reason":"Advertising for another site, despite rule 2."}' \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/members/d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

PUT`/v2/communities/{id}/members/{member}/timeout`

Заглушить участника.

Право groups
с v2.16

Новое заглушение заменяет текущее. Выход и повторное вступление его не отменяют.

Только с нужным правом и только для участников ниже твоей высшей роли; соруководителей — только основатель.

С записью в журнале группы и не больше 60 в час, как в приложении.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`member`в пути	`string`обязательно	`id` аккаунта участника.
`seconds`в теле	`integer`обязательно	На сколько, в секундах.`60300600360086400604800`
`reason`в теле	`string`необязательно	Причина, которую прочтёт участник; по желанию.

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"seconds":600}' \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/members/d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d/timeout"

Ответ

Отвечает одним Until.

Пример

{
  "until": 1758624600000
}

Возможные статусы: 200400401403404429

DELETE`/v2/communities/{id}/members/{member}/timeout`

Снять заглушение.

Право groups
с v2.16

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`member`в пути	`string`обязательно	`id` аккаунта участника.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/members/d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d/timeout"

Ответ

Отвечает одним Until.

Пример

{
  "until": 1758624600000
}

Возможные статусы: 200400401403404429

GET`/v2/communities/{id}/bans`

Действующие баны группы.

Право groups
с ETag
с v2.16

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/bans"

Ответ

Отвечает страницей Ban в виде `items` и `next`.

Пример

{
  "items": [
    {
      "member": {
        "id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
        "handle": "jon",
        "name": "Jon",
        "bot": false
      },
      "until": 1759228800000,
      "createdAt": 1758624000000,
      "by": "Mara 🌻"
    }
  ],
  "next": null
}

Возможные статусы: 200304400401403404429

PUT`/v2/communities/{id}/bans/{member}`

Забанить участника.

Право groups
с v2.16

Без days бан действует, пока его не снимут.

Только с нужным правом и только для участников ниже твоей высшей роли; соруководителей — только основатель.

С записью в журнале группы и не больше 60 в час, как в приложении.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`member`в пути	`string`обязательно	`id` аккаунта участника.
`days`в теле	`integer`необязательно	На сколько, в днях; не указывай для бессрочного бана.`1730`
`reason`в теле	`string`обязательно	Обоснование, которое прочитает участник.

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"days":7,"reason":"Advertising for another site, despite rule 2."}' \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/bans/d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d"

Ответ

Отвечает одним Until.

Пример

{
  "until": 1758624600000
}

Возможные статусы: 200400401403404429

DELETE`/v2/communities/{id}/bans/{member}`

Снять бан.

Право groups
с v2.16

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`member`в пути	`string`обязательно	`id` аккаунта участника.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/bans/d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

GET`/v2/communities/{id}/log`

Журнал руководства: кто что удалил и почему.

Право groups
с ETag
с v2.15

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60/log"

Ответ

Отвечает страницей LogEntry в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "8f7e6d5c-4b3a-4291-8f7e-6d5c4b3a2918",
      "action": "message_removed",
      "member": {
        "id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
        "handle": "jon",
        "name": "Jon",
        "bot": false
      },
      "reason": "",
      "by": "Mara 🌻",
      "createdAt": 1758710400000
    }
  ],
  "next": null
}

Возможные статусы: 200304400401403404429

POST`/v2/communities`

Создать группу. Возвращает её id; ты её основатель.

Право groups
с v2.19

Нужно разрешение groups. Без указания группа internal со свободным вступлением; скрытая — только по приглашению. Могут ли участники создавать группы, решает оператор.

Параметры

Имя	Тип	Значение
`name`в теле	`string`обязательно	Название, не длиннее 60 символов.
`description`в теле	`string`необязательно	Описание, не длиннее 240 символов.
`handle`в теле	`string`необязательно	Короткое имя для упоминаний @# и ссылки: от 3 до 30 строчных букв, цифр или `_`.
`tags`в теле	`string[]`необязательно	До 5 #тегов о теме группы.
`joinPolicy`в теле	`string`необязательно	Как вступить: `open` свободно, `application` по заявке, `invite` только по приглашению.`openapplicationinvite`
`visibility`в теле	`string`необязательно	Кто видит группу: `open` все, `internal` её содержимое только участники, `hidden` вообще только участники.`openinternalhidden`

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Seed swap","handle":"seedswap","tags":["garden","seeds"],"joinPolicy":"open","visibility":"open"}' \
  "https://api.tellmelo.com/v2/communities"

Ответ

Отвечает одним Made.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}

Возможные статусы: 200400401403429

PUT`/v2/communities/{id}`

Изменить группу, которой ты руководишь. Что не указано, остаётся как есть.

Право groups
с v2.19

Нужно разрешение groups и руководство группой. Руководство, роспуск и бонусы искр остаются в приложении.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` группы.
`name`в теле	`string`необязательно	Название, не длиннее 60 символов.
`description`в теле	`string`необязательно	Описание, не длиннее 240 символов.
`handle`в теле	`string`необязательно	Короткое имя для упоминаний @# и ссылки: от 3 до 30 строчных букв, цифр или `_`.
`tags`в теле	`string[]`необязательно	До 5 #тегов о теме группы.
`joinPolicy`в теле	`string`необязательно	Как вступить: `open` свободно, `application` по заявке, `invite` только по приглашению.`openapplicationinvite`
`visibility`в теле	`string`необязательно	Кто видит группу: `open` все, `internal` её содержимое только участники, `hidden` вообще только участники.`openinternalhidden`
`image`в теле	`string`необязательно	`id` загруженного изображения (`POST /me/pictures`) для картинки группы. Пусто — удалить.
`banner`в теле	`string`необязательно	`id` загруженного изображения для обложки группы. Пусто — удалить.

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Seed swap","handle":"seedswap","tags":["garden","seeds"],"joinPolicy":"open","visibility":"open"}' \
  "https://api.tellmelo.com/v2/communities/c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

Боты

Что происходит в группах бота, в реальном времени: потоком, постранично или с доставкой на адрес.

GET`/v2/events`

События из групп бота начиная с события, постранично.

Право read
с v2.20

Только с токеном бота. События канала — только если бот может его видеть.

События хранятся один день. next — номер последнего, как since для следующей страницы.

Параметры

Имя	Тип	Значение
`since`в query	`string`необязательно	Номер последнего события, которое у бота уже есть. Без него поток начинается сейчас, а список — с самого старого.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/events?since=0"

Ответ

Отвечает страницей BotEvent в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "4711",
      "type": "message.created",
      "community": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
      "channel": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a",
      "createdAt": 1758634800000,
      "data": {
        "message": {
          "id": "61a2b3c4-d5e6-4f70-8192-a3b4c5d6e7f8",
          "text": "/dice 6",
          "author": {
            "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
            "handle": "mara",
            "name": "Mara 🌻",
            "bot": false
          },
          "media": 0,
          "replyTo": null,
          "threadOf": null,
          "createdAt": 1758634800000
        }
      }
    }
  ],
  "next": null
}

Возможные статусы: 200401429

GET`/v2/events/stream`

События из групп бота, как только они происходят (server-sent events).

Право read
с ETag
с v2.20

Соединение остаётся открытым и закрывается через десять минут; клиент переподключается и отправляет Last-Event-ID.

Только с токеном бота. События канала — только если бот может его видеть.

Параметры

Имя	Тип	Значение
`since`в query	`string`необязательно	Номер последнего события, которое у бота уже есть. Без него поток начинается сейчас, а список — с самого старого.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/events/stream?since=0"

Ответ

Отвечает одним BotEvent.

Пример

{
  "id": "4711",
  "type": "message.created",
  "community": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
  "channel": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a",
  "createdAt": 1758634800000,
  "data": {
    "message": {
      "id": "61a2b3c4-d5e6-4f70-8192-a3b4c5d6e7f8",
      "text": "/dice 6",
      "author": {
        "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
        "handle": "mara",
        "name": "Mara 🌻",
        "bot": false
      },
      "media": 0,
      "replyTo": null,
      "threadOf": null,
      "createdAt": 1758634800000
    }
  }
}

Возможные статусы: 200304401429

GET`/v2/me/commands`

Команды бота.

Право read
с ETag
с v2.20

Только с токеном бота. События канала — только если бот может его видеть.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/commands"

Ответ

Отвечает страницей BotCommand в виде `items` и `next`.

Пример

{
  "items": [
    {
      "name": "dice",
      "description": "Rolls a die"
    }
  ],
  "next": null
}

Возможные статусы: 200304401429

PUT`/v2/me/commands`

Задать команды бота, все сразу.

Право write
с v2.20

Заменяет все команды; пустой список убирает их. В чатах, которые бот может видеть, поле ввода предлагает их после «/».

Параметры

Имя	Тип	Значение
`commands`в теле	`object[]`обязательно	До 25 команд, каждая `{ name, description }`.

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"commands":[{"name":"dice","description":"Rolls a die"}]}' \
  "https://api.tellmelo.com/v2/me/commands"

Ответ

Отвечает страницей BotCommand в виде `items` и `next`.

Пример

{
  "items": [
    {
      "name": "dice",
      "description": "Rolls a die"
    }
  ],
  "next": null
}

Возможные статусы: 200400401403429

POST`/v2/interactions/{id}/reply`

Ответить на команду или кнопку.

Право write
с v2.20

В течение 15 минут после события command или interaction; с private ответ видит только тот, кто использовал команду или кнопку.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	Идентификатор из события (`data.interaction`).
`text`в теле	`string`необязательно	Текст поста, ответа или сообщения.
`private`в теле	`boolean`необязательно	`true`: ответ видит только тот, кто использовал команду или кнопку, в течение дня.
`card`в теле	`object`необязательно	Карточка `{ title, text, color, fields: [{ name, value }] }`, не больше 10 полей.
`buttons`в теле	`object[]`необязательно	До 5 кнопок, каждая `{ id, label, style }` со `style` `primary`, `secondary` или `danger`. Нажатие приходит как событие `interaction`.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"text":"You rolled a 4.","private":true}' \
  "https://api.tellmelo.com/v2/interactions/9b8c7d6e-5f4a-4b3c-8d2e-1f0a9b8c7d6e/reply"

Ответ

Отвечает одним Made.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}

Возможные статусы: 200400401403404429

POST`/v2/channels/{id}/voice`

Занять место в голосовом канале, чтобы проигрывать музыку или звук.

Право write
с v2.20

Только с токеном бота, насколько позволяет его роль в канале. Программа подключается через LiveKit SDK и передаёт звук как микрофон; каждый сам настраивает его громкость.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` канала.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/channels/0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a/voice"

Ответ

Отвечает одним VoiceSeat.

Пример

{
  "url": "wss://voice.example.org",
  "token": "eyJhbGciOiJIUzI1NiJ9…",
  "iceServers": [
    {
      "urls": [
        "stun:turn.example.org:3478"
      ]
    }
  ],
  "speak": true,
  "video": false
}

Возможные статусы: 200400401403404429

Обзор

Тренды, поиск и собственные эмодзи сервера.

GET`/v2/tags`

Теги, которые сейчас в ходу.

Право read
с ETag
с v2.0

Не больше 10 популярных тегов по весу: каждое использование даёт 1 и вдвое уменьшается каждые 3 дня, один аккаунт даёт не больше 3 в день. posts — округлённый вес. limit только укорачивает список. Теги, выделенные командой, могут стоять выше.

Параметры

Имя	Тип	Значение
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/tags?limit=10"

Ответ

Отвечает страницей Tag в виде `items` и `next`.

Пример

{
  "items": [
    {
      "tag": "garden",
      "posts": 58
    }
  ],
  "next": null
}

Возможные статусы: 200304401429

GET`/v2/search`

Поиск по постам, именам, коротким именам и тегам.

Право read
с ETag
с v2.0

Ищет только публичное: посты вне групп, профили и теги. limit действует для каждого вида.

Параметры

Имя	Тип	Значение
`q`в query	`string`обязательно	Искомые слова.
`type`в query	`string`необязательно	Какой вид результатов. Без него — все виды.`allpostsprofilestags`
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/search?q=garden&type=posts"

Ответ

Отвечает одним SearchResult.

Пример

{
  "posts": [
    {
      "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
      "text": "The bees are back in the garden 🐝 #garden",
      "kind": "poll",
      "author": {
        "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
        "handle": "mara",
        "name": "Mara 🌻",
        "verified": true,
        "accountKind": "person"
      },
      "community": {
        "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
        "name": "Urban Gardening"
      },
      "media": [
        {
          "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
          "kind": "image",
          "poster": null,
          "ai": "without"
        }
      ],
      "poll": {
        "options": [
          {
            "text": "Lavender",
            "votes": 12
          },
          {
            "text": "Sunflowers",
            "votes": 7
          },
          {
            "text": "Clover",
            "votes": 3
          }
        ],
        "total": 22,
        "multiple": false,
        "endsAt": null,
        "running": true,
        "resultsVisible": true,
        "myVotes": [
          0
        ]
      },
      "quotes": null,
      "continues": null,
      "counts": {
        "replies": 4,
        "likes": 31,
        "reposts": 2
      },
      "pinned": false,
      "giftDrop": {
        "item": "plan",
        "quantity": 3,
        "places": 10,
        "left": 4,
        "audience": "followers",
        "newAccounts": false,
        "status": "open",
        "claimed": true
      },
      "createdAt": 1758624000000
    }
  ],
  "profiles": [
    {
      "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
      "handle": "mara",
      "name": "Mara 🌻",
      "verified": true,
      "accountKind": "person"
    }
  ],
  "tags": [
    {
      "tag": "garden",
      "posts": 58
    }
  ]
}

Возможные статусы: 200304400401429

GET`/v2/emojis`

Собственные эмодзи сервера с адресами их картинок.

Право read
с ETag
с v2.1

В текстах эмодзи выглядит как :name:. Замени его картинкой из этого списка; неизвестные имена остаются текстом.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/emojis"

Ответ

Отвечает страницей Emoji в виде `items` и `next`.

Пример

{
  "items": [
    {
      "name": "tellmelo",
      "url": "/api/media?id=e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b"
    }
  ],
  "next": null
}

Возможные статусы: 200304401429

GIF и видео

Медиатека: искать общие GIF и видео, загружать свои, управлять ими и встраивать их на другие сайты.

GET`/v2/media`

Общие GIF или видео, сначала самые используемые.

Право read
с пагинацией
с ETag
с v2.14

Без аккаунтов, которые ты заблокировал или которые заблокировали тебя. url и poster загружай с ключом в заголовке — для постов в tellmelo.

Для других сайтов — только то, у чего есть embed: его адреса работают без ключа в любом браузере.

Параметры

Имя	Тип	Значение
`kind`в query	`string`необязательно	`gif` или `video`; по умолчанию `gif`.`gifvideo`
`q`в query	`string`необязательно	Слова из названия или ключевых слов.
`anywhere`в query	`boolean`необязательно	`true`: только то, что может появляться и на других сайтах.
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/media?kind=gif&q=bees&anywhere=true&limit=20"

Ответ

Отвечает страницей MediaItem в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
      "kind": "gif",
      "name": "Happy bees",
      "keywords": "bees garden happy",
      "width": 480,
      "height": 270,
      "seconds": 0,
      "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
      "poster": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918&poster=1",
      "uploader": {
        "handle": "mara",
        "name": "Mara 🌻"
      },
      "mine": false,
      "shared": true,
      "anywhere": true,
      "embed": {
        "page": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
        "file": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/file",
        "poster": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/poster",
        "code": "<iframe src=\"https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918\" width=\"480\" height=\"300\" title=\"Happy bees\" style=\"border:0;max-width:100%\" loading=\"lazy\" allowfullscreen></iframe>"
      }
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200304400401429

GET`/v2/media/mine`

Твоя медиатека, сначала новое.

Право media
с пагинацией
с ETag
с v2.14

Параметры

Имя	Тип	Значение
`kind`в query	`string`необязательно	`gif` или `video`; по умолчанию `gif`.`gifvideo`
`q`в query	`string`необязательно	Слова из названия или ключевых слов.
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/media/mine?kind=gif&q=bees&limit=20"

Ответ

Отвечает страницей MediaItem в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
      "kind": "gif",
      "name": "Happy bees",
      "keywords": "bees garden happy",
      "width": 480,
      "height": 270,
      "seconds": 0,
      "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
      "poster": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918&poster=1",
      "uploader": {
        "handle": "mara",
        "name": "Mara 🌻"
      },
      "mine": false,
      "shared": true,
      "anywhere": true,
      "embed": {
        "page": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
        "file": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/file",
        "poster": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/poster",
        "code": "<iframe src=\"https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918\" width=\"480\" height=\"300\" title=\"Happy bees\" style=\"border:0;max-width:100%\" loading=\"lazy\" allowfullscreen></iframe>"
      }
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200304400401403429

GET`/v2/media/{id}`

GIF или видео — твоё или общее.

Право read
с ETag
с v2.14

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	ID GIF или видео.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/media/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918"

Ответ

Отвечает одним MediaItem.

Пример

{
  "id": "b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
  "kind": "gif",
  "name": "Happy bees",
  "keywords": "bees garden happy",
  "width": 480,
  "height": 270,
  "seconds": 0,
  "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
  "poster": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918&poster=1",
  "uploader": {
    "handle": "mara",
    "name": "Mara 🌻"
  },
  "mine": false,
  "shared": true,
  "anywhere": true,
  "embed": {
    "page": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
    "file": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/file",
    "poster": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/poster",
    "code": "<iframe src=\"https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918\" width=\"480\" height=\"300\" title=\"Happy bees\" style=\"border:0;max-width:100%\" loading=\"lazy\" allowfullscreen></iframe>"
  }
}

Возможные статусы: 200304400401404429

POST`/v2/media/uploads`

Начать загрузку.

Право media
с v2.14

Затем отправляй файл фрагментами не больше piece байт на /media/uploads/{upload}. Без нового фрагмента загрузка завершается через 15 минут.

Действуют ограничения приложения: GIF до 15 МБ, видео по размеру и длине в зависимости от подписки, GIF в день, личные GIF, видеобаллы в неделю. Иначе придёт 409, 413 или 429.

Параметры

Имя	Тип	Значение
`kind`в теле	`string`обязательно	`gif` или `video`; по умолчанию `gif`.`gifvideo`
`size`в теле	`integer`обязательно	Размер всего файла в байтах.
`name`в теле	`string`обязательно	Название, по которому его находят: от 2 до 40 символов.
`keywords`в теле	`string`необязательно	Ключевые слова для поиска через пробел.
`shared`в теле	`boolean`необязательно	`true`: доступно всем в tellmelo.
`anywhere`в теле	`boolean`необязательно	`true`: доступно всем и разрешено на других сайтах. Только вместе с `shared`.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"kind":"gif","size":2400000,"name":"Happy bees","keywords":"bees garden","shared":true,"anywhere":false}' \
  "https://api.tellmelo.com/v2/media/uploads"

Ответ

Отвечает одним UploadStarted.

Пример

{
  "upload": "e7c1a2b3-4d5e-4f60-8a9b-0c1d2e3f4a5b",
  "piece": 4194304
}

Возможные статусы: 200400401403429

PUT`/v2/media/uploads/{upload}`

Отправить фрагмент файла.

Право media
с v2.14

Тело запроса — это сам фрагмент (application/octet-stream), не JSON. Если он не продолжает файл, придёт 409 с received: продолжай оттуда. После последнего фрагмента файл конвертируется; тогда в ответе есть item.

Параметры

Имя	Тип	Значение
`upload`в пути	`string`обязательно	`upload`, полученный при начале загрузки.
`offset`в query	`integer`обязательно	С какого места файла начинается фрагмент, в байтах; для первого — `0`.

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @piece \
  "https://api.tellmelo.com/v2/media/uploads/e7c1a2b3-4d5e-4f60-8a9b-0c1d2e3f4a5b?offset=0"

Ответ

Отвечает одним UploadPiece.

Пример

{
  "received": 4194304,
  "item": null
}

Возможные статусы: 200400401403404429

POST`/v2/media/{id}`

Изменить одно из твоих GIF или видео.

Право media
с v2.14

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	ID GIF или видео.
`name`в теле	`string`необязательно	Название, по которому его находят: от 2 до 40 символов.
`keywords`в теле	`string`необязательно	Ключевые слова для поиска через пробел.
`shared`в теле	`boolean`необязательно	`true`: доступно всем в tellmelo.
`anywhere`в теле	`boolean`необязательно	`true`: доступно всем и разрешено на других сайтах. Только вместе с `shared`.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Happy bees","anywhere":true}' \
  "https://api.tellmelo.com/v2/media/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

DELETE`/v2/media/{id}`

Удалить одно из твоих GIF или видео.

Право media
с v2.14

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

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	ID GIF или видео.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/media/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

Твой аккаунт

Твой профиль, твоя лента, твои эмодзи и твои вебхуки.

GET`/v2/me`

Твой собственный профиль с id, который ждут остальные пути.

Право read
с ETag
с v2.0

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me"

Ответ

Отвечает одним Profile.

Пример

{
  "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
  "handle": "mara",
  "name": "Mara 🌻",
  "verified": true,
  "accountKind": "person",
  "about": "Beekeeper, allotment, too many seeds. :tellmelo:",
  "website": "https://mara-imkerei.example/",
  "websiteVerified": true,
  "followers": 148,
  "createdAt": 1750848000000
}

Возможные статусы: 200304401429

GET`/v2/feed`

Твоя собственная лента в том виде, как её собирает приложение.

Право read
с пагинацией
с v2.0

Без ETag, потому что порядок всё время меняется. Начатый список остаётся неизменным до конца.

Параметры

Имя	Тип	Значение
`tab`в query	`string`необязательно	Какая лента: `for-you`, `following`, `latest` или `bookmarks`. По умолчанию `latest`.`for-youfollowinglatestbookmarks`
`tag`в query	`string`необязательно	Только посты об этом теге: написанные с ним или распознанные сервером. Без него — без фильтра.
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/feed?tab=following&limit=20"

Ответ

Отвечает страницей Post в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
      "text": "The bees are back in the garden 🐝 #garden",
      "kind": "poll",
      "author": {
        "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
        "handle": "mara",
        "name": "Mara 🌻",
        "verified": true,
        "accountKind": "person"
      },
      "community": {
        "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
        "name": "Urban Gardening"
      },
      "media": [
        {
          "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
          "kind": "image",
          "poster": null,
          "ai": "without"
        }
      ],
      "poll": {
        "options": [
          {
            "text": "Lavender",
            "votes": 12
          },
          {
            "text": "Sunflowers",
            "votes": 7
          },
          {
            "text": "Clover",
            "votes": 3
          }
        ],
        "total": 22,
        "multiple": false,
        "endsAt": null,
        "running": true,
        "resultsVisible": true,
        "myVotes": [
          0
        ]
      },
      "quotes": null,
      "continues": null,
      "counts": {
        "replies": 4,
        "likes": 31,
        "reposts": 2
      },
      "pinned": false,
      "giftDrop": {
        "item": "plan",
        "quantity": 3,
        "places": 10,
        "left": 4,
        "audience": "followers",
        "newAccounts": false,
        "status": "open",
        "claimed": true
      },
      "createdAt": 1758624000000
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200400401429

POST`/v2/me/pictures`

Загрузить изображение в виде байтов. Возвращает id и url; затем id используется как аватар, обложка или в посте.

Право write
с v2.19

PNG, JPEG, WebP или GIF, определяется по первым байтам; сохраняется заново без метаданных. Нигде не использованное изображение позже удаляется.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @picture.png \
  "https://api.tellmelo.com/v2/me/pictures"

Ответ

Отвечает одним Picture.

Пример

{
  "id": "8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
  "url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9"
}

Возможные статусы: 200401403429

PUT`/v2/me/profile`

Изменить профиль: имя, «О себе», аватар, обложку и цвет профиля. Что не указано, остаётся как есть.

Право profile
с v2.19

Нужно разрешение profile. Твой @ник остаётся в приложении: это ещё и имя для входа.

Параметры

Имя	Тип	Значение
`name`в теле	`string`необязательно	Отображаемое имя, не длиннее 60 символов.
`about`в теле	`string`необязательно	Текст «О себе».
`avatar`в теле	`string`необязательно	`id` загруженного изображения для аватара. Пусто — удалить.
`banner`в теле	`string`необязательно	`id` загруженного изображения для обложки. Пусто — удалить.
`color`в теле	`string`необязательно	Цвет профиля, с подпиской. `null` убирает его.`indigovioletrosecoralamberlimegreentealskyslatesandnight`

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Mara 🌻","about":"Gardening in the city.","avatar":"8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9"}' \
  "https://api.tellmelo.com/v2/me/profile"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403429

GET`/v2/me/emojis`

Твои собственные эмодзи.

Право read
с ETag
с v2.19

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/emojis"

Ответ

Отвечает страницей OwnEmoji в виде `items` и `next`.

Пример

{
  "items": [
    {
      "name": "sunflower",
      "url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
      "animated": false,
      "resting": false
    }
  ],
  "next": null
}

Возможные статусы: 200304401429

POST`/v2/me/emojis/pictures`

Загрузить изображение для своего эмодзи в виде байтов.

Право profile
с v2.19

Анимированные эмодзи требуют подписки. Если после преобразования изображение слишком большое, оно отклоняется.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @picture.png \
  "https://api.tellmelo.com/v2/me/emojis/pictures"

Ответ

Отвечает одним EmojiPicture.

Пример

{
  "id": "8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
  "url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
  "animated": false
}

Возможные статусы: 200401403429

POST`/v2/me/emojis`

Создать свой эмодзи. Возвращает все твои эмодзи.

Право profile
с v2.19

Сколько эмодзи можно создать, зависит от подписки.

Параметры

Имя	Тип	Значение
`name`в теле	`string`обязательно	Имя, которым ты пишешь эмодзи, как `:имя:`.
`picture`в теле	`string`обязательно	`id` из `POST /me/emojis/pictures`.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"sunflower","picture":"8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9"}' \
  "https://api.tellmelo.com/v2/me/emojis"

Ответ

Отвечает страницей OwnEmoji в виде `items` и `next`.

Пример

{
  "items": [
    {
      "name": "sunflower",
      "url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
      "animated": false,
      "resting": false
    }
  ],
  "next": null
}

Возможные статусы: 200400401403429

DELETE`/v2/me/emojis/{name}`

Удалить свой эмодзи. Возвращает остальные.

Право profile
с v2.19

Параметры

Имя	Тип	Значение
`name`в пути	`string`обязательно	Имя эмодзи, без двоеточий.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/emojis/sunflower"

Ответ

Отвечает страницей OwnEmoji в виде `items` и `next`.

Пример

{
  "items": [
    {
      "name": "sunflower",
      "url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
      "animated": false,
      "resting": false
    }
  ],
  "next": null
}

Возможные статусы: 200400401403404429

PUT`/v2/me/emojis/sharing`

Решить, могут ли подписчики использовать твои эмодзи в своих текстах.

Право profile
с v2.19

Параметры

Имя	Тип	Значение
`shared`в теле	`boolean`обязательно	`true` делится эмодзи с подписчиками, `false` — нет.

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"shared":true}' \
  "https://api.tellmelo.com/v2/me/emojis/sharing"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403429

GET`/v2/me/webhooks`

Твои вебхуки и их состояние.

Право webhooks
с ETag
с v2.19

Нужно разрешение webhooks. Вебхуки есть в подписке для организаций или у партнёров.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/webhooks"

Ответ

Отвечает страницей Webhook в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
      "url": "https://example.org/tellmelo-hook",
      "kinds": [
        "reply",
        "mention"
      ],
      "active": true,
      "lastStatus": 200,
      "lastAt": 1758624000000,
      "failures": 0
    }
  ],
  "next": null
}

Возможные статусы: 200304401403429

POST`/v2/me/webhooks`

Создать вебхук. Возвращает id и секрет для подписей, только в этот раз.

Право webhooks
с v2.19

Каждая доставка подписана секретом (X-Tellmelo-Signature). Сохрани его: больше он не покажется.

Параметры

Имя	Тип	Значение
`url`в теле	`string`обязательно	Адрес HTTPS вне локальных сетей, без учётных данных.
`kinds`в теле	`string[]`обязательно	О чём сообщать вебхуку. Какие виды тебе доступны, зависит от подписки и партнёрства.`replymentiongroup_mentionfollowlikerepostmessagequota_changedquota_giftdrop_claimeddrop_empty`

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.org/tellmelo-hook","kinds":["reply","mention"]}' \
  "https://api.tellmelo.com/v2/me/webhooks"

Ответ

Отвечает одним WebhookCreated.

Пример

{
  "id": "1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
  "secret": "whsec_3f9a…"
}

Возможные статусы: 200400401403429

DELETE`/v2/me/webhooks/{id}`

Удалить вебхук.

Право webhooks
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` вебхука.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/webhooks/1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

POST`/v2/me/webhooks/{id}/test`

Отправить проверку на вебхук.

Право webhooks
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` вебхука.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/webhooks/1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b/test"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

Уведомления

Что происходило вокруг твоего аккаунта, страница за страницей.

GET`/v2/notifications`

Твои уведомления, сначала новые.

Право read
с пагинацией
с ETag
с v2.0

Чтение ничего не отмечает прочитанным; это делает POST /notifications/read. События одного вида на одном посте делят строку; more говорит, сколько их.

Параметры

Имя	Тип	Значение
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/notifications?limit=20"

Ответ

Отвечает страницей Notification в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "3f2e1d0c-9b8a-4765-8432-10fedcba9876",
      "kind": "like",
      "text": null,
      "actor": {
        "handle": "jon",
        "name": "Jon"
      },
      "postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
      "read": false,
      "more": 2,
      "createdAt": 1758624300000,
      "updatedAt": 1758624900000
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200304401429

POST`/v2/notifications/read`

Отметить уведомления прочитанными.

Право write
с v2.0

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/notifications/read"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200401403429

Сообщения

Твой ящик и переписки. Переписка называется по другому аккаунту.

GET`/v2/conversations`

Твой ящик: по строке на переписку, сначала самая свежая.

Право read
с пагинацией
с ETag
с v2.0

Параметры

Имя	Тип	Значение
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/conversations?limit=20"

Ответ

Отвечает страницей Conversation в виде `items` и `next`.

Пример

{
  "items": [
    {
      "with": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
      "handle": "jon",
      "name": "Jon",
      "excerpt": "See you on Saturday at the market!",
      "truncated": false,
      "fromMe": true,
      "lastMessageId": "7c6b5a49-3827-4165-9f0e-d1c2b3a49586",
      "unread": 0,
      "updatedAt": 1758624060000
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200304401429

GET`/v2/conversations/{with}/messages`

Сообщения одной переписки, сначала новые.

Право read
с пагинацией
с ETag
с v2.0

Чтение ничего не отмечает прочитанным; это делает POST /conversations/{with}/read.

Параметры

Имя	Тип	Значение
`with`в пути	`string`обязательно	`id` другого аккаунта. У переписки нет собственного `id`.
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/conversations/a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05/messages?limit=20"

Ответ

Отвечает страницей Message в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "7c6b5a49-3827-4165-9f0e-d1c2b3a49586",
      "text": "See you on Saturday at the market!",
      "from": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
      "to": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
      "read": true,
      "media": [],
      "replyTo": null,
      "createdAt": 1758624060000
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200304400401404429

POST`/v2/conversations/{with}/messages`

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

Право write
с v2.0

Действуют правила приложения: кто тебя заблокировал, тому не написать, и учитываются настройки собеседника.

Изображения, GIF и видео нельзя прикрепить к сообщениям через API, только в приложении.

Параметры

Имя	Тип	Значение
`with`в пути	`string`обязательно	`id` другого аккаунта. У переписки нет собственного `id`.
`text`в теле	`string`обязательно	Текст поста, ответа или сообщения.
`replyTo`в теле	`string`необязательно	`id` более раннего сообщения этой переписки, на которое отвечает это. С 2.2.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"text":"See you on Saturday at the market!"}' \
  "https://api.tellmelo.com/v2/conversations/a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05/messages"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

POST`/v2/conversations/{with}/read`

Отметить все сообщения переписки прочитанными.

Право write
с v2.1

Параметры

Имя	Тип	Значение
`with`в пути	`string`обязательно	`id` другого аккаунта. У переписки нет собственного `id`.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/conversations/a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05/read"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

DELETE`/v2/conversations/{with}/messages/{id}`

Удалить своё сообщение.

Право write
с v2.12

Только свои сообщения и только в первые 24 часа после отправки.

Параметры

Имя	Тип	Значение
`with`в пути	`string`обязательно	`id` другого аккаунта. У переписки нет собственного `id`.
`id`в пути	`string`обязательно	id сообщения.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/conversations/a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05/messages/7c6b5a49-3827-4165-9f0e-d1c2b3a49586"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

POST`/v2/conversations/{with}/planned`

Запланировать сообщение на потом. Возвращает id запланированного сообщения.

Право write
с v2.19

Нужна подписка с запланированными сообщениями, иначе 403. При сквозном шифровании у обеих сторон работает только в приложении.

Параметры

Имя	Тип	Значение
`with`в пути	`string`обязательно	`id` другого аккаунта. У переписки нет собственного `id`.
`text`в теле	`string`обязательно	Текст поста, ответа или сообщения.
`sendAt`в теле	`integer`обязательно	Когда отправить сообщение, в миллисекундах с 1970 года.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"text":"Happy birthday! 🎂","sendAt":1758700000000}' \
  "https://api.tellmelo.com/v2/conversations/a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05/planned"

Ответ

Отвечает одним Made.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}

Возможные статусы: 200400401403404429

GET`/v2/me/planned-messages`

Твои сообщения, которые ещё будут отправлены, по времени.

Право read
с ETag
с v2.19

Параметры

Имя	Тип	Значение
`with`в query	`string`необязательно	Только сообщения для этого аккаунта (его `id`).

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/planned-messages"

Ответ

Отвечает страницей PlannedMessage в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9",
      "to": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
      "text": "Happy birthday! 🎂",
      "sendAt": 1758710400000,
      "state": "waiting"
    }
  ],
  "next": null
}

Возможные статусы: 200304401429

POST`/v2/me/planned-messages/{id}/send`

Отправить сейчас задержанное или неудавшееся запланированное сообщение.

Право write
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` запланированного сообщения.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/planned-messages/3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9/send"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

DELETE`/v2/me/planned-messages/{id}`

Удалить запланированное сообщение до отправки.

Право write
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` запланированного сообщения.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/planned-messages/3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

Связи

Отметить, сохранить, репостнуть, подписаться, вступить, заблокировать: один путь, ставится и снимается через active. С 2.19 также списки: подписчики, подписки и твои блокировки и скрытия.

POST`/v2/relations`

Отметить, сохранить, репостнуть, подписаться, вступить, заблокировать, скрыть — в зависимости от kind.

Право write
с v2.0

target — пост для like, save и repost, группа для join, аккаунт для follow, block и mute. active: false снимает связь.

Параметры

Имя	Тип	Значение
`kind`в теле	`string`обязательно	Какая связь: `like`, `save`, `repost`, `follow`, `join`, `block` или `mute` (с 2.2).`likesaverepostfollowjoinblockmute`
`target`в теле	`string`обязательно	`id` поста, профиля или группы, в зависимости от `kind`.
`active`в теле	`boolean`необязательно	`true` устанавливает связь, `false` снимает её.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"kind":"like","target":"5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1","active":true}' \
  "https://api.tellmelo.com/v2/relations"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403429

GET`/v2/profiles/{handle}/followers`

Кто подписан на профиль, новые сначала.

Право read
с пагинацией
с ETag
с v2.19

Параметры

Имя	Тип	Значение
`handle`в пути	`string`обязательно	Короткое имя профиля, регистр букв не важен.
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/profiles/mara/followers?limit=20"

Ответ

Отвечает страницей ProfileBrief в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
      "handle": "mara",
      "name": "Mara 🌻",
      "verified": true,
      "accountKind": "person"
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200304400401404429

GET`/v2/profiles/{handle}/following`

На кого подписан профиль, новые сначала.

Право read
с пагинацией
с ETag
с v2.19

Параметры

Имя	Тип	Значение
`handle`в пути	`string`обязательно	Короткое имя профиля, регистр букв не важен.
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/profiles/mara/following?limit=20"

Ответ

Отвечает страницей ProfileBrief в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
      "handle": "mara",
      "name": "Mara 🌻",
      "verified": true,
      "accountKind": "person"
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200304400401404429

GET`/v2/me/relations`

Кого ты заблокировал, скрыл или заблокировал только для сообщений, новые сначала.

Право read
с пагинацией
с ETag
с v2.19

Только твои собственные списки. Ставить и снимать — через POST /relations.

Параметры

Имя	Тип	Значение
`kind`в query	`string`обязательно	`block` — заблокированные, `mute` — скрытые, `dm_block` — заблокированные только для сообщений.`blockmutedm_block`
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/relations?kind=mute&limit=20"

Ответ

Отвечает страницей ProfileBrief в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
      "handle": "mara",
      "name": "Mara 🌻",
      "verified": true,
      "accountKind": "person"
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200304400401429

Подборки

Раскладывай сохранённые посты по своим подборкам. Пост может быть в нескольких; убранный из подборки, он остаётся сохранённым.

GET`/v2/me/collections`

Твои подборки с числом постов в них.

Право read
с ETag
с v2.19

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/collections"

Ответ

Отвечает страницей Collection в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "6d5c4b3a-2918-4e7f-a1b2-c3d4e5f60718",
      "name": "Recipes",
      "count": 12
    }
  ],
  "next": null
}

Возможные статусы: 200304401429

POST`/v2/me/collections`

Создать подборку. Возвращает её id.

Право write
с v2.19

Сколько подборок можно создать, зависит от подписки.

Параметры

Имя	Тип	Значение
`name`в теле	`string`обязательно	Название, не длиннее 40 символов. Уникально в аккаунте без учёта регистра.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Recipes"}' \
  "https://api.tellmelo.com/v2/me/collections"

Ответ

Отвечает одним Made.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}

Возможные статусы: 200400401403429

PUT`/v2/me/collections/{id}`

Переименовать подборку.

Право write
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` подборки.
`name`в теле	`string`обязательно	Название, не длиннее 40 символов. Уникально в аккаунте без учёта регистра.

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

curl -X PUT \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"name":"Baking"}' \
  "https://api.tellmelo.com/v2/me/collections/6d5c4b3a-2918-4e7f-a1b2-c3d4e5f60718"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

DELETE`/v2/me/collections/{id}`

Удалить подборку.

Право write
с v2.19

Посты в ней остаются сохранёнными.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` подборки.

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

curl -X DELETE \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/collections/6d5c4b3a-2918-4e7f-a1b2-c3d4e5f60718"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

GET`/v2/me/collections/{id}/posts`

Посты подборки, как во вкладке сохранённого.

Право read
с пагинацией
с v2.19

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` подборки.
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/me/collections/6d5c4b3a-2918-4e7f-a1b2-c3d4e5f60718/posts?limit=20"

Ответ

Отвечает страницей Post в виде `items` и `next`.

Пример

{
  "items": [
    {
      "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
      "text": "The bees are back in the garden 🐝 #garden",
      "kind": "poll",
      "author": {
        "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
        "handle": "mara",
        "name": "Mara 🌻",
        "verified": true,
        "accountKind": "person"
      },
      "community": {
        "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
        "name": "Urban Gardening"
      },
      "media": [
        {
          "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
          "kind": "image",
          "poster": null,
          "ai": "without"
        }
      ],
      "poll": {
        "options": [
          {
            "text": "Lavender",
            "votes": 12
          },
          {
            "text": "Sunflowers",
            "votes": 7
          },
          {
            "text": "Clover",
            "votes": 3
          }
        ],
        "total": 22,
        "multiple": false,
        "endsAt": null,
        "running": true,
        "resultsVisible": true,
        "myVotes": [
          0
        ]
      },
      "quotes": null,
      "continues": null,
      "counts": {
        "replies": 4,
        "likes": 31,
        "reposts": 2
      },
      "pinned": false,
      "giftDrop": {
        "item": "plan",
        "quantity": 3,
        "places": 10,
        "left": 4,
        "audience": "followers",
        "newAccounts": false,
        "status": "open",
        "claimed": true
      },
      "createdAt": 1758624000000
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200400401404429

POST`/v2/me/collections/{id}/posts`

Положить пост в подборку или убрать его.

Право write
с v2.19

Пост, положенный в подборку, тоже сохраняется. Только видимые посты.

Параметры

Имя	Тип	Значение
`id`в пути	`string`обязательно	`id` подборки.
`post`в теле	`string`обязательно	`id` поста.
`inside`в теле	`boolean`необязательно	`true` кладёт пост (по умолчанию), `false` убирает.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"post":"5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1","inside":true}' \
  "https://api.tellmelo.com/v2/me/collections/6d5c4b3a-2918-4e7f-a1b2-c3d4e5f60718/posts"

Ответ

Отвечает одним Ok.

Пример

{
  "ok": true
}

Возможные статусы: 200400401403404429

Подарки

Смотреть квоту партнёра и дарить из неё, ставить подарки под посты и следить за ними. Забирать подарки могут только люди, в приложении.

GET`/v2/partner/quota`

Сколько ещё осталось в твоей квоте для подарков.

Право read
с ETag
с v2.12

Только для партнёров с квотой; остальные получают 403.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/partner/quota"

Ответ

Отвечает одним Quota.

Пример

{
  "months": 120,
  "sparks": 500,
  "looks": [
    {
      "id": "frame-gold",
      "name": "Goldring",
      "kind": "frame",
      "quantity": 25
    }
  ]
}

Возможные статусы: 200304401429

GET`/v2/partner/gifts`

Что ты подарил из квоты, кому и когда – сначала новые.

Право read
с пагинацией
с ETag
с v2.12

Только для партнёров с квотой; остальные получают 403.

Параметры

Имя	Тип	Значение
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/partner/gifts?limit=20"

Ответ

Отвечает страницей QuotaGift в виде `items` и `next`.

Пример

{
  "items": [
    {
      "item": "plan",
      "quantity": 3,
      "itemId": null,
      "recipient": {
        "handle": "jon",
        "name": "Jon"
      },
      "createdAt": 1758627600000
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200304401429

POST`/v2/partner/gifts`

Подарить участнику месяцы тарифа или искры из своей квоты.

Право gifts
с v2.12

Только для партнёров с квотой; остальные получают 403.

Как и в приложении, участник видит, от кого подарок. Не больше 60 подарков в час.

Параметры

Имя	Тип	Значение
`handle`в теле	`string`обязательно	@имя участника, которому ты даришь, с @ или без.
`item`в теле	`string`обязательно	`plan` – месяцы тарифа, `sparks` – искры, `shop` – оформление из твоего запаса (с 2.13).`plansparksshop`
`quantity`в теле	`integer`необязательно	Сколько: до 12 месяцев или 35 искр за подарок.
`itemId`в теле	`string`необязательно	Для `shop`: ID оформления, как его называет `looks` в квоте. Один экземпляр на подарок; `quantity` тогда не действует.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"handle":"jon","item":"plan","quantity":3,"itemId":"frame-gold"}' \
  "https://api.tellmelo.com/v2/partner/gifts"

Ответ

Отвечает одним Quota.

Пример

{
  "months": 120,
  "sparks": 500,
  "looks": [
    {
      "id": "frame-gold",
      "name": "Goldring",
      "kind": "frame",
      "quantity": 25
    }
  ]
}

Возможные статусы: 200400401403429

GET`/v2/gift-drops`

Твои подарки под постами: сколько мест ещё свободно и как они оплачены.

Право read
с пагинацией
с ETag
с v2.12

Параметры

Имя	Тип	Значение
`limit`в query	`integer`необязательно	Записей на страницу: по умолчанию 20, максимум 50.
`cursor`в query	`string`необязательно	`next` из предыдущего ответа. Без него — с начала.

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

curl \
  -H "Authorization: Bearer tm_key_…" \
  "https://api.tellmelo.com/v2/gift-drops?limit=20"

Ответ

Отвечает страницей OwnGiftDrop в виде `items` и `next`.

Пример

{
  "items": [
    {
      "item": "plan",
      "quantity": 3,
      "places": 10,
      "left": 4,
      "audience": "followers",
      "newAccounts": false,
      "status": "open",
      "claimed": false,
      "postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
      "funding": "quota",
      "createdAt": 1758624000000
    }
  ],
  "next": "MTc1ODYyNDAwMDAwMDo1ZjBjMmE5ZS04ZDQx"
}

Возможные статусы: 200304401429

POST`/v2/gift-drops`

Опубликовать пост с подарками, которые могут забрать другие.

Право gifts
с v2.12

Бесплатно для владельца и членов команды с этим правом, иначе – из твоей квоты. Всё, за что пришлось бы платить, отклоняется с 422: платить можно только в приложении.

Забрать подарок можно только в приложении, чтобы ни одна программа не разобрала все места. Сколько мест ещё свободно, видно в giftDrop поста.

Параметры

Имя	Тип	Значение
`text`в теле	`string`необязательно	Текст поста, ответа или сообщения.
`community`в теле	`string`необязательно	`id` группы, в канал ленты которой идёт публикация; канал должен быть включён, и тебе нужно право на это. Без него публикация не относится ни к одной группе.
`item`в теле	`string`обязательно	`plan` – месяцы тарифа, `sparks` – искры.`plansparks`
`quantity`в теле	`integer`обязательно	Что входит в каждое место: до 12 месяцев или 35 искр.
`places`в теле	`integer`обязательно	На сколько человек, до 10 000.
`audience`в теле	`string`необязательно	Кто может забрать: `all` – все, `followers` – только твои подписчики, `group` – только участники группы (только вместе с `community`).`allfollowersgroup`
`newAccounts`в теле	`boolean`необязательно	`true` разрешает забирать и аккаунтам младше 7 дней. Без этого они остаются в стороне.

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

curl -X POST \
  -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"text":"Ten times three months of Supporter – first come, first served! 🎁","item":"plan","quantity":3,"places":10,"audience":"all","newAccounts":false}' \
  "https://api.tellmelo.com/v2/gift-drops"

Ответ

Отвечает одним DropCreated.

Пример

{
  "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
  "funding": "quota"
}

Возможные статусы: 200400401403429

Объекты

Все объекты, поле за полем. [] означает список.

`Service`

Ответ корня: кто отвечает и что может этот ключ.

Поле	Тип	Значение
`name`	`string`	Всегда `tellmelo`.
`version`	`string`	Версия API, например `2.1`.
`scope`	`string`	Что может этот ключ: `read` или `read write`.
`rateLimit`	`RateLimit`	Бюджет этого ключа.
`docs`	`string`	Где эта документация, в виде пути на этом сервере.
`spec`	`string`	Где машиночитаемое описание.

Пример

{
  "name": "tellmelo",
  "version": "2.20",
  "scope": "read write",
  "rateLimit": {
    "limit": 120,
    "remaining": 117
  },
  "docs": "/developers/docs",
  "spec": "/api/v2/openapi.json"
}

`RateLimit`

Бюджет этого ключа в текущей минуте.

Поле	Тип	Значение
`limit`	`integer`	Запросов в минуту.
`remaining`	`integer`	Сколько осталось в этой минуте.

Пример

{
  "limit": 120,
  "remaining": 117
}

`Post`

Пост, везде в одной и той же форме.

Поле	Тип	Значение
`id`	`string`	id поста.
`text`	`string`или null	Текст как написан (`null` для поста, который только опрос или только картинки).
`kind`	`string`	Что это за пост. `post` — Пост с текстом, картинками или цитатой. `poll` — Пост с опросом.
`author`	`ProfileBrief`	Кто его написал.
`community`	`CommunityBrief`или null	Группа, в которой он написан (`null` вне групп).
`media`	`Media[]`	Его изображения по порядку; пусто, если их нет.
`poll`	`Poll`или null	Опрос (`null`, если его нет).
`quotes`	`string`или null	id поста, который цитирует этот.
`continues`	`string`или null	id поста, который продолжает этот как дополнение.
`counts`	`Counts`	Ответы, отметки и репосты.
`pinned`	`boolean`	Закреплён ли он наверху профиля автора.
`giftDrop`	`GiftDrop`или null	Подарки под постом, которые можно забрать (`null`, если их нет).
`createdAt`	`integer`	Когда он написан.

Пример

{
  "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
  "text": "The bees are back in the garden 🐝 #garden",
  "kind": "poll",
  "author": {
    "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
    "handle": "mara",
    "name": "Mara 🌻",
    "verified": true,
    "accountKind": "person"
  },
  "community": {
    "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
    "name": "Urban Gardening"
  },
  "media": [
    {
      "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
      "kind": "image",
      "poster": null,
      "ai": "without"
    }
  ],
  "poll": {
    "options": [
      {
        "text": "Lavender",
        "votes": 12
      },
      {
        "text": "Sunflowers",
        "votes": 7
      },
      {
        "text": "Clover",
        "votes": 3
      }
    ],
    "total": 22,
    "multiple": false,
    "endsAt": null,
    "running": true,
    "resultsVisible": true,
    "myVotes": [
      0
    ]
  },
  "quotes": null,
  "continues": null,
  "counts": {
    "replies": 4,
    "likes": 31,
    "reposts": 2
  },
  "pinned": false,
  "giftDrop": {
    "item": "plan",
    "quantity": 3,
    "places": 10,
    "left": 4,
    "audience": "followers",
    "newAccounts": false,
    "status": "open",
    "claimed": true
  },
  "createdAt": 1758624000000
}

`Reply`

Ответ под постом: пост с двумя дополнительными полями.

Все поля Post, а также:

Поле	Тип	Значение
`postId`	`string`	Пост, к которому относится вся ветка.
`parentId`	`string`или null	Ответ, на который отвечает этот (`null`, если отвечает прямо на пост).

Пример

{
  "id": "9e4b1c7d-2a3f-4d5e-8b6c-0f1e2d3c4b5a",
  "text": "Same here, the lavender is full of them.",
  "kind": "post",
  "author": {
    "id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
    "handle": "jon",
    "name": "Jon",
    "verified": false,
    "accountKind": "person"
  },
  "community": null,
  "media": [],
  "poll": null,
  "quotes": null,
  "continues": null,
  "counts": {
    "replies": 0,
    "likes": 3,
    "reposts": 0
  },
  "pinned": false,
  "giftDrop": null,
  "createdAt": 1758624600000,
  "postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
  "parentId": null
}

`ReplyVote`

Твой голос за ответ и его рейтинг.

Поле	Тип	Значение
`vote`	`string`	Твой голос. `up` — За. `down` — Против. `none` — Нет голоса.
`score`	`integer`	Голоса за минус голоса против, может быть ниже нуля.

Пример

{
  "vote": "up",
  "score": 12
}

`PlannedReply`

Твой ответ, запланированный на потом.

Поле	Тип	Значение
`id`	`string`	`id` запланированного ответа.
`parentId`	`string`или null	Ответ, на который он ответит (`null`, если прямо на пост).
`text`	`string`	Текст.
`publishAt`	`integer`	Когда он выйдет.
`state`	`string`	Его состояние. `waiting` — Ждёт своего времени. `failed` — Не удалось отправить, например, потому что поста больше нет.

Пример

{
  "id": "3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9",
  "parentId": null,
  "text": "Count me in for Saturday!",
  "publishAt": 1758710400000,
  "state": "waiting"
}

`ReplySettings`

Настройки ответов одного из твоих постов.

Поле	Тип	Значение
`audience`	`string`	Кто может отвечать. `all` — Все. `following` — Аккаунты, на которые ты подписан. `mentioned` — Упомянутые в посте. `nobody` — Никто, кроме тебя.
`approval`	`boolean`	Ждут ли ответы твоего одобрения.
`slow`	`string`	Медленный режим. `auto` — Включается сам, когда приходит много ответов. `on` — Всегда включён. `off` — Выключен.

Пример

{
  "audience": "following",
  "approval": false,
  "slow": "auto"
}

`Counts`

Сколько у поста ответов, отметок и репостов.

Поле	Тип	Значение
`replies`	`integer`	Ответы, все уровни вместе.
`likes`	`integer`	Отметки «нравится».
`reposts`	`integer`	Репосты.

Пример

{
  "replies": 4,
  "likes": 31,
  "reposts": 2
}

`Media`

Изображение поста или сообщения.

Поле	Тип	Значение
`url`	`string`	Адрес картинки или видео относительно этого сервера. Загружай с ключом в заголовке.
`kind`	`string`	`image`, `video` или `gif` (с 2.10). Видео и GIF — это файлы MP4. `image` — Изображение (WebP или JPEG). `video` — Видео в MP4 со звуком. `gif` — GIF в виде беззвучного зацикленного MP4.
`poster`	`string`или null	Для видео и GIF адрес картинки предпросмотра, иначе `null` (с 2.10).
`ai`	`string`или null	Создано ли изображение с ИИ, как указал загрузивший или отметила команда после жалобы; `null` без отметки (с 2.11). `with` — Создано с ИИ. `without` — Создано без ИИ.

Пример

{
  "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
  "kind": "image",
  "poster": null,
  "ai": "without"
}

`Poll`

Опрос поста.

Поле	Тип	Значение
`options`	`PollOption[]`	Варианты по порядку. `option` при голосовании считается с 0.
`total`	`integer`	Все голоса вместе, всегда есть.
`multiple`	`boolean`	Можно ли выбрать больше одного варианта.
`endsAt`	`integer`или null	Когда опрос заканчивается (`null`, если он без конца).
`running`	`boolean`	Можно ли ещё голосовать.
`resultsVisible`	`boolean`	Показываются ли голоса по вариантам (см. `votes`).
`myVotes`	`integer[]`	Выбранные тобой варианты, считая с 0.

Пример

{
  "options": [
    {
      "text": "Lavender",
      "votes": 12
    },
    {
      "text": "Sunflowers",
      "votes": 7
    },
    {
      "text": "Clover",
      "votes": 3
    }
  ],
  "total": 22,
  "multiple": false,
  "endsAt": null,
  "running": true,
  "resultsVisible": true,
  "myVotes": [
    0
  ]
}

`PollOption`

Один вариант ответа опроса.

Поле	Тип	Значение
`text`	`string`	Вариант ответа.
`votes`	`integer`или null	Его голоса (`null`, пока результаты скрыты).

Пример

{
  "text": "Lavender",
  "votes": 12
}

`ProfileBrief`

Профиль, как он появляется внутри других объектов: как автор, в поиске.

Поле	Тип	Значение
`id`	`string`	id аккаунта: то, что ждут `/relations` и `/conversations/{with}`.
`handle`	`string`	Короткое имя, без `@`, в том написании, которое выбрал участник.
`name`	`string`	Отображаемое имя. Может содержать эмодзи, в том числе `:name:`.
`verified`	`boolean`	Подтверждён ли аккаунт.
`accountKind`	`string`	Какого вида аккаунт. `person` — Человек. `business` — Компания. `association` — Клуб или объединение. `automated` — Автоматический аккаунт, например бот. `bot` — Бот групп, которым управляет программа с собственным ключом (с 2.18).

Пример

{
  "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
  "handle": "mara",
  "name": "Mara 🌻",
  "verified": true,
  "accountKind": "person"
}

`Profile`

Профиль сам по себе, с описанием и подписчиками.

Все поля ProfileBrief, а также:

Поле	Тип	Значение
`about`	`string`или null	Описание (`null`, если его нет).
`website`	`string`или null	Сайт профиля (`null`, если его нет). С 2.3.
`websiteVerified`	`boolean`	Ссылается ли сайт на этот профиль через `rel=me`, проверяется еженедельно. С 2.3.
`followers`	`integer`	Сколько аккаунтов на него подписаны.
`createdAt`	`integer`или null	Когда создан аккаунт (`null`, пока участник скрывает дату регистрации; с 2.9).

Пример

{
  "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
  "handle": "mara",
  "name": "Mara 🌻",
  "verified": true,
  "accountKind": "person",
  "about": "Beekeeper, allotment, too many seeds. :tellmelo:",
  "website": "https://mara-imkerei.example/",
  "websiteVerified": true,
  "followers": 148,
  "createdAt": 1750848000000
}

`CommunityBrief`

Группа, в которой написан пост.

Поле	Тип	Значение
`id`	`string`	id группы.
`name`	`string`или null	Её название.

Пример

{
  "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
  "name": "Urban Gardening"
}

`Community`

Группа этого сервера.

Поле	Тип	Значение
`id`	`string`	id группы.
`name`	`string`	Её название.
`handle`	`string`или null	Короткое имя для упоминания группы через `@#`. С 2.15.
`description`	`string`или null	Описание (`null`, если его нет).
`tags`	`string[]`	Темы, которым она посвящена.
`members`	`integer`	Сколько в ней участников.
`joinPolicy`	`string`	Как в неё попасть. `open` — Вступить может любой. `application` — Для вступления нужна заявка, которую принимает группа. `invite` — Только по приглашению.
`visibility`	`string`	Кто её видит. `internal` и `hidden` — только участники (с 2.15). `open` — Видна всем. `internal` — Нет в каталоге, но доступна по адресу. `hidden` — Только для участников.
`feedChannel`	`boolean`	Включён ли её канал ленты. С 2.15.
`sparks`	`integer`	Сколько искр сейчас у группы (с 2.19).
`perks`	`string[]`	Бонусы, которые оплачивают её искры (с 2.19).
`membership`	`Membership`или null	Кто твой аккаунт в группе и что он может; `null`, если он не участник. С 2.15.

Пример

{
  "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
  "name": "Urban Gardening",
  "handle": "urbangardening",
  "description": "Balconies, allotments, rooftops: whatever grows.",
  "tags": [
    "garden",
    "bees"
  ],
  "members": 312,
  "joinPolicy": "open",
  "visibility": "open",
  "feedChannel": true,
  "sparks": 24,
  "perks": [
    "tint",
    "welcome"
  ],
  "membership": {
    "leader": null,
    "roles": [
      "4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"
    ],
    "permissions": [
      "attach",
      "invite",
      "send",
      "view"
    ],
    "mutedUntil": null
  }
}

`Membership`

Кто твой аккаунт в группе и что он может.

Поле	Тип	Значение
`leader`	`string`или null	Основал ли ты группу или ведёшь её вместе с основателем; иначе `null`. `founder` — Основатель. `manager` — Соруководитель.
`roles`	`string[]`	`id` твоих ролей, сначала высшая.
`permissions`	`string[]`	Что ты можешь в группе.
`mutedUntil`	`integer`или null	До какого времени тебя здесь заглушает таймаут; `null`, если нет.

Пример

{
  "leader": null,
  "roles": [
    "4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"
  ],
  "permissions": [
    "attach",
    "invite",
    "send",
    "view"
  ],
  "mutedUntil": null
}

`Person`

Участник, кратко.

Поле	Тип	Значение
`id`	`string`	`id` аккаунта.
`handle`	`string`	Имя пользователя без `@`.
`name`	`string`	Отображаемое имя.
`bot`	`boolean`	Является ли аккаунт ботом (с 2.18).

Пример

{
  "id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
  "handle": "jon",
  "name": "Jon",
  "bot": false
}

`Channel`

Канал группы.

Поле	Тип	Значение
`id`	`string`	`id`.
`kind`	`string`	Тип канала. `feed` — Канал ленты, публикации которого есть и в публичной ленте. `chat` — Чат. `voice` — Голосовой канал; говорить можно только в приложении. `hub` — Хаб группы: её страница о том, что она такое. Есть всегда, без сообщений.
`name`	`string`или null	Название без `#`; `null` — название, которое приложение даёт на каждом языке.
`topic`	`string`	Тема; пусто, если её нет.
`category`	`ChannelCategory`или null	Категория; `null`, если нет.
`unread`	`integer`	Сколько сообщений других ты ещё не прочитал, до 100.
`permissions`	`string[]`	Что ты можешь в этом канале.
`symbol`	`ChannelSymbol`	Его символ; форма — уже групповая, если группа её задаёт.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a",
  "kind": "chat",
  "name": "harvest",
  "topic": "What came in this week",
  "category": {
    "id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
    "name": "Garden",
    "symbol": {
      "emoji": null,
      "icon": null,
      "image": null,
      "color": null,
      "shape": null
    }
  },
  "unread": 3,
  "permissions": [
    "view",
    "send"
  ],
  "symbol": {
    "emoji": "🌻",
    "icon": null,
    "image": null,
    "color": "amber",
    "shape": "circle"
  }
}

`ChannelCategory`

Категория, в которой находится канал.

Поле	Тип	Значение
`id`	`string`	`id`.
`name`	`string`	Название.
`symbol`	`ChannelSymbol`	Её символ.

Пример

{
  "id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
  "name": "Garden",
  "symbol": {
    "emoji": null,
    "icon": null,
    "image": null,
    "color": null,
    "shape": null
  }
}

`ChannelSymbol`

Символ канала или категории: не больше одного из эмодзи, символа и картинки, иначе знак его вида.

Поле	Тип	Значение
`emoji`	`string`или null	Эмодзи; `null`, если нет.
`icon`	`string`или null	Имя символа из набора приложения; `null`, если нет.
`image`	`string`или null	Адрес своей картинки; `null`, если нет.
`color`	`string`или null	Цвет плитки; `null` — цвет его вида.
`shape`	`string`или null	Форма плитки; `null` — круг.

Пример

{
  "emoji": "🌻",
  "icon": null,
  "image": null,
  "color": "amber",
  "shape": "circle"
}

`ChannelMessage`

Сообщение в чат-канале.

Поле	Тип	Значение
`id`	`string`	`id`.
`text`	`string`или null	Текст (`null` у сообщения только из изображений или голоса).
`author`	`Person`	Кто его написал.
`media`	`Media[]`	Его изображения и голосовые сообщения; пусто, если их нет.
`replyTo`	`string`или null	`id` сообщения, на которое оно отвечает; `null`, если ни на какое.
`roleColor`	`string`или null	Цвет высшей роли автора, у которой есть цвет; `null`, если нет.
`threadOf`	`string`или null	Сообщение, в ветке которого отвечает это; в чате `null`.
`threadCount`	`integer`	Сколько ответов в ветке этого сообщения.
`card`	`object`или null	Карточка бота: `title`, `text`, `color` и `fields`; иначе `null`.
`buttons`	`object[]`	Кнопки бота: у каждой `id`, `label` и `style`.
`createdAt`	`integer`	Когда оно написано.

Пример

{
  "id": "61a2b3c4-d5e6-4f70-8192-a3b4c5d6e7f8",
  "text": "@jon the first tomatoes are ripe 🍅",
  "author": {
    "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
    "handle": "mara",
    "name": "Mara 🌻",
    "bot": false
  },
  "media": [
    {
      "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
      "kind": "image",
      "poster": null,
      "ai": "without"
    }
  ],
  "replyTo": "72b3c4d5-e6f7-4081-92a3-b4c5d6e7f809",
  "roleColor": "green",
  "threadOf": null,
  "threadCount": 3,
  "card": null,
  "buttons": [],
  "createdAt": 1758631200000
}

`Role`

Роль группы.

Поле	Тип	Значение
`id`	`string`	`id`.
`name`	`string`или null	Название; `null` у @everyone.
`everyone`	`boolean`	Это ли @everyone, роль всех участников.
`color`	`string`или null	Цвет: `indigo`, `violet`, `rose`, `amber`, `green` или `teal`; `null`, если нет.
`permissions`	`string[]`	Её права.
`members`	`integer`	У скольких она есть; у @everyone — все участники.
`editable`	`boolean`	Может ли твой аккаунт её менять.
`selfable`	`boolean`	Берут ли участники роль сами и снимают ли её.

Пример

{
  "id": "4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8",
  "name": "Gardeners",
  "everyone": false,
  "color": "green",
  "permissions": [
    "attach",
    "invite",
    "send",
    "view"
  ],
  "members": 24,
  "editable": true,
  "selfable": false
}

`GroupMember`

Участник группы с его ролями.

Все поля Person, а также:

Поле	Тип	Значение
`leader`	`string`или null	Основал ли участник группу или ведёт её вместе с основателем; иначе `null`. `founder` — Основатель. `manager` — Соруководитель.
`roles`	`string[]`	`id` его ролей, сначала высшая.
`mutedUntil`	`integer`или null	До какого времени участник заглушён, если твой аккаунт может заглушать; иначе `null`.

Пример

{
  "id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
  "handle": "jon",
  "name": "Jon",
  "bot": false,
  "leader": null,
  "roles": [
    "4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8"
  ],
  "mutedUntil": null
}

`ChannelOverride`

Что роль может в канале иначе, чем в группе.

Поле	Тип	Значение
`role`	`string`	`id` роли.
`allow`	`string[]`	Что она может здесь дополнительно.
`deny`	`string[]`	Что она здесь не может.

Пример

{
  "role": "4e5f6a7b-8c9d-4e0f-a1b2-c3d4e5f6a7b8",
  "allow": [
    "send"
  ],
  "deny": []
}

`Bell`

Колокольчик группы.

Поле	Тип	Значение
`level`	`string`	Какие уведомления приходят. `all` — Каждая новая публикация в канале ленты, плюс @everyone. `important` — Публикации руководства в канале ленты, плюс @everyone. `off` — Ничего, кроме упоминаний через `@имя`.

Пример

{
  "level": "important"
}

`InviteLink`

Ссылка-приглашение группы.

Поле	Тип	Значение
`code`	`string`	Код.
`url`	`string`	Адрес, которым можно поделиться.
`createdBy`	`Person`или null	Кто её создал; `null`, если аккаунт удалён.
`createdAt`	`integer`	Когда она создана.
`expiresAt`	`integer`или null	До какого времени действует; `null` — бессрочно.
`uses`	`integer`	Сколько раз её использовали.
`maxUses`	`integer`или null	Сколько раз её можно использовать; `null` — без ограничений.

Пример

{
  "code": "k7Qm2xPa",
  "url": "https://tellmelo.com/groups?join=k7Qm2xPa",
  "createdBy": {
    "id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
    "handle": "jon",
    "name": "Jon",
    "bot": false
  },
  "createdAt": 1758624000000,
  "expiresAt": 1759228800000,
  "uses": 3,
  "maxUses": 10
}

`InvitePreview`

Куда ведёт ссылка-приглашение.

Поле	Тип	Значение
`community`	`InviteGroup`	Группа.
`member`	`boolean`	Состоит ли твой аккаунт уже в группе.

Пример

{
  "community": {
    "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
    "name": "Urban Gardening",
    "members": 312,
    "rules": [
      "Be kind.",
      "No advertising."
    ]
  },
  "member": false
}

`InviteGroup`

Группа за ссылкой-приглашением.

Поле	Тип	Значение
`id`	`string`	`id`.
`name`	`string`	Название.
`members`	`integer`	Сколько в ней участников.
`rules`	`string[]`	Её правила, которые принимают при вступлении; пусто, если их нет.

Пример

{
  "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
  "name": "Urban Gardening",
  "members": 312,
  "rules": [
    "Be kind.",
    "No advertising."
  ]
}

`Joined`

Вступление по ссылке-приглашению.

Поле	Тип	Значение
`community`	`string`	`id` группы.

Пример

{
  "community": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60"
}

`LogEntry`

Запись в журнале руководства.

Поле	Тип	Значение
`id`	`string`	`id`.
`action`	`string`	Что произошло. `post_removed` — Публикация. `member_removed` — Участник удалён, до 2.16 (на 90 дней). `message_removed` — Сообщение в чат-канале. `member_kicked` — Исключение. `member_banned` — Бан. `member_unbanned` — Снятый бан. `member_timed_out` — Заглушение. `timeout_lifted` — Снятое заглушение. `voice_muted` — Микрофон отключён в голосовом канале. `voice_removed` — Отключение от голосового канала. `bot_added` — Бот добавлен в группу (с 2.18). `bot_removed` — Бот удалён из группы (с 2.18).
`member`	`Person`	Кого это касалось.
`reason`	`string`	Причина; пусто для сообщений и если её не указали.
`by`	`string`или null	Имя того, кто это сделал; `null`, если аккаунт удалён.
`createdAt`	`integer`	Когда.

Пример

{
  "id": "8f7e6d5c-4b3a-4291-8f7e-6d5c4b3a2918",
  "action": "message_removed",
  "member": {
    "id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
    "handle": "jon",
    "name": "Jon",
    "bot": false
  },
  "reason": "",
  "by": "Mara 🌻",
  "createdAt": 1758710400000
}

`Ban`

Бан в группе.

Поле	Тип	Значение
`member`	`Person`	Кто забанен.
`until`	`integer`или null	До какого времени; `null`, пока не снимут.
`createdAt`	`integer`или null	С какого времени; `null` для банов до 2.16.
`by`	`string`или null	Имя того, кто забанил; `null`, если неизвестно.

Пример

{
  "member": {
    "id": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
    "handle": "jon",
    "name": "Jon",
    "bot": false
  },
  "until": 1759228800000,
  "createdAt": 1758624000000,
  "by": "Mara 🌻"
}

`Until`

Когда заканчивается заглушение или бан.

Поле	Тип	Значение
`until`	`integer`или null	Момент; `null` для бессрочного бана или снятого заглушения.

Пример

{
  "until": 1758624600000
}

`Tag`

Тег и сколько постов его несут.

Поле	Тип	Значение
`tag`	`string`	Тег, без `#`.
`posts`	`integer`	Сколько недавних постов его несут.

Пример

{
  "tag": "garden",
  "posts": 58
}

`SearchResult`

Три списка, возможно пустых.

Поле	Тип	Значение
`posts`	`Post[]`	Подходящие посты, сначала новые.
`profiles`	`ProfileBrief[]`	Подходящие профили, по короткому имени.
`tags`	`Tag[]`	Подходящие теги, сначала самые используемые.

Пример

{
  "posts": [
    {
      "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
      "text": "The bees are back in the garden 🐝 #garden",
      "kind": "poll",
      "author": {
        "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
        "handle": "mara",
        "name": "Mara 🌻",
        "verified": true,
        "accountKind": "person"
      },
      "community": {
        "id": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
        "name": "Urban Gardening"
      },
      "media": [
        {
          "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
          "kind": "image",
          "poster": null,
          "ai": "without"
        }
      ],
      "poll": {
        "options": [
          {
            "text": "Lavender",
            "votes": 12
          },
          {
            "text": "Sunflowers",
            "votes": 7
          },
          {
            "text": "Clover",
            "votes": 3
          }
        ],
        "total": 22,
        "multiple": false,
        "endsAt": null,
        "running": true,
        "resultsVisible": true,
        "myVotes": [
          0
        ]
      },
      "quotes": null,
      "continues": null,
      "counts": {
        "replies": 4,
        "likes": 31,
        "reposts": 2
      },
      "pinned": false,
      "giftDrop": {
        "item": "plan",
        "quantity": 3,
        "places": 10,
        "left": 4,
        "audience": "followers",
        "newAccounts": false,
        "status": "open",
        "claimed": true
      },
      "createdAt": 1758624000000
    }
  ],
  "profiles": [
    {
      "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
      "handle": "mara",
      "name": "Mara 🌻",
      "verified": true,
      "accountKind": "person"
    }
  ],
  "tags": [
    {
      "tag": "garden",
      "posts": 58
    }
  ]
}

`Emoji`

Эмодзи этого сервера.

Поле	Тип	Значение
`name`	`string`	Имя, как оно стоит между двоеточиями.
`url`	`string`	Адрес картинки относительно этого сервера.

Пример

{
  "name": "tellmelo",
  "url": "/api/media?id=e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b"
}

`Notification`

Уведомление. Одна строка может объединять несколько событий одного вида.

Поле	Тип	Значение
`id`	`string`	id уведомления.
`kind`	`string`	Что произошло. `reply` — Кто-то тебе ответил. `like` — Кому-то нравится твой пост. `reply_like` — Кто-то голосует «за» твой ответ. `duel` — Кто-то вызывает тебя на «Дуэль постов», или твой вызов сыгран. `reply_pick` — Автор поста выделяет твой ответ. `repost` — Кто-то репостнул твой пост. `follow` — Кто-то на тебя подписался. `mention` — Кто-то тебя упомянул. `group_mention` — Кто-то упомянул группу, которую ты ведёшь; `text` — её название. `channel_mention` — Кто-то упомянул тебя в чат-канале одной из твоих групп, в том числе через @everyone; участник указан как `actor`, в предложении названы канал и группа, но никогда не сообщение. `message` — Кто-то написал тебе сообщение. `scheduled` — Твой запланированный пост опубликован. `video` — Твой пост, ждавший своё видео, вышел или снова стал черновиком. `reminder` — Пора напоминания о сохранённом посте. `report` — Что стало с жалобой, которую ты отправил. `moderation` — Решение по твоему аккаунту: предупреждение, ограничение, обжалование. `team` — Новая работа для команды (только владельцы, админы и модераторы). `reward` — Награда за приглашение скоро истечёт или истекла. `gift` — Подарок от команды: тариф или искры для тебя или для группы, которую ты ведёшь. `present` — Подарок от участника: искры или время тарифа; участник — это `actor`. `spark` — Искры скоро истекают, или группе, которой ты руководишь, больше не хватает искр на бонусы. `loyalty` — О ритме верности: активная неделя засчитана или не хватает одного дня, награда новая или скоро пропадёт. `impact` — Как прошли твои посты за двенадцать часов через сутки, в одном уведомлении. `discovery` — Приглашение в программу «Находка» или сообщение о начале или конце места в ней. `group_post` — Новый пост в группе, колокольчик которой на это настроен. `group_moderation` — Руководство группы удалило твой пост или тебя из группы. `group` — Действие участника в группе, касающееся тебя: пригласил(а), принял(а) или отклонил(а), сделал(а) соадминистратором, передал(а) или распустил(а) группу либо подал(а) заявку в твою группу; участник — это `actor`, название группы стоит в конце предложения. `coauthor` — Кто-то пригласил тебя соавтором поста. `partner` — Напоминание партнёрской программы или снятие значка партнёра. `news` — Новая статья в регионе, на который ты подписан(а). `pick` — Твой пост претендует на звание поста недели или года — или уже победил. `advent` — Открыто новое окошко адвент-календаря, окошко открыто или сегодняшнее ещё ждёт. `team_message` — Сообщение, которое команда tellmelo написала выбранным участникам. `challenge` — Начался новый челлендж недели. `nudge` — Один раз: пост, на который ещё никто не ответил, или текущий челлендж. `signin` — Компьютер спрашивает, входишь ли ты на нём прямо сейчас.
`text`	`string`или null	Только для жалоб и модерации: связанный текст, иначе `null`.
`actor`	`Actor`	Кто это сделал.
`postId`	`string`или null	Пост, о котором речь (`null`, если ни о каком).
`read`	`boolean`	Отмечено ли прочитанным.
`more`	`integer`	Сколько ещё событий представляет эта строка, кроме названного.
`createdAt`	`integer`	Когда это произошло впервые.
`updatedAt`	`integer`	Когда к нему в последний раз добавилось событие. Список отсортирован по этому полю.

Пример

{
  "id": "3f2e1d0c-9b8a-4765-8432-10fedcba9876",
  "kind": "like",
  "text": null,
  "actor": {
    "handle": "jon",
    "name": "Jon"
  },
  "postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
  "read": false,
  "more": 2,
  "createdAt": 1758624300000,
  "updatedAt": 1758624900000
}

`Actor`

Кто вызвал уведомление.

Поле	Тип	Значение
`handle`	`string`	Короткое имя.
`name`	`string`	Отображаемое имя.

Пример

{
  "handle": "jon",
  "name": "Jon"
}

`Conversation`

Одна строка твоего ящика.

Поле	Тип	Значение
`with`	`string`	id другого аккаунта: то, что ждёт `/conversations/{with}/messages`.
`handle`	`string`	Его короткое имя.
`name`	`string`	Его отображаемое имя.
`excerpt`	`string`или null	Начало последнего сообщения (`null`, если в нём нет текста).
`truncated`	`boolean`	Обрезан ли отрывок.
`fromMe`	`boolean`	Твоё ли последнее сообщение.
`lastMessageId`	`string`	id последнего сообщения.
`unread`	`integer`	Сколько его сообщений ты ещё не прочитал.
`updatedAt`	`integer`	Когда написано последнее сообщение.

Пример

{
  "with": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
  "handle": "jon",
  "name": "Jon",
  "excerpt": "See you on Saturday at the market!",
  "truncated": false,
  "fromMe": true,
  "lastMessageId": "7c6b5a49-3827-4165-9f0e-d1c2b3a49586",
  "unread": 0,
  "updatedAt": 1758624060000
}

`Message`

Сообщение в переписке.

Поле	Тип	Значение
`id`	`string`	id сообщения.
`text`	`string`или null	Текст (`null` для сообщения только из картинок).
`from`	`string`	id аккаунта, который его написал.
`to`	`string`	id аккаунта, которому оно написано.
`read`	`boolean`	Прочитал ли его получатель.
`media`	`Media[]`	Его изображения; пусто, если их нет.
`replyTo`	`string`или null	`id` сообщения, на которое отвечает это (`null`, если ни на какое). С 2.2.
`createdAt`	`integer`	Когда отправлено.

Пример

{
  "id": "7c6b5a49-3827-4165-9f0e-d1c2b3a49586",
  "text": "See you on Saturday at the market!",
  "from": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
  "to": "d4c3b2a1-6e5f-4a7b-9c8d-1e2f3a4b5c6d",
  "read": true,
  "media": [],
  "replyTo": null,
  "createdAt": 1758624060000
}

`PlannedMessage`

Твоё сообщение, запланированное на потом.

Поле	Тип	Значение
`id`	`string`	`id` запланированного сообщения.
`to`	`string`	`id` аккаунта-получателя.
`text`	`string`или null	Текст, `null` при сквозном шифровании.
`sendAt`	`integer`	Когда оно будет отправлено.
`state`	`string`	Его состояние. `waiting` — Ждёт своего времени. `held` — Задержано, потому что подписка закончилась. Можно отправить его самому или удалить. `failed` — Не удалось отправить.

Пример

{
  "id": "3b2a1c0d-9e8f-4a7b-b6c5-d4e3f2a1b0c9",
  "to": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
  "text": "Happy birthday! 🎂",
  "sendAt": 1758710400000,
  "state": "waiting"
}

`ScheduledPost`

Твой пост, который ещё не вышел.

Поле	Тип	Значение
`id`	`string`	id поста.
`text`	`string`или null	Текст.
`communityId`	`string`или null	Группа, в которой он выйдет (`null` вне групп).
`publishAt`	`integer`или null	Когда он выйдет (`null`, пока он ждёт чего-то другого).
`deleteAt`	`integer`или null	Когда он удалится сам (`null` – никогда).
`waitingFor`	`string`	Чего он ждёт. `time` — Своего времени. `review` — Одобрения текста, написанного на проверку. `check` — Проверки автоматической модерацией. `payment` — Оплаты своих подарков.
`createdAt`	`integer`	Когда он написан.

Пример

{
  "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
  "text": "Market day tomorrow – see you at the bee stand! #garden",
  "communityId": null,
  "publishAt": 1758710400000,
  "deleteAt": null,
  "waitingFor": "time",
  "createdAt": 1758624000000
}

`Collection`

Подборка сохранённых постов.

Поле	Тип	Значение
`id`	`string`	`id` подборки.
`name`	`string`	Её название.
`count`	`integer`	Сколько в ней постов.

Пример

{
  "id": "6d5c4b3a-2918-4e7f-a1b2-c3d4e5f60718",
  "name": "Recipes",
  "count": 12
}

`Event`

Предстоящее событие профиля.

Поле	Тип	Значение
`id`	`string`	`id` события.
`title`	`string`	Название.
`startsAt`	`integer`	Начало.
`endsAt`	`integer`или null	Конец, `null` без конца.
`place`	`string`или null	Место.
`description`	`string`или null	Описание.
`signups`	`EventSignups`или null	Запись, `null` без записи.

Пример

{
  "id": "2a3b4c5d-6e7f-4809-9a1b-2c3d4e5f6a7b",
  "title": "Seed swap",
  "startsAt": 1758883200000,
  "endsAt": 1758890400000,
  "place": "Community garden",
  "description": "Bring seeds, take seeds.",
  "signups": {
    "count": 14,
    "going": true
  }
}

`EventSignups`

Сколько человек записалось.

Поле	Тип	Значение
`count`	`integer`	Число записавшихся.
`going`	`boolean`	Записан ли ты.

Пример

{
  "count": 14,
  "going": true
}

`EventSignup`

Тот, кто записался на твоё событие.

Поле	Тип	Значение
`id`	`string`	`id` аккаунта.
`handle`	`string`	Имя пользователя.
`name`	`string`	Отображаемое имя.
`at`	`integer`	Когда записался.

Пример

{
  "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
  "handle": "mara",
  "name": "Mara 🌻",
  "at": 1758624000000
}

`Picture`

Загруженное изображение.

Поле	Тип	Значение
`id`	`string`	`id` изображения.
`url`	`string`	Где его можно увидеть.

Пример

{
  "id": "8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
  "url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9"
}

`EmojiPicture`

Загруженное изображение эмодзи.

Поле	Тип	Значение
`id`	`string`	`id` изображения.
`url`	`string`	Где его можно увидеть.
`animated`	`boolean`	Анимировано ли оно.

Пример

{
  "id": "8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
  "url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
  "animated": false
}

`OwnEmoji`

Один из твоих эмодзи.

Поле	Тип	Значение
`name`	`string`	Его имя.
`url`	`string`	Его изображение.
`animated`	`boolean`	Анимирован ли он.
`resting`	`boolean`	Отдыхает, потому что подписка сейчас позволяет меньше эмодзи: он остаётся, но недоступен.

Пример

{
  "name": "sunflower",
  "url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
  "animated": false,
  "resting": false
}

`GroupEmoji`

Эмодзи группы.

Поле	Тип	Значение
`name`	`string`	Его имя.
`url`	`string`	Его изображение.
`animated`	`boolean`	Анимирован ли он.

Пример

{
  "name": "seedling",
  "url": "/api/media?id=8c7b6a59-4837-4261-9f5e-d4c3b2a1f0e9",
  "animated": false
}

`BotEvent`

Событие в одной из групп бота.

Поле	Тип	Значение
`id`	`string`	Его номер, по возрастанию; с ним продолжают (`since`, `Last-Event-ID`).
`type`	`string`	Что произошло. `message.created` — Написано сообщение. `message.deleted` — Удалено сообщение. `member.joined` — Кто-то вступил. `member.left` — Кто-то ушёл или был удалён. `voice.joined` — Кто-то вошёл в голосовой канал. `command` — Кто-то использовал команду бота. `interaction` — Кто-то нажал кнопку в сообщении бота.
`community`	`string`	Группа.
`channel`	`string`или null	Канал; `null` для всей группы.
`createdAt`	`integer`	Когда это произошло.
`data`	`object`	Что к нему относится, по типу: `message`, `member` (с `reason`), `command` или `interaction`.

Пример

{
  "id": "4711",
  "type": "message.created",
  "community": "c81d4e2a-0f3b-4a6c-9e57-1d2b3c4a5f60",
  "channel": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a",
  "createdAt": 1758634800000,
  "data": {
    "message": {
      "id": "61a2b3c4-d5e6-4f70-8192-a3b4c5d6e7f8",
      "text": "/dice 6",
      "author": {
        "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
        "handle": "mara",
        "name": "Mara 🌻",
        "bot": false
      },
      "media": 0,
      "replyTo": null,
      "threadOf": null,
      "createdAt": 1758634800000
    }
  }
}

`BotCommand`

Команда бота.

Поле	Тип	Значение
`name`	`string`	Её имя, без «/».
`description`	`string`	Что она делает.

Пример

{
  "name": "dice",
  "description": "Rolls a die"
}

`VoiceSeat`

Место в голосовом канале.

Поле	Тип	Значение
`url`	`string`	Адрес медиасервера (LiveKit).
`token`	`string`	Токен для этого канала, действует несколько минут.
`iceServers`	`object[]`	Серверы STUN и TURN для соединения.
`speak`	`boolean`	Может ли бот передавать туда звук.
`video`	`boolean`	Может ли бот передавать туда видео.

Пример

{
  "url": "wss://voice.example.org",
  "token": "eyJhbGciOiJIUzI1NiJ9…",
  "iceServers": [
    {
      "urls": [
        "stun:turn.example.org:3478"
      ]
    }
  ],
  "speak": true,
  "video": false
}

`Webhook`

Один из твоих вебхуков.

Поле	Тип	Значение
`id`	`string`	`id` вебхука.
`url`	`string`	Его адрес.
`kinds`	`string[]`	О чём ему сообщают.
`active`	`boolean`	Получает ли он доставки. После многих неудач подряд отключается.
`lastStatus`	`integer`или null	HTTP-статус последней доставки.
`lastAt`	`integer`или null	Когда была последняя доставка.
`failures`	`integer`	Неудачи подряд.

Пример

{
  "id": "1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
  "url": "https://example.org/tellmelo-hook",
  "kinds": [
    "reply",
    "mention"
  ],
  "active": true,
  "lastStatus": 200,
  "lastAt": 1758624000000,
  "failures": 0
}

`WebhookCreated`

Новый вебхук с его секретом.

Поле	Тип	Значение
`id`	`string`	`id` вебхука.
`secret`	`string`	Секрет для подписей, только в этот раз.

Пример

{
  "id": "1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
  "secret": "whsec_3f9a…"
}

`GroupBot`

Бот группы.

Поле	Тип	Значение
`id`	`string`	`id` аккаунта бота.
`handle`	`string`	Его короткое имя.
`name`	`string`	Его имя.
`description`	`string`	Что он делает, словами владельца.
`permissions`	`string[]`	Что разрешает его роль в группе.

Пример

{
  "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
  "handle": "gardenbot",
  "name": "Garden bot",
  "description": "Reminds the group of watering days.",
  "permissions": [
    "send",
    "view"
  ]
}

`VoiceRoom`

Голосовой канал с людьми в нём.

Поле	Тип	Значение
`channel`	`string`	`id` канала.
`people`	`VoicePerson[]`	Кто сейчас в нём.

Пример

{
  "channel": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a",
  "people": [
    {
      "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
      "handle": "mara",
      "name": "Mara 🌻",
      "muted": false,
      "deaf": false,
      "camera": false,
      "screen": true
    }
  ]
}

`VoicePerson`

Кто-то в голосовом канале.

Поле	Тип	Значение
`id`	`string`	`id` аккаунта.
`handle`	`string`	Короткое имя.
`name`	`string`	Отображаемое имя.
`muted`	`boolean`	Выключен ли микрофон.
`deaf`	`boolean`	Не слышит ли человек ничего (сам так решил).
`camera`	`boolean`	Включена ли камера.
`screen`	`boolean`	Показывает ли экран.

Пример

{
  "id": "a3e1f7c2-54b9-4d0e-8f16-7b2c9d4e1a05",
  "handle": "mara",
  "name": "Mara 🌻",
  "muted": true,
  "deaf": false,
  "camera": false,
  "screen": false
}

`GiftDrop`

Подарки под постом – никогда с именами тех, кто их забрал.

Поле	Тип	Значение
`item`	`string`	Что входит в место. `plan` — Месяцы тарифа (Сторонник). `sparks` — Искры.
`quantity`	`integer`	Сколько в каждом месте: месяцев или искр.
`places`	`integer`	Сколько всего мест.
`left`	`integer`	Сколько ещё свободно.
`audience`	`string`	Кто может забрать. `all` — Все. `followers` — Только подписчики того, кто раздаёт. `group` — Только участники группы поста.
`newAccounts`	`boolean`	Могут ли забирать аккаунты младше 7 дней.
`status`	`string`	Состояние. `awaiting_payment` — Ждёт оплаты; пост ещё не вышел. `open` — Места ещё можно забрать. `closed` — Всё: места разобраны, оплата возвращена или пост удалён.
`claimed`	`boolean`	Есть ли место у тебя самого (на публичных путях всегда `false`).

Пример

{
  "item": "plan",
  "quantity": 3,
  "places": 10,
  "left": 4,
  "audience": "followers",
  "newAccounts": false,
  "status": "open",
  "claimed": true
}

`OwnGiftDrop`

Твои подарки под постом, с постом и способом оплаты.

Все поля GiftDrop, а также:

Поле	Тип	Значение
`postId`	`string`	Пост, под которым они стоят.
`funding`	`string`	Как они оплачены. `free` — Бесплатно. `quota` — Из квоты. `payment` — Оплачено.
`createdAt`	`integer`	Когда они созданы.

Пример

{
  "item": "plan",
  "quantity": 3,
  "places": 10,
  "left": 4,
  "audience": "followers",
  "newAccounts": false,
  "status": "open",
  "claimed": false,
  "postId": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
  "funding": "quota",
  "createdAt": 1758624000000
}

`Quota`

Что лежит в квоте.

Поле	Тип	Значение
`months`	`integer`	Месяцы тарифа, которые ещё можно подарить.
`sparks`	`integer`	Искры, которые ещё можно подарить.
`looks`	`QuotaLook[]`	Оформления в запасе, которые ещё можно подарить (с 2.13).

Пример

{
  "months": 120,
  "sparks": 500,
  "looks": [
    {
      "id": "frame-gold",
      "name": "Goldring",
      "kind": "frame",
      "quantity": 25
    }
  ]
}

`QuotaLook`

Оформление в запасе партнёра с оставшимся количеством штук (с 2.13).

Поле	Тип	Значение
`id`	`string`	ID оформления; при подарке передавай его как `itemId`.
`name`	`string`	Название оформления.
`kind`	`string`	Вид оформления. `frame` — Рамка профиля. `background` — Эффект обложки. `card` — Карточка профиля.
`quantity`	`integer`	Сколько штук осталось.

Пример

{
  "id": "frame-gold",
  "name": "Goldring",
  "kind": "frame",
  "quantity": 25
}

`QuotaGift`

Подарок из квоты.

Поле	Тип	Значение
`item`	`string`	Что подарено. `plan` — Месяцы тарифа (Сторонник). `sparks` — Искры. `shop` — Оформление из запаса (с 2.13).
`quantity`	`integer`	Сколько.
`itemId`	`string`или null	Подаренное оформление, если `item` — `shop`; иначе `null`.
`recipient`	`Actor`	Кому.
`createdAt`	`integer`	Когда.

Пример

{
  "item": "plan",
  "quantity": 3,
  "itemId": null,
  "recipient": {
    "handle": "jon",
    "name": "Jon"
  },
  "createdAt": 1758627600000
}

`MediaItem`

GIF или видео из медиатеки (с 2.14).

Поле	Тип	Значение
`id`	`string`	ID; для `media` при публикации.
`kind`	`string`	GIF или видео. `gif` — GIF в виде беззвучного зацикленного MP4. `video` — Видео в MP4, со звуком.
`name`	`string`	Название.
`keywords`	`string`	Ключевые слова строчными буквами.
`width`	`integer`	Ширина в пикселях.
`height`	`integer`	Высота в пикселях.
`seconds`	`integer`	Длина в секундах; у GIF — `0`.
`url`	`string`	Файл MP4 относительно этого инстанса. Загружай его с ключом в заголовке.
`poster`	`string`	Превью, тоже с ключом.
`uploader`	`Actor`	Кто загрузил.
`mine`	`boolean`	Твоё ли это.
`shared`	`boolean`	Доступно ли всем в tellmelo.
`anywhere`	`boolean`	Может ли появляться и на других сайтах.
`embed`	`Embed`или null	Адреса для других сайтов; `null`, пока там это не разрешено.

Пример

{
  "id": "b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
  "kind": "gif",
  "name": "Happy bees",
  "keywords": "bees garden happy",
  "width": 480,
  "height": 270,
  "seconds": 0,
  "url": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
  "poster": "/api/media?id=b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918&poster=1",
  "uploader": {
    "handle": "mara",
    "name": "Mara 🌻"
  },
  "mine": false,
  "shared": true,
  "anywhere": true,
  "embed": {
    "page": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
    "file": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/file",
    "poster": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/poster",
    "code": "<iframe src=\"https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918\" width=\"480\" height=\"300\" title=\"Happy bees\" style=\"border:0;max-width:100%\" loading=\"lazy\" allowfullscreen></iframe>"
  }
}

`Embed`

Адреса для других сайтов. Работают без ключа.

Поле	Тип	Значение
`page`	`string`	Плеер для `<iframe>`.
`file`	`string`	Файл MP4 для своего плеера.
`poster`	`string`	Превью.
`code`	`string`	Готовый код для вставки.

Пример

{
  "page": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918",
  "file": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/file",
  "poster": "https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918/poster",
  "code": "<iframe src=\"https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918\" width=\"480\" height=\"300\" title=\"Happy bees\" style=\"border:0;max-width:100%\" loading=\"lazy\" allowfullscreen></iframe>"
}

`UploadStarted`

Начатая загрузка.

Поле	Тип	Значение
`upload`	`string`	ID этой загрузки.
`piece`	`integer`	Максимальный размер фрагмента в байтах.

Пример

{
  "upload": "e7c1a2b3-4d5e-4f60-8a9b-0c1d2e3f4a5b",
  "piece": 4194304
}

`UploadPiece`

Полученный фрагмент.

Поле	Тип	Значение
`received`	`integer`	Сколько байт получено.
`item`	`MediaItem`или null	После последнего фрагмента — новое GIF или видео, иначе `null`.

Пример

{
  "received": 4194304,
  "item": null
}

`Created`

Ответ записи, которая что-то создала.

Поле	Тип	Значение
`id`	`string`	id созданного.
`scheduledFor`	`integer`или null	Когда оно появится, если публикация запланирована (иначе `null`).
`deleteAt`	`integer`или null	Когда оно само удалится, если это задано (иначе `null`).

Пример

{
  "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
  "scheduledFor": null,
  "deleteAt": null
}

`DropCreated`

Ответ, когда создан пост с подарками.

Поле	Тип	Значение
`id`	`string`	id нового поста.
`funding`	`string`	Как оплачены подарки. `free` — Бесплатно. `quota` — Из квоты.

Пример

{
  "id": "5f0c2a9e-8d41-4b7a-9c3e-2e61d0f4a7b1",
  "funding": "quota"
}

`Made`

Что только что создано или изменено.

Поле	Тип	Значение
`id`	`string`	`id`; у ссылки-приглашения — её код.

Пример

{
  "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a"
}

`Ok`

Ответ записи, которой нечего вернуть.

Поле	Тип	Значение
`ok`	`boolean`	Всегда `true`.

Пример

{
  "ok": true
}

Машиночитаемое описание

Таблица, на которой построена эта страница, доступна как OpenAPI по адресу https://api.tellmelo.com/v2/openapi.json.

https://api.tellmelo.com/v2/openapi.json

GIF и видео на других сайтах

То, чем участник поделился и что разрешил на других сайтах, может показать любой сайт: поиск с anywhere=true находит это, а в его embed есть адреса. Если участник отзовёт разрешение, там всё исчезнет в течение нескольких минут.

Загрузка фрагментами

Сначала начни загрузку, потом отправляй файл фрагментами. Большой файл раздели на фрагменты по piece байт, с offset на месте каждого. После последнего фрагмента придёт готовое GIF или видео.

curl -X POST -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/json" \
  -d '{"kind":"gif","size":2400000,"name":"Happy bees","shared":true,"anywhere":true}' \
  "https://api.tellmelo.com/v2/media/uploads"
→ { "upload": "e7c1a2b3-4d5e-4f60-8a9b-0c1d2e3f4a5b", "piece": 4194304 }

curl -X PUT -H "Authorization: Bearer tm_key_…" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @bees.gif \
  "https://api.tellmelo.com/v2/media/uploads/e7c1a2b3-4d5e-4f60-8a9b-0c1d2e3f4a5b?offset=0"
→ { "received": 2400000, "item": { "id": "…", "embed": { … } } }

Встраивание

Плеер показывает GIF по кругу или видео с элементами управления, под ним — название и кто поделился. Вставь код из embed.code на страницу:

<iframe src="https://tellmelo.com/media-embed/b2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918" width="480" height="300" title="Happy bees" style="border:0;max-width:100%" loading="lazy" allowfullscreen></iframe>

Форумы и программы, которые знают oEmbed, сами получают код, если дать им адрес плеера:

https://tellmelo.com/api/oembed?url=https%3A%2F%2Ftellmelo.com%2Fmedia-embed%2Fb2d7e9f1-3c4a-4e8b-a1f0-6d5c4b3a2918

Ключ должен быть на твоём сервере, никогда не в коде веб-страницы. Ищи и загружай через свой сервер; адресам в embed ключ не нужен.

Выбор GIF для твоего сайта

С ключом сайта (Раздел для разработчиков → Выбор GIF для твоего сайта) твой сайт получает готовый поиск: две строки на странице, и клик по кнопке открывает его. Ключ публичный и работает только на адресах, которые ты для него укажешь. Выбор GIF показывает только то, что участники разрешили для других сайтов.

<script src="https://tellmelo.com/picker.js" data-key="tmsk_…" defer></script>
<button type="button" data-tellmelo-picker>GIF</button>

При выборе кнопка отправляет событие tellmelo:pick с элементом: code для встраивания, file, poster, name и author. С data-target="#field" она сразу вставляет code в текстовое поле, с data-kind="video" ищет видео. Если встраиваешь файл сам, покажи имя человека, который им поделился.

document.addEventListener('tellmelo:pick', (event) => {
  const { code, file, name, author } = event.detail;
});

Вход через tellmelo

Другие сайты позволяют участникам входить через аккаунт tellmelo по OpenID Connect (код авторизации с PKCE). Сайт получает только имя пользователя, подтверждённый адрес эл. почты и собственный идентификатор для каждого участника (sub).

Заявку на приложение ты подаёшь в разделе «Раздел для разработчиков → Вход через tellmelo». Команда проверяет каждое приложение; после этого там виден ID клиента, а для приложений с сервером ты создаёшь секрет клиента, который показывается один раз.

Всё, что нужно библиотеке, есть в документе обнаружения:

https://tellmelo.com/.well-known/openid-configuration

Отправь участника на /oauth/authorize с response_type=code, client_id, redirect_uri (точно как зарегистрирован), scope=openid profile email, state, nonce и code_challenge с code_challenge_method=S256.
Обменяй код в течение минуты в /oauth/token: grant_type=authorization_code, code, redirect_uri и code_verifier; приложения с сервером дополнительно передают секрет через Basic-авторизацию или в форме.
ID-токен (RS256, ключи по адресу /oauth/jwks) содержит sub, с profile ещё preferred_username, с email ещё email и email_verified. Токен доступа действует 10 минут и читает только /oauth/userinfo.

https://tellmelo.com/oauth/authorize?response_type=code&client_id=tm_…
  &redirect_uri=https%3A%2F%2Fexample.com%2Fcallback&scope=openid%20profile%20email
  &state=…&nonce=…&code_challenge=…&code_challenge_method=S256

curl -u "tm_…:tms_…" https://tellmelo.com/oauth/token \
  -d grant_type=authorization_code -d code=… \
  -d redirect_uri=https://example.com/callback -d code_verifier=…

{
  "iss": "https://example.social",
  "sub": "Xq3vR0b8yJm1cW4tZ2kPn6sLd9fHa7gE5uTo0iBeVxY",
  "aud": "tm_5f2c9e1a7b3d4c6e8f0a1b2c",
  "iat": 1760432400,
  "exp": 1760433000,
  "nonce": "n-0S6_WzA2Mj",
  "at_hash": "HK6E_P6Dh8Y93mRNtsDB1Q",
  "preferred_username": "anna",
  "email": "anna@example.com",
  "email_verified": true
}

Токенов обновления нет: tellmelo выполняет вход и не даёт постоянного доступа. Если участник убирает сайт или команда приостанавливает приложение, /oauth/userinfo сразу отвечает 401. prompt=none проверяет без страницы, prompt=consent спрашивает заново.

Чего мы ждём

Действуют те же правила, что и везде: никакой травли, никакого спама, никакого контента, на который у тебя нет прав. За то, что публикует твой ключ, отвечаешь ты.

Показывай GIF и видео других на своём сайте, только если у них есть embed, через эти адреса и с именем того, кто ими поделился. Если что-то больше недоступно, перестань это показывать. Не копируй файлы в собственную коллекцию.

API

Я хочу …

Обзор

Быстрый старт

Попробовать

Твой ключ

Что может ключ

Чего не может ни один ключ

Боты

Запросы и ответы

Страницы

Только новое

Лимиты

Заголовки

Что ты отправляешь

Что приходит в ответ

Когда что-то не работает

Версии

Конечные точки

Вход

GET/v2

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

Ответ

Посты

GET/v2/posts

Параметры

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

Ответ

GET/v2/posts/{id}

Параметры

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

Ответ

POST/v2/posts

Параметры

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

Ответ

DELETE/v2/posts/{id}

Параметры

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

Ответ

GET/v2/me/scheduled

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

Ответ

POST/v2/posts/{id}/schedule

Параметры

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

Ответ

POST/v2/posts/{id}/edit

Параметры

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

Ответ

GET/v2/posts/{id}/reply-settings

Параметры

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

Ответ

PUT/v2/posts/{id}/reply-settings

Параметры

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

Ответ

POST/v2/posts/{id}/coauthor

Параметры

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

Ответ

DELETE/v2/posts/{id}/coauthor

Параметры

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

Ответ

POST/v2/posts/{id}/pin

Параметры

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

Ответ

Ответы

GET/v2/posts/{id}/replies

Параметры

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

Ответ

POST/v2/posts/{id}/replies

Параметры

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

Ответ

GET`/v2`

GET`/v2/posts`

GET`/v2/posts/{id}`

POST`/v2/posts`

DELETE`/v2/posts/{id}`

GET`/v2/me/scheduled`

POST`/v2/posts/{id}/schedule`

POST`/v2/posts/{id}/edit`

GET`/v2/posts/{id}/reply-settings`

PUT`/v2/posts/{id}/reply-settings`

POST`/v2/posts/{id}/coauthor`

DELETE`/v2/posts/{id}/coauthor`

POST`/v2/posts/{id}/pin`

GET`/v2/posts/{id}/replies`

POST`/v2/posts/{id}/replies`

POST`/v2/replies/{id}/edit`

DELETE`/v2/replies/{id}`

POST`/v2/replies/{id}/like`

POST`/v2/replies/{id}/vote`

POST`/v2/replies/{id}/pick`

GET`/v2/posts/{id}/replies/waiting`

POST`/v2/replies/{id}/decide`

GET`/v2/posts/{id}/replies/planned`

PUT`/v2/me/planned-replies/{id}`

POST`/v2/me/planned-replies/{id}/send`

DELETE`/v2/me/planned-replies/{id}`

POST`/v2/posts/{id}/vote`

GET`/v2/profiles/{handle}`

GET`/v2/profiles/{handle}/posts`

GET`/v2/profiles/{handle}/events`

POST`/v2/me/events`

PUT`/v2/me/events/{id}`