Для AI-агентов: markdown этой страницы — /docs-content/entities/calendar-events/meeting-status.md индекс документации — /llms.txt

Статус участия во встрече

GET /v1/calendar-events/:id/meeting-status · PUT /v1/calendar-events/:id/meeting-status

Bitrix24 API: calendar.meeting.status.get / calendar.meeting.status.set · Scope: calendar

Читает или меняет статус ТЕКУЩЕГО пользователя, чьи учётные данные использует ключ. Для записи используйте PUT на тот же путь с телом {"status":"declined"}. Событие сначала проверяется; отсутствие участия возвращает отказ Б24 до записи.

Параметры

Параметр	Тип	Обязателен	Описание
id	integer	Да	ID из списка событий.
status	string	Только PUT	accepted, declined или invited. Только для текущего пользователя ключа.

Примеры

Terminal

curl -X GET "https://vibecode.bitrix24.tech/v1/calendar-events/12/meeting-status" -H "X-Api-Key: $VIBE_API_KEY"

Terminal

curl -X GET "https://vibecode.bitrix24.tech/v1/calendar-events/12/meeting-status" -H "X-Api-Key: $VIBE_API_KEY" -H "Authorization: Bearer $VIBE_USER_TOKEN"

javascript

const response = await fetch('https://vibecode.bitrix24.tech/v1/calendar-events/12/meeting-status', {
  method: 'GET',
  headers: { 'X-Api-Key': apiKey }
});
console.log(await response.json());

javascript

const response = await fetch('https://vibecode.bitrix24.tech/v1/calendar-events/12/meeting-status', {
  method: 'GET',
  headers: { 'X-Api-Key': apiKey , 'Authorization': `Bearer ${userToken}` }
});
console.log(await response.json());

Ответ

JSON

{
  "success": true,
  "data": {
    "status": "invited"
  }
}

Поля ответа

Поле	Тип	Описание
success	boolean	Признак успешного запроса.
data.status	string	accepted, declined, invited или host (организатор). PUT возвращает перечитанный статус; host доступен только для чтения.

Ошибки

HTTP	Code	Причина
400	INVALID_PARAMS	Неверные ID, даты или статус.
400	MISSING_REQUIRED_FIELDS	Не переданы обязательные значения.
401	TOKEN_MISSING	У ключа нет доступных учётных данных Б24.
403	SCOPE_DENIED	У ключа нет скоупа calendar.
403	WRITE_BLOCKED_READONLY_KEY	Ключ запрещает запись.
403	BITRIX_ACCESS_DENIED	Б24 запретил доступ.
404	ENTITY_NOT_FOUND	Ресурс или событие не найдено.
422	BITRIX_ERROR	Б24 отклонил операцию или не сохранил изменение.
429	RATE_LIMITED	Превышен лимит запросов.
502	BITRIX_UNAVAILABLE	Ответ Б24 недоступен или имеет неверную форму.
503	BITRIX_TIMEOUT	Б24 не ответил вовремя.

Неверный запрос возвращает ошибку, а не пустой результат:

JSON

{"success":false,"error":{"code":"INVALID_PARAMS","message":"Invalid calendar parameters"}}

Все ошибки

Смотрите также

Изменить статус

Terminal

curl -X PUT "https://vibecode.bitrix24.tech/v1/calendar-events/12/meeting-status" -H "X-Api-Key: $VIBE_API_KEY" -H "Content-Type: application/json" -d '{"status":"declined"}'