SvayaИИ-платформаПлатформаПримерыПродуктыВнедрение

Svaya / Документация / Программный интерфейс

Помощники

Здесь собраны адреса, параметры, поля запросов и коды ответов раздела «Помощники». Каждая операция описана отдельно, с таблицами полей.

Описание собрано из договора assistants-api, версия 1.0.0. Как получить токен и в каком формате приходят ошибки, написано на странице «Обзор и вход».

Каталог помощников

GET /api/core/v1/assistants/ операция listAssistants

Отбор: `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. Страница каталога

Поля ответа

ПолеТипОбязательноОписание
itemsobject[]да
items[].idstring (uuid)да
items[].projectIdstring (uuid)да
items[].projectNamestringда
items[].kindstringдаЗначения: builtin, external.
items[].publisherstringдаЗначения: customer, vendor.
items[].namestringда
items[].descriptionstringда
items[].purposeobjectда
items[].purpose.idstringда
items[].purpose.namestringда
items[].iconstringда
items[].authorNamestring | nullдаnull у publisher=vendor и если имя не получено
items[].publishedVersioninteger | nullда
items[].publishedAtstring (date-time) | nullда
items[].channelsstring[]да
items[].minebooleanда
items[].canEditbooleanда
items[].statestringдаЗначения: published, not-published, archived.
items[].workingStatusstring | nullдаЗначения: draft, in_review, returned.
nextstring | 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/ операция createAssistant

Версия 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нет

Поля тела запроса

ПолеТипОбязательноОписание
projectIdstring (uuid)да
kindstringдаЗначения: builtin, external.
configobjectда
config.schemaintegerда
config.namestringда
config.descriptionstringнет
config.purposestringда
config.iconstringда
config.instructionstringда
config.startersstring | object[]нет
config.modelProfileIdstring | nullнет
config.kbModestringдаЗначения: none, selected, all-available.
config.sectionsstring (uuid)[]нет
config.toolsobject[]нет
config.channelsstring[]да
config.audienceobject[]нет
config.audience[].kindstringдаЗначения: everyone, project, user, group, role, system.
config.audience[].refstringнетпусто у everyone и project
config.contextobjectда
config.context.maxTurnsintegerда
config.context.maxKbintegerда
config.context.policystringдаЗначения: truncate, summarize.
config.externalobject | nullнет
config.external.endpointIdstring (uuid)да
config.external.modelstringда
config.external.timeoutSecintegerда
windowContextobjectнет
windowContext.sectionsobject[]да
windowContext.sections[].idstring (uuid)да
windowContext.sections[].projectIdstring (uuid) | nullда
windowContext.sections[].companyWidebooleanда
windowContext.endpointsobject[]да
windowContext.endpoints[].idstring (uuid)да
windowContext.endpoints[].enabledbooleanда

Ответы

201. Создан

Поля ответа

ПолеТипОбязательноОписание
idstring (uuid)да
versionintegerда
revisionintegerда
statusstringда

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 операция getAssistantsMeta

`projectsCount` — число проектов субъекта.

Параметры

ПолеТипОбязательноОписание
traceparent (заголовок)stringнет
X-BM-Subject (заголовок)stringнетОт любого другого вызывающего — 403 `forbidden`.
X-BM-Organization (заголовок)stringнет

Ответы

200. Сведения

Поля ответа

ПолеТипОбязательноОписание
canCreateInobject[]да
canCreateIn[].projectIdstring (uuid)да
canCreateIn[].namestringда
canCreateIn[].isDefaultbooleanда
reviewerInstring | string (uuid)[]да
purposesobject[]да
purposes[].idstringда
purposes[].namestringда
iconsstring[]да
contextDefaultobjectда
contextDefault.maxTurnsintegerда
contextDefault.maxKbintegerда
contextDefault.policystringдаЗначения: truncate, summarize.
maxToolIterationsintegerда
rolesobjectда
roles.adminbooleanда
roles.auditorbooleanда
projectsCountintegerда

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 операция getAssistantOptions

Модели — разрешённые проекту (`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. Варианты выбора

Поля ответа

ПолеТипОбязательноОписание
modelsobjectда
models.defaultobject | nullда
models.default.idstringда
models.default.titlestringда
models.allowedobject[]да
models.allowed[].idstringда
models.allowed[].titlestringда
scenariosobject[]да
scenarios[].packageIdstringда
scenarios[].channelIdstringда
scenarios[].titlestringда
scenarios[].descriptionstringда
assistantsobject[]да
assistants[].idstring (uuid)да
assistants[].namestringда
assistants[].descriptionstringда
mcpToolsobject[]да
mcpTools[].sourceRefstringда
mcpTools[].toolstringда
mcpTools[].titlestringда
mcpTools[].descriptionstringда
mcpTools[].serverTitlestringда
publicationReviewbooleanда

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} операция getAssistant

