> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arzguard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ответить в теме

> Создаёт сообщение в существующей теме.

Создаёт сообщение в существующей теме.

## Доступ

В каждом запросе обязателен заголовок `XF-Api-Key`. Примеры используют серверную переменную `$FORUM_API_KEY`; [тип ключа и контекст пользователя](/guard-forum/authentication) определяют доступ к данным.

<ParamField header="XF-Api-Key" type="string" required>
  Ключ API. Храните его на сервере интеграции; в примере используется переменная окружения.
</ParamField>

Обязательные scopes: `thread:write`.

## Параметры

<ParamField body="thread_id" type="integer" required>
  ID темы, в которую добавляется ответ.
</ParamField>

<ParamField body="message" type="string" required>
  Текст сообщения. Проверяется правилами и ограничениями выбранного типа содержимого.
</ParamField>

<ParamField body="attachment_key" type="string">
  Ключ подготовленных вложений с типом `post` и контекстом `context[thread_id]`, равным ID темы.
</ParamField>

Тело запроса: `application/x-www-form-urlencoded`. Данные передаются в UTF-8.

## Успешный ответ

HTTP `200`. Пример ниже сокращён и содержит только условные данные. Полные объекты и условия видимости полей описаны в [схемах данных](/guard-forum/models).

| Поле | Тип | Описание |
| - | - | - |
| `success` | `true` | `true`, если действие выполнено успешно. |
| `post` | `Post` | Созданное, изменённое или запрошенное сообщение `Post`. |

## Ошибки

Стандартный ответ содержит массив `errors` с `code`, `message` и `params`. Проверяйте HTTP-статус и машинный код; [формат и обработка ошибок](/guard-forum/requests-and-errors) общие для API.

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --header "XF-Api-Key: $FORUM_API_KEY" \
    --header 'Accept: application/json' \
    --data-urlencode 'thread_id=123' \
    --data-urlencode 'message=Пример сообщения' \
    'https://forum.arzguard.com/api/posts/'
  ```
</RequestExample>

<ResponseExample>
  ```json Сокращённый условный ответ theme={null}
  {
    "success": true,
    "post": {
      "post_id": 123
    }
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.