Svaya / Документация / Программный интерфейс
Помощники
Здесь собраны адреса, параметры, поля запросов и коды ответов раздела «Помощники». Каждая операция описана отдельно, с таблицами полей.
Каталог помощников
GET /api/core/v1/assistants/
Отбор: `available` — опубликованные, с которыми субъект может говорить по каналу `web`; `mine` — где субъект автор (опубликованные и нет, без архива); `review` — версии `in_review` в проектах, где субъект `project-owner`, либо все у `bm-admin`, кроме версий, автором которых он является. `q` — подстрока без учёта регистра в названии, описании и названии назначения. `cursor` — непрозрачная строка. Засев готовых помощников при первом обращении, если на старте не вышел.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
scope (в запросе) | string | нет | Значения: available, mine, review. |
q (в запросе) | string | нет | |
purpose (в запросе) | string | нет | |
projectId (в запросе) | string (uuid) | нет | |
ids (в запросе) | string | нет | до 50 идентификаторов uuid через запятую |
cursor (в запросе) | string | нет | |
limit (в запросе) | integer | нет |
Ответы
200. Страница каталога
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
items | object[] | да | |
items[].id | string (uuid) | да | |
items[].projectId | string (uuid) | да | |
items[].projectName | string | да | |
items[].kind | string | да | Значения: builtin, external. |
items[].publisher | string | да | Значения: customer, vendor. |
items[].name | string | да | |
items[].description | string | да | |
items[].purpose | object | да | |
items[].purpose.id | string | да | |
items[].purpose.name | string | да | |
items[].icon | string | да | |
items[].authorName | string | null | да | null у publisher=vendor и если имя не получено |
items[].publishedVersion | integer | null | да | |
items[].publishedAt | string (date-time) | null | да | |
items[].channels | string[] | да | |
items[].mine | boolean | да | |
items[].canEdit | boolean | да | |
items[].state | string | да | Значения: published, not-published, archived. |
items[].workingStatus | string | null | да | Значения: draft, in_review, returned. |
next | string | null | да |
400. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Создать помощника
POST /api/core/v1/assistants/
Версия 1 в статусе `draft`. Право: участник проекта (любая роль), `bm-admin`, либо «Основной проект» при отсутствии ролей (К20); иначе 403 `forbidden`. Отказ правил — 422 `config-invalid` с находками.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-CSRF (заголовок) | string | нет | Заголовок CSRF шлюза — проверяется на канале staff у изменяющих операций; канал service его не несёт. |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет |
Поля тела запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
projectId | string (uuid) | да | |
kind | string | да | Значения: builtin, external. |
config | object | да | |
config.schema | integer | да | |
config.name | string | да | |
config.description | string | нет | |
config.purpose | string | да | |
config.icon | string | да | |
config.instruction | string | да | |
config.starters | string | object[] | нет | |
config.modelProfileId | string | null | нет | |
config.kbMode | string | да | Значения: none, selected, all-available. |
config.sections | string (uuid)[] | нет | |
config.tools | object[] | нет | |
config.channels | string[] | да | |
config.audience | object[] | нет | |
config.audience[].kind | string | да | Значения: everyone, project, user, group, role, system. |
config.audience[].ref | string | нет | пусто у everyone и project |
config.context | object | да | |
config.context.maxTurns | integer | да | |
config.context.maxKb | integer | да | |
config.context.policy | string | да | Значения: truncate, summarize. |
config.external | object | null | нет | |
config.external.endpointId | string (uuid) | да | |
config.external.model | string | да | |
config.external.timeoutSec | integer | да | |
windowContext | object | нет | |
windowContext.sections | object[] | да | |
windowContext.sections[].id | string (uuid) | да | |
windowContext.sections[].projectId | string (uuid) | null | да | |
windowContext.sections[].companyWide | boolean | да | |
windowContext.endpoints | object[] | да | |
windowContext.endpoints[].id | string (uuid) | да | |
windowContext.endpoints[].enabled | boolean | да |
Ответы
201. Создан
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id | string (uuid) | да | |
version | integer | да | |
revision | integer | да | |
status | string | да |
400. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
409. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
422. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
503. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Сведения для окна и конструктора
GET /api/core/v1/assistants/meta
`projectsCount` — число проектов субъекта.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет |
Ответы
200. Сведения
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
canCreateIn | object[] | да | |
canCreateIn[].projectId | string (uuid) | да | |
canCreateIn[].name | string | да | |
canCreateIn[].isDefault | boolean | да | |
reviewerIn | string | string (uuid)[] | да | |
purposes | object[] | да | |
purposes[].id | string | да | |
purposes[].name | string | да | |
icons | string[] | да | |
contextDefault | object | да | |
contextDefault.maxTurns | integer | да | |
contextDefault.maxKb | integer | да | |
contextDefault.policy | string | да | Значения: truncate, summarize. |
maxToolIterations | integer | да | |
roles | object | да | |
roles.admin | boolean | да | |
roles.auditor | boolean | да | |
projectsCount | integer | да |
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Что можно выбрать в конструкторе проекта
GET /api/core/v1/assistants/options
Модели — разрешённые проекту (`allowedModelProfiles`); сценарии — активные пакеты проекта, каналы класса `employee`, на которые у субъекта есть `execute`, без служебных пакетов; помощники — опубликованные, с которыми субъект может говорить; инструменты MCP — доступные субъекту. `publicationReview` — действующее значение (`effectivePublicationReview`). Право: участник проекта либо `bm-admin`; иначе 403.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
projectId (в запросе) | string (uuid) | да | |
assistantId (в запросе) | string (uuid) | нет |
Ответы
200. Варианты выбора
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
models | object | да | |
models.default | object | null | да | |
models.default.id | string | да | |
models.default.title | string | да | |
models.allowed | object[] | да | |
models.allowed[].id | string | да | |
models.allowed[].title | string | да | |
scenarios | object[] | да | |
scenarios[].packageId | string | да | |
scenarios[].channelId | string | да | |
scenarios[].title | string | да | |
scenarios[].description | string | да | |
assistants | object[] | да | |
assistants[].id | string (uuid) | да | |
assistants[].name | string | да | |
assistants[].description | string | да | |
mcpTools | object[] | да | |
mcpTools[].sourceRef | string | да | |
mcpTools[].tool | string | да | |
mcpTools[].title | string | да | |
mcpTools[].description | string | да | |
mcpTools[].serverTitle | string | да | |
publicationReview | boolean | да |
400. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Карточка помощника
GET /api/core/v1/assistants/{id}
Невидимый субъекту помощник — 404, не 403.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да |
Ответы
200. Карточка
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id | string (uuid) | да | |
projectId | string (uuid) | да | |
projectName | string | да | |
kind | string | да | Значения: builtin, external. |
publisher | string | да | Значения: customer, vendor. |
name | string | да | |
description | string | да | |
purpose | object | да | |
purpose.id | string | да | |
purpose.name | string | да | |
icon | string | да | |
authorName | string | null | да | null у publisher=vendor и если имя не получено |
publishedVersion | integer | null | да | |
publishedAt | string (date-time) | null | да | |
channels | string[] | да | |
mine | boolean | да | |
canEdit | boolean | да | |
state | string | да | Значения: published, not-published, archived. |
workingStatus | string | null | да | Значения: draft, in_review, returned. |
starters | object[] | да | |
starters[].text | string | да | |
starters[].needsFile | boolean | да | |
modelTitle | string | null | да | |
toolTitles | string[] | да | |
published | object | нет | |
published.version | integer | да | |
published.status | string | да | Значения: draft, in_review, returned, published, superseded, withdrawn. |
published.revision | integer | да | |
published.config | object | да | |
published.config.schema | integer | да | |
published.config.name | string | да | |
published.config.description | string | нет | |
published.config.purpose | string | да | |
published.config.icon | string | да | |
published.config.instruction | string | да | |
published.config.starters | string | object[] | нет | |
published.config.modelProfileId | string | null | нет | |
published.config.kbMode | string | да | Значения: none, selected, all-available. |
published.config.sections | string (uuid)[] | нет | |
published.config.tools | object[] | нет | |
published.config.channels | string[] | да | |
published.config.audience | object[] | нет | |
published.config.context | object | да | |
published.config.external | object | null | нет | |
published.contentHash | string | да | |
published.createdBy | string | да | |
published.createdByName | string | null | да | |
published.createdAt | string (date-time) | да | |
published.lastSavedBy | string | да | |
published.updatedAt | string (date-time) | да | |
published.editors | string[] | да | |
published.note | string | нет | |
published.submittedBy | string | нет | |
published.submittedByName | string | null | нет | имя из порта людей; null — порта нет или имени нет, идентификатор остаётся в submittedBy |
published.submittedAt | string (date-time) | нет | |
published.submitComment | string | нет | |
published.reviewedBy | string | нет | |
published.reviewedByName | string | null | нет | |
published.reviewedAt | string (date-time) | нет | |
published.reviewComment | string | нет | |
published.publishMode | string | нет | Значения: reviewed, self-only, review-off, seed, restore. |
published.withdrawnBy | string | нет | |
published.withdrawnAt | string (date-time) | нет | |
published.withdrawReason | string | нет | |
published.restoredFrom | integer | нет | |
working | object | нет | |
working.version | integer | да | |
working.status | string | да | Значения: draft, in_review, returned, published, superseded, withdrawn. |
working.revision | integer | да | |
working.config | object | да | |
working.config.schema | integer | да | |
working.config.name | string | да | |
working.config.description | string | нет | |
working.config.purpose | string | да | |
working.config.icon | string | да | |
working.config.instruction | string | да | |
working.config.starters | string | object[] | нет | |
working.config.modelProfileId | string | null | нет | |
working.config.kbMode | string | да | Значения: none, selected, all-available. |
working.config.sections | string (uuid)[] | нет | |
working.config.tools | object[] | нет | |
working.config.channels | string[] | да | |
working.config.audience | object[] | нет | |
working.config.context | object | да | |
working.config.external | object | null | нет | |
working.contentHash | string | да | |
working.createdBy | string | да | |
working.createdByName | string | null | да | |
working.createdAt | string (date-time) | да | |
working.lastSavedBy | string | да | |
working.updatedAt | string (date-time) | да | |
working.editors | string[] | да | |
working.note | string | нет | |
working.submittedBy | string | нет | |
working.submittedByName | string | null | нет | имя из порта людей; null — порта нет или имени нет, идентификатор остаётся в submittedBy |
working.submittedAt | string (date-time) | нет | |
working.submitComment | string | нет | |
working.reviewedBy | string | нет | |
working.reviewedByName | string | null | нет | |
working.reviewedAt | string (date-time) | нет | |
working.reviewComment | string | нет | |
working.publishMode | string | нет | Значения: reviewed, self-only, review-off, seed, restore. |
working.withdrawnBy | string | нет | |
working.withdrawnAt | string (date-time) | нет | |
working.withdrawReason | string | нет | |
working.restoredFrom | integer | нет |
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Взять за основу
POST /api/core/v1/assistants/{id}:copy
Имя получает « (копия)», `audience = []`, `channels = [web]`; недоступные копирующему инструменты и разделы выбрасываются и перечисляются в `dropped`.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-CSRF (заголовок) | string | нет | Заголовок CSRF шлюза — проверяется на канале staff у изменяющих операций; канал service его не несёт. |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да |
Поля тела запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
projectId | string (uuid) | да | |
windowContext | object | нет | |
windowContext.sections | object[] | да | |
windowContext.sections[].id | string (uuid) | да | |
windowContext.sections[].projectId | string (uuid) | null | да | |
windowContext.sections[].companyWide | boolean | да | |
windowContext.endpoints | object[] | да | |
windowContext.endpoints[].id | string (uuid) | да | |
windowContext.endpoints[].enabled | boolean | да |
Ответы
201. Копия создана
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
id | string (uuid) | да | |
version | integer | да | |
revision | integer | да | |
status | string | да | |
dropped | object[] | да | |
dropped[].path | string | да | |
dropped[].reason | string | да |
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
409. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
422. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Сохранить черновик
PUT /api/core/v1/assistants/{id}/draft
`If-Match: "{revision}"` либо `"*"` (рабочей версии нет). Без заголовка — 428 `if-match-required`. Чужая ревизия — 409 `revision-conflict`; рабочая версия на проверке — 409 `state-conflict`.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-CSRF (заголовок) | string | нет | Заголовок CSRF шлюза — проверяется на канале staff у изменяющих операций; канал service его не несёт. |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да | |
If-Match (заголовок) | string | нет |
Поля тела запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
config | object | да | |
config.schema | integer | да | |
config.name | string | да | |
config.description | string | нет | |
config.purpose | string | да | |
config.icon | string | да | |
config.instruction | string | да | |
config.starters | string | object[] | нет | |
config.modelProfileId | string | null | нет | |
config.kbMode | string | да | Значения: none, selected, all-available. |
config.sections | string (uuid)[] | нет | |
config.tools | object[] | нет | |
config.channels | string[] | да | |
config.audience | object[] | нет | |
config.audience[].kind | string | да | Значения: everyone, project, user, group, role, system. |
config.audience[].ref | string | нет | пусто у everyone и project |
config.context | object | да | |
config.context.maxTurns | integer | да | |
config.context.maxKb | integer | да | |
config.context.policy | string | да | Значения: truncate, summarize. |
config.external | object | null | нет | |
config.external.endpointId | string (uuid) | да | |
config.external.model | string | да | |
config.external.timeoutSec | integer | да | |
windowContext | object | нет | |
windowContext.sections | object[] | да | |
windowContext.sections[].id | string (uuid) | да | |
windowContext.sections[].projectId | string (uuid) | null | да | |
windowContext.sections[].companyWide | boolean | да | |
windowContext.endpoints | object[] | да | |
windowContext.endpoints[].id | string (uuid) | да | |
windowContext.endpoints[].enabled | boolean | да |
Ответы
200. Сохранено
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
version | integer | да | |
revision | integer | да | |
status | string | да |
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
409. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
422. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
428. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Выбросить черновик
DELETE /api/core/v1/assistants/{id}/draft
Рабочая версия `draft` либо `returned`; на проверке — 409 `state-conflict`.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-CSRF (заголовок) | string | нет | Заголовок CSRF шлюза — проверяется на канале staff у изменяющих операций; канал service его не несёт. |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да |
Ответы
204. Удалено
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
409. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Отправить на публикацию
POST /api/core/v1/assistants/{id}:submit
Порт проектов недоступен — 503 `dependency-unavailable`, статус не меняется.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-CSRF (заголовок) | string | нет | Заголовок CSRF шлюза — проверяется на канале staff у изменяющих операций; канал service его не несёт. |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да |
Поля тела запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
comment | string | нет |
Ответы
200. Отправлено
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
version | integer | да | |
status | string | да | Значения: in_review, published. |
publishMode | string | нет | Значения: reviewed, self-only, review-off, seed, restore. |
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
409. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
422. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
503. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Отозвать с проверки
POST /api/core/v1/assistants/{id}:recall
Рабочая версия `in_review` → `draft`.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-CSRF (заголовок) | string | нет | Заголовок CSRF шлюза — проверяется на канале staff у изменяющих операций; канал service его не несёт. |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да |
Ответы
200. Отозвано
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
version | integer | да | |
status | string | да |
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
409. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Опубликовать после проверки
POST /api/core/v1/assistants/{id}:approve
Право: `project-owner` проекта либо `bm-admin`, и не автор версии (автор версии — любой из `created_by`, `submitted_by`, `editors`): 422 `second-pair-required`. Версия не совпадает с рабочей — 409 `version-changed`. Невидимый субъекту помощник — 404.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-CSRF (заголовок) | string | нет | Заголовок CSRF шлюза — проверяется на канале staff у изменяющих операций; канал service его не несёт. |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да |
Поля тела запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
version | integer | да | |
comment | string | нет |
Ответы
200. Опубликовано
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
version | integer | да | |
status | string | да |
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
409. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
422. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Вернуть автору
POST /api/core/v1/assistants/{id}:return
Комментарий обязателен (1–1000 знаков). Право и отказы — как у `approveAssistant`.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-CSRF (заголовок) | string | нет | Заголовок CSRF шлюза — проверяется на канале staff у изменяющих операций; канал service его не несёт. |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да |
Поля тела запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
version | integer | да | |
comment | string | да |
Ответы
200. Возвращено
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
version | integer | да | |
status | string | да |
400. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
409. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
422. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Снять с публикации
POST /api/core/v1/assistants/{id}:withdraw
Опубликованная версия → `withdrawn`, строки доступа удаляются. Не опубликован — 409 `state-conflict`.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-CSRF (заголовок) | string | нет | Заголовок CSRF шлюза — проверяется на канале staff у изменяющих операций; канал service его не несёт. |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да |
Поля тела запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
reason | string | да |
Ответы
200. Снято
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
version | integer | да | |
status | string | да |
400. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
409. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Убрать помощника
POST /api/core/v1/assistants/{id}:archive
Опубликованная версия снимается (причина «Помощник убран»); удаления нет, помощник уходит в архив. Повтор — 409 `already-archived`.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-CSRF (заголовок) | string | нет | Заголовок CSRF шлюза — проверяется на канале staff у изменяющих операций; канал service его не несёт. |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да |
Ответы
200. Убран
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
archivedAt | string (date-time) | да |
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
409. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
История версий
GET /api/core/v1/assistants/{id}/versions
Право: правка помощника, `project-owner`, `bm-admin`, `bm-auditor`, `project-auditor` проекта. Доступна и в архивном проекте.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да |
Ответы
200. Версии
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
items | object[] | да | |
items[].version | integer | да | |
items[].status | string | да | Значения: draft, in_review, returned, published, superseded, withdrawn. |
items[].createdBy | string | да | |
items[].createdByName | string | null | да | |
items[].createdAt | string (date-time) | да | |
items[].submittedBy | string | null | нет | |
items[].reviewedBy | string | null | нет | |
items[].reviewedByName | string | null | нет | |
items[].reviewedAt | string (date-time) | null | нет | |
items[].publishMode | string | null | нет | |
items[].restoredFrom | integer | null | нет | |
items[].note | string | null | нет | |
items[].contentHash | string | да |
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Версия целиком
GET /api/core/v1/assistants/{id}/versions/{n}
Те же права, что у истории версий.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да | |
n (в адресе) | integer | да |
Ответы
200. Версия
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
version | integer | да | |
status | string | да | Значения: draft, in_review, returned, published, superseded, withdrawn. |
revision | integer | да | |
config | object | да | |
config.schema | integer | да | |
config.name | string | да | |
config.description | string | нет | |
config.purpose | string | да | |
config.icon | string | да | |
config.instruction | string | да | |
config.starters | string | object[] | нет | |
config.modelProfileId | string | null | нет | |
config.kbMode | string | да | Значения: none, selected, all-available. |
config.sections | string (uuid)[] | нет | |
config.tools | object[] | нет | |
config.channels | string[] | да | |
config.audience | object[] | нет | |
config.audience[].kind | string | да | Значения: everyone, project, user, group, role, system. |
config.audience[].ref | string | нет | пусто у everyone и project |
config.context | object | да | |
config.context.maxTurns | integer | да | |
config.context.maxKb | integer | да | |
config.context.policy | string | да | Значения: truncate, summarize. |
config.external | object | null | нет | |
config.external.endpointId | string (uuid) | да | |
config.external.model | string | да | |
config.external.timeoutSec | integer | да | |
contentHash | string | да | |
createdBy | string | да | |
createdByName | string | null | да | |
createdAt | string (date-time) | да | |
lastSavedBy | string | да | |
updatedAt | string (date-time) | да | |
editors | string[] | да | |
note | string | нет | |
submittedBy | string | нет | |
submittedByName | string | null | нет | имя из порта людей; null — порта нет или имени нет, идентификатор остаётся в submittedBy |
submittedAt | string (date-time) | нет | |
submitComment | string | нет | |
reviewedBy | string | нет | |
reviewedByName | string | null | нет | |
reviewedAt | string (date-time) | нет | |
reviewComment | string | нет | |
publishMode | string | нет | Значения: reviewed, self-only, review-off, seed, restore. |
withdrawnBy | string | нет | |
withdrawnAt | string (date-time) | нет | |
withdrawReason | string | нет | |
restoredFrom | integer | нет |
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Вернуть версию
POST /api/core/v1/assistants/{id}/versions/{n}:restore
Рабочая версия есть — её Config заменяется (ревизия +1, `restoredFrom = n`); нет — новая версия `draft`. Рабочая на проверке — 409 `state-conflict`.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-CSRF (заголовок) | string | нет | Заголовок CSRF шлюза — проверяется на канале staff у изменяющих операций; канал service его не несёт. |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да | |
n (в адресе) | integer | да |
Ответы
200. Версия возвращена
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
version | integer | да | |
revision | integer | да | |
status | string | да | |
restoredFrom | integer | да |
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
409. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Реестр помощников и сценариев
GET /api/core/v1/assistants/registry
Право: `bm-admin`, `bm-auditor` — все проекты; `project-owner`, `project-auditor` — свои проекты. Иначе 403 «Нет доступа к реестру» (шлюз пропускает по входу, решает обработчик). Проект строки сценария — только `projectOf`.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
type (в запросе) | string | нет | Значения: all, assistant, scenario. |
projectId (в запросе) | string (uuid) | нет | |
q (в запросе) | string | нет | |
cursor (в запросе) | string | нет | |
limit (в запросе) | integer | нет |
Ответы
200. Страница реестра
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
items | object[] | да | |
items[].type | string | да | Значения: assistant, scenario. |
items[].id | string | да | |
items[].title | string | да | |
items[].projectId | string | null | да | |
items[].projectName | string | null | да | |
items[].version | string | integer | null | да | |
items[].publishedBy | string | null | да | |
items[].publishedAt | string (date-time) | null | да | |
items[].audienceSummary | string | да | |
items[].state | string | да | |
next | string | null | да |
400. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Запустить помощника по программному интерфейсу
POST /api/core/v1/assistants/{id}/runs
До него отвечает 501 `not-implemented` («операция объявлена, обработчика нет»).
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-CSRF (заголовок) | string | нет | Заголовок CSRF шлюза — проверяется на канале staff у изменяющих операций; канал service его не несёт. |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да | |
Idempotency-Key (заголовок) | string | нет |
Поля тела запроса
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
text | string | да | |
conversationId | string (uuid) | нет | только сотрудник |
Ответы
202. Запуск принят
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
runId | string (uuid) | да | |
status | string | да | |
opensAt | string (date-time) | нет |
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
409. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
422. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
501. Операция объявлена, обработчика нет (до заданий C5 и C9) — 501 `not-implemented`.
Состояние запуска
GET /api/core/v1/assistants/{id}/runs/{runId}
До него отвечает 501 `not-implemented`.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да | |
runId (в адресе) | string (uuid) | да |
Ответы
200. Запуск
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
runId | string (uuid) | да | |
assistantId | string (uuid) | да | |
version | integer | да | |
status | string | да | Значения: queued, waiting-window, running, done, error, cancelled. |
createdAt | string (date-time) | да | |
finishedAt | string (date-time) | null | да | |
opensAt | string (date-time) | нет | |
result | object | нет | |
error | object | нет | |
error.code | string | да | |
error.message | string | да |
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
501. Операция объявлена, обработчика нет (до заданий C5 и C9) — 501 `not-implemented`.
Поиск адресатов публикации
GET /api/core/v1/assistants/principals
Сотрудники и группы — порты чтения людей и групп; роли — пять ролей домашнего проекта и две роли установки; системы — включённые системы реестра внешних систем. Нет метода поиска систем — систем в выдаче нет. Право: участник проекта либо `bm-admin`.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
projectId (в запросе) | string (uuid) | да | |
q (в запросе) | string | да |
Ответы
200. Адресаты
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
items | object[] | да | |
items[].kind | string | да | Значения: user, group, role, system. |
items[].ref | string | да | |
items[].title | string | да |
400. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
Очередь и время работы помощника
GET /api/core/v1/assistants/{id}/queue
Право: правка помощника, `project-owner`, `bm-admin`, `bm-auditor`; иначе 404. Данные — порт правил очереди; порта нет — `{available: false, lines: []}`.
Параметры
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
traceparent (заголовок) | string | нет | |
X-BM-Subject (заголовок) | string | нет | От любого другого вызывающего — 403 `forbidden`. |
X-BM-Organization (заголовок) | string | нет | |
id (в адресе) | string (uuid) | да |
Ответы
200. Блок очереди
Поля ответа
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
available | boolean | да | |
lines | object[] | да | |
lines[].label | string | да | |
lines[].value | string | да |
401. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
403. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).
404. Ошибка RFC 9457 (`application/problem+json`, conventions@1), `type` = `https://errors.bm-it.ru/assistants/<код>`. Коды: `validation-failed`, `subject-required` (400), `unauthenticated` (401), `forbidden`, `mask-off-admin-only` (403), `not-found`, `assistants-disabled` (404), `project-archived`, `revision-conflict`, `state-conflict`, `version-changed`, `already-archived`, `purpose-in-use`, `model-not-allowed`, `tool-cycle`, `depth-exceeded`, `outside-processing-window` (409), `config-invalid` (422, с `findings`), `second-pair-required`, `settings-invalid`, `conversation-not-for-system` (422), `if-match-required` (428), `not-implemented` (501), `dependency-unavailable` (503; `detail`: projects, claims, orchestrator, mcp, external-systems, queue).