Agent-readable docs index: /docs/llms.txt. Full docs in one file: /docs/llms-full.txt. Download /docs/docs.zip to grep all markdown files locally.

Publish draft

/segments/{public_id}/publishPOST
Publishes the reviewed version after purpose confirmation. Required scope: segments:write.
Authorization
BearerAuth *Bearer <token>
API key generated under Account Settings → API Keys (rk_live_...). Send as header Authorization: Bearer <key>.
Request Bodyapplication/jsonrequired
version_id *integer
purpose_confirmed *boolean
Response
200 · Successful response. See the integration guide for status and lifecycle semantics.
Type: object
401 · Invalid, expired, revoked or missing key.
Invalid, expired, revoked or missing key.
403 · Required scope not granted.
Required scope not granted.
422 · Validation or eligibility failure.
Validation or eligibility failure.
Request example
curl -X POST "https://convert.ruut.chat/api/v1/segments/<public_id>/publish" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "version_id": 0,
  "purpose_confirmed": true
}'