Невидимый субъекту помощник — 404, не 403.

Параметры

ПолеТипОбязательноОписание
traceparent (заголовок)stringнет
X-BM-Subject (заголовок)stringнетОт любого другого вызывающего — 403 `forbidden`.
X-BM-Organization (заголовок)stringнет
id (в адресе)string (uuid)да

Ответы

200. Карточка

Поля ответа

ПолеТипОбязательноОписание
idstring (uuid)да
projectIdstring (uuid)да
projectNamestringда
kindstringдаЗначения: builtin, external.
publisherstringдаЗначения: customer, vendor.
namestringда
descriptionstringда
purposeobjectда
purpose.idstringда
purpose.namestringда
iconstringда
authorNamestring | nullдаnull у publisher=vendor и если имя не получено
publishedVersioninteger | nullда
publishedAtstring (date-time) | nullда
channelsstring[]да
minebooleanда
canEditbooleanда
statestringдаЗначения: published, not-published, archived.
workingStatusstring | nullдаЗначения: draft, in_review, returned.
startersobject[]да
starters[].textstringда
starters[].needsFilebooleanда
modelTitlestring | nullда
toolTitlesstring[]да
publishedobjectнет
published.versionintegerда
published.statusstringдаЗначения: draft, in_review, returned, published, superseded, withdrawn.
published.revisionintegerда
published.configobjectда
published.config.schemaintegerда
published.config.namestringда
published.config.descriptionstringнет
published.config.purposestringда
published.config.iconstringда
published.config.instructionstringда
published.config.startersstring | object[]нет
published.config.modelProfileIdstring | nullнет
published.config.kbModestringдаЗначения: none, selected, all-available.
published.config.sectionsstring (uuid)[]нет
published.config.toolsobject[]нет
published.config.channelsstring[]да
published.config.audienceobject[]нет
published.config.contextobjectда
published.config.externalobject | nullнет
published.contentHashstringда
published.createdBystringда
published.createdByNamestring | nullда
published.createdAtstring (date-time)да
published.lastSavedBystringда
published.updatedAtstring (date-time)да
published.editorsstring[]да
published.notestringнет
published.submittedBystringнет
published.submittedByNamestring | nullнетимя из порта людей; null — порта нет или имени нет, идентификатор остаётся в submittedBy
published.submittedAtstring (date-time)нет
published.submitCommentstringнет
published.reviewedBystringнет
published.reviewedByNamestring | nullнет
published.reviewedAtstring (date-time)нет
published.reviewCommentstringнет
published.publishModestringнетЗначения: reviewed, self-only, review-off, seed, restore.
published.withdrawnBystringнет
published.withdrawnAtstring (date-time)нет
published.withdrawReasonstringнет
published.restoredFromintegerнет
workingobjectнет
working.versionintegerда
working.statusstringдаЗначения: draft, in_review, returned, published, superseded, withdrawn.
working.revisionintegerда
working.configobjectда
working.config.schemaintegerда
working.config.namestringда
working.config.descriptionstringнет
working.config.purposestringда
working.config.iconstringда
working.config.instructionstringда
working.config.startersstring | object[]нет
working.config.modelProfileIdstring | nullнет
working.config.kbModestringдаЗначения: none, selected, all-available.
working.config.sectionsstring (uuid)[]нет
working.config.toolsobject[]нет
working.config.channelsstring[]да
working.config.audienceobject[]нет
working.config.contextobjectда
working.config.externalobject | nullнет
working.contentHashstringда
working.createdBystringда
working.createdByNamestring | nullда
working.createdAtstring (date-time)да
working.lastSavedBystringда
working.updatedAtstring (date-time)да
working.editorsstring[]да
working.notestringнет
working.submittedBystringнет
working.submittedByNamestring | nullнетимя из порта людей; null — порта нет или имени нет, идентификатор остаётся в submittedBy
working.submittedAtstring (date-time)нет
working.submitCommentstringнет
working.reviewedBystringнет
working.reviewedByNamestring | nullнет
working.reviewedAtstring (date-time)нет
working.reviewCommentstringнет
working.publishModestringнетЗначения: reviewed, self-only, review-off, seed, restore.
working.withdrawnBystringнет
working.withdrawnAtstring (date-time)нет
working.withdrawReasonstringнет
working.restoredFromintegerнет

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 операция copyAssistant

