---
title: "Найти или создать каноническое обсуждение доступного объекта"
method: POST
path: "/api/v1/chat/entities/{module}/{entity}/{entityId}/conversation"
tags: ["Chat"]
---

# Найти или создать каноническое обсуждение доступного объекта

`POST /api/v1/chat/entities/{module}/{entity}/{entityId}/conversation`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/chat/entities/{module}/{entity}/{entityId}/conversation`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Принимает пустой JSON-объект. Сейчас поддерживается tasks.task; дополнительно нужны chat:read, tasks:read и видимость задачи. Адрес объекта — естественный ключ идемпотентности: повторный и конкурентный запросы сходятся к одному обсуждению. Idempotency-Key не читается.

## Request body

- object

## Response `200`

Существующее или созданное обсуждение

- ChatEntityConversation
  - `conversation_id` string, uuid, required
  - `title` string, required
  - `deep_link` string, required

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/a99574d597cc?raw)