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.

List segments

/segmentsGET
Lists workspace segment summaries with paginated filtering. Required scope: segments:read.
Authorization
BearerAuth *Bearer <token>
API key generated under Account Settings → API Keys (rk_live_...). Send as header Authorization: Bearer <key>.
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 GET "https://convert.ruut.chat/api/v1/segments" \
  -H "Authorization: Bearer <token>"