Имя получает « (копия)», `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)да

Поля тела запроса

ПолеТипОбязательноОписание
projectIdstring (uuid)да
windowContextobjectнет
windowContext.sectionsobject[]да
windowContext.sections[].idstring (uuid)да
windowContext.sections[].projectIdstring (uuid) | nullда
windowContext.sections[].companyWidebooleanда
windowContext.endpointsobject[]да
windowContext.endpoints[].idstring (uuid)да
windowContext.endpoints[].enabledbooleanда

Ответы

201. Копия создана

Поля ответа

ПолеТипОбязательноОписание
idstring (uuid)да
versionintegerда
revisionintegerда
statusstringда
droppedobject[]да
dropped[].pathstringда
dropped[].reasonstringда

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 операция saveDraft

`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нет

Поля тела запроса

ПолеТипОбязательноОписание
configobjectда
config.schemaintegerда
config.namestringда
config.descriptionstringнет
config.purposestringда
config.iconstringда
config.instructionstringда
config.startersstring | object[]нет
config.modelProfileIdstring | nullнет
config.kbModestringдаЗначения: none, selected, all-available.
config.sectionsstring (uuid)[]нет
config.toolsobject[]нет
config.channelsstring[]да
config.audienceobject[]нет
config.audience[].kindstringдаЗначения: everyone, project, user, group, role, system.
config.audience[].refstringнетпусто у everyone и project
config.contextobjectда
config.context.maxTurnsintegerда
config.context.maxKbintegerда
config.context.policystringдаЗначения: truncate, summarize.
config.externalobject | nullнет
config.external.endpointIdstring (uuid)да
config.external.modelstringда
config.external.timeoutSecintegerда
windowContextobjectнет
windowContext.sectionsobject[]да
windowContext.sections[].idstring (uuid)да
windowContext.sections[].projectIdstring (uuid) | nullда
windowContext.sections[].companyWidebooleanда
windowContext.endpointsobject[]да
windowContext.endpoints[].idstring (uuid)да
windowContext.endpoints[].enabledbooleanда

Ответы

200. Сохранено

Поля ответа

ПолеТипОбязательноОписание
versionintegerда
revisionintegerда
statusstringда

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 операция discardDraft

Рабочая версия `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 операция submitAssistant

Порт проектов недоступен — 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)да

Поля тела запроса

ПолеТипОбязательноОписание
commentstringнет

Ответы

200. Отправлено

Поля ответа

ПолеТипОбязательноОписание
versionintegerда
statusstringдаЗначения: in_review, published.
publishModestringнетЗначения: 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 операция recallAssistant

Рабочая версия `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. Отозвано

Поля ответа

ПолеТипОбязательноОписание
versionintegerда
statusstringда

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 операция approveAssistant

Право: `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)да

Поля тела запроса

ПолеТипОбязательноОписание
versionintegerда
commentstringнет

Ответы

200. Опубликовано

Поля ответа

ПолеТипОбязательноОписание
versionintegerда
statusstringда

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 операция returnAssistant

Комментарий обязателен (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)да

Поля тела запроса

ПолеТипОбязательноОписание
versionintegerда
commentstringда

Ответы

200. Возвращено

Поля ответа

ПолеТипОбязательноОписание
versionintegerда
statusstringда

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 операция withdrawAssistant

Опубликованная версия → `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)да

Поля тела запроса

ПолеТипОбязательноОписание
reasonstringда

Ответы

200. Снято

Поля ответа

ПолеТипОбязательноОписание
versionintegerда
statusstringда

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 операция archiveAssistant

Опубликованная версия снимается (причина «Помощник убран»); удаления нет, помощник уходит в архив. Повтор — 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. Убран

Поля ответа

ПолеТипОбязательноОписание
archivedAtstring (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 операция listVersions

Право: правка помощника, `project-owner`, `bm-admin`, `bm-auditor`, `project-auditor` проекта. Доступна и в архивном проекте.

Параметры

ПолеТипОбязательноОписание
traceparent (заголовок)stringнет
X-BM-Subject (заголовок)stringнетОт любого другого вызывающего — 403 `forbidden`.
X-BM-Organization (заголовок)stringнет
id (в адресе)string (uuid)да

Ответы

200. Версии

Поля ответа

ПолеТипОбязательноОписание
itemsobject[]да
items[].versionintegerда
items[].statusstringдаЗначения: draft, in_review, returned, published, superseded, withdrawn.
items[].createdBystringда
items[].createdByNamestring | nullда
items[].createdAtstring (date-time)да
items[].submittedBystring | nullнет
items[].reviewedBystring | nullнет
items[].reviewedByNamestring | nullнет
items[].reviewedAtstring (date-time) | nullнет
items[].publishModestring | nullнет
items[].restoredFrominteger | nullнет
items[].notestring | nullнет
items[].contentHashstringда

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} операция getVersion

Те же права, что у истории версий.

Параметры

ПолеТипОбязательноОписание
traceparent (заголовок)stringнет
X-BM-Subject (заголовок)stringнетОт любого другого вызывающего — 403 `forbidden`.
X-BM-Organization (заголовок)stringнет
id (в адресе)string (uuid)да
n (в адресе)integerда

