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

# API

> Подключите внешние системы к агенту через API.

ASCN Agent предоставляет API для интеграции с внешними системами: запускайте беседы, отправляйте сообщения и получайте ответы программно.

<img src="https://mintcdn.com/ascn-b377dab5/dZwp8NTeHyd0j5bJ/images/14-api.png?fit=max&auto=format&n=dZwp8NTeHyd0j5bJ&q=85&s=d905b120b08a3e8a39d88b571f97b9d4" alt="Раздел Настройки → API — Base URL, ключ авторизации и пример запроса" width="2569" height="1623" data-path="images/14-api.png" />

## Как получить доступ к API

1. Откройте **Настройки → API**
2. Скопируйте **Base URL** — он уникален для каждого воркспейса
3. Скопируйте **Ключ авторизации**
4. Используйте ключ в заголовке `Authorization: Bearer ...` с каждым запросом

## Базовый пример

```bash theme={null}
curl -X POST "https://api.clawman.ascn.ai/api/v1/workspaces/{workspace_id}/session/{session_id}/messages" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {API_KEY}" \
  -d '{"content": "Проверь почту и пришли сводку"}'
```

## Методы API

| Метод  | Эндпоинт                         | Описание                                       |
| ------ | -------------------------------- | ---------------------------------------------- |
| `POST` | `/session/{session_id}/messages` | Отправить сообщение и получить стриминг ответа |

**Что такое session\_id:** каждый разговор с агентом — это сессия. `session_id` — уникальный идентификатор конкретного диалога. Вы можете создать новую сессию (новый диалог) или продолжить существующую, передав её ID. Если хотите каждый раз начинать новый разговор — генерируйте новый UUID для `session_id`.

## Сценарии использования

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

**Связь нескольких агентов.** Прямой связи между агентами нет, но вы можете использовать API как мост — один агент отправляет данные другому через API-запрос.

**Вебхуки и автоматизации.** Подключите ASCN Agent к Zapier, Make или собственным скриптам через API.

<Info>
  Base URL и ключ авторизации привязаны к конкретному воркспейсу. Для каждого агента они свои.
</Info>