Publish a new brain version

POST 
/v1/brains/:brain_id/publish

Creates a new brain version, waits for training, and updates rules to use it. Permissions - brains.write. API keys - manage.

Request

Responses

200

Brain version published successfully and rules updated

400

Cannot publish - validation failed (e.g., not a draft brain, version limit reached, or old version has active sessions). Code brain_not_servable: the trained version cannot answer messages because it has no intent with example phrases, or no dialog, webhook or MCP server. The version is removed and rules are not changed. Add the missing content to the draft, then publish again. Training again without changes does not help.

401

Unauthorized

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789

404

The specified resource was not found

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789

500

Internal Server Error

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789