Ответы

200. Версия

Поля ответа

ПолеТипОбязательноОписание
versionintegerда
statusstringдаЗначения: draft, in_review, returned, published, superseded, withdrawn.
revisionintegerда
configobjectда
config.schemaintegerда
config.namestringда
config.descriptionstringнет
config.purposestringда
config.iconstringда
config.instructionstringда
config.startersstring | object[]нет
config.modelProfileIdstring | nullнет
config.kbModestringдаЗначения: none, selected, all-available.
config.sectionsstring (uuid)[]нет
config.toolsobject[]нет
config.channelsstring[]да
config.audienceobject[]нет
config.audience[].kindstringдаЗначения: everyone, project, user, group, role, system.
config.audience[].refstringнетпусто у everyone и project
config.contextobjectда
config.context.maxTurnsintegerда
config.context.maxKbintegerда
config.context.policystringдаЗначения: truncate, summarize.
config.externalobject | nullнет
config.external.endpointIdstring (uuid)да
config.external.modelstringда
config.external.timeoutSecintegerда
contentHashstringда
createdBystringда
createdByNamestring | nullда
createdAtstring (date-time)да
lastSavedBystringда
updatedAtstring (date-time)да
editorsstring[]да
notestringнет
submittedBystringнет
submittedByNamestring | nullнетимя из порта людей; null — порта нет или имени нет, идентификатор остаётся в submittedBy
submittedAtstring (date-time)нет
submitCommentstringнет
reviewedBystringнет
reviewedByNamestring | nullнет
reviewedAtstring (date-time)нет
reviewCommentstringнет
publishModestringнетЗначения: reviewed, self-only, review-off, seed, restore.
withdrawnBystringнет
withdrawnAtstring (date-time)нет
withdrawReasonstringнет
restoredFromintegerнет

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 операция restoreVersion

Рабочая версия есть — её 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. Версия возвращена

Поля ответа

ПолеТипОбязательноОписание
versionintegerда
revisionintegerда
statusstringда
restoredFromintegerда

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 операция getRegistry

Право: `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. Страница реестра

Поля ответа

ПолеТипОбязательноОписание
itemsobject[]да
items[].typestringдаЗначения: assistant, scenario.
items[].idstringда
items[].titlestringда
items[].projectIdstring | nullда
items[].projectNamestring | nullда
items[].versionstring | integer | nullда
items[].publishedBystring | nullда
items[].publishedAtstring (date-time) | nullда
items[].audienceSummarystringда
items[].statestringда
nextstring | 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 операция createRun

До него отвечает 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нет

Поля тела запроса

ПолеТипОбязательноОписание
textstringда
conversationIdstring (uuid)неттолько сотрудник

Ответы

202. Запуск принят

Поля ответа

ПолеТипОбязательноОписание
runIdstring (uuid)да
statusstringда
opensAtstring (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} операция getRun

До него отвечает 501 `not-implemented`.

Параметры

ПолеТипОбязательноОписание
traceparent (заголовок)stringнет
X-BM-Subject (заголовок)stringнетОт любого другого вызывающего — 403 `forbidden`.
X-BM-Organization (заголовок)stringнет
id (в адресе)string (uuid)да
runId (в адресе)string (uuid)да

Ответы

200. Запуск

Поля ответа

ПолеТипОбязательноОписание
runIdstring (uuid)да
assistantIdstring (uuid)да
versionintegerда
statusstringдаЗначения: queued, waiting-window, running, done, error, cancelled.
createdAtstring (date-time)да
finishedAtstring (date-time) | nullда
opensAtstring (date-time)нет
resultobjectнет
errorobjectнет
error.codestringда
error.messagestringда

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 операция searchPrincipals

Сотрудники и группы — порты чтения людей и групп; роли — пять ролей домашнего проекта и две роли установки; системы — включённые системы реестра внешних систем. Нет метода поиска систем — систем в выдаче нет. Право: участник проекта либо `bm-admin`.

Параметры

ПолеТипОбязательноОписание
traceparent (заголовок)stringнет
X-BM-Subject (заголовок)stringнетОт любого другого вызывающего — 403 `forbidden`.
X-BM-Organization (заголовок)stringнет
projectId (в запросе)string (uuid)да
q (в запросе)stringда

Ответы

200. Адресаты

Поля ответа

ПолеТипОбязательноОписание
itemsobject[]да
items[].kindstringдаЗначения: user, group, role, system.
items[].refstringда
items[].titlestringда

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 операция getAssistantQueue

Право: правка помощника, `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. Блок очереди

Поля ответа

ПолеТипОбязательноОписание
availablebooleanда
linesobject[]да
lines[].labelstringда
lines[].valuestringда

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).