API reference

Base URL:

https://api.rebyte.ai/v1

Canonical machine-readable contracts:

• OpenAPI 3.1 JSON
• OpenAPI Markdown

Authentication

Authorization: Bearer rbk_your_key_here

Read operations require tasks:read; write operations require tasks:write. Creating a Response requires both. See Production integration for ownership and browser security.

Agents

Method	Endpoint	Result
POST	/agents	Create an Agent.
GET	/agents	List API-only Agents in the organization.
GET	/agents/{agent_id}	Retrieve an Agent.
PATCH	/agents/{agent_id}	Update selected Agent fields.
DELETE	/agents/{agent_id}	Delete an unreferenced Agent.

Agent IDs are UUIDs. See Agents and Tools and Skills for request fields.

Responses

Method	Endpoint	Result
POST	/responses	Run a synchronous or streaming turn.
GET	/responses/{response_id}	Retrieve durable Response state.

Response IDs use resp_<uuid>. Conversation IDs returned by Responses use conv_<uuid>. See Responses for the supported request subset and event protocol.

Response status:

queued
in_progress
completed
failed

Sessions and Messages

Method	Endpoint	Result
POST	/sessions	Create an idle Conversation snapshot.
GET	/sessions	List Conversations; filter with agentId, limit, and offset.
GET	/sessions/{session_id}	Retrieve Conversation state.
DELETE	/sessions/{session_id}	Cancel active work and delete the Conversation.
GET	/sessions/{session_id}/stream	Open standing SSE.
POST	/sessions/{session_id}/messages	Submit an asynchronous turn; returns 202.
GET	/sessions/{session_id}/messages	Read the transcript.
GET	/sessions/{session_id}/messages/{message_id}	Read one turn and pending actions.
POST	/sessions/{session_id}/messages/{message_id}/answer	Answer the current Agent question.
POST	/sessions/{session_id}/interrupt	Interrupt the active turn.

Session IDs are raw UUIDs. Session status is idle, running, or paused. Message status is queued, accepted, running, paused, completed, failed, or canceled.

See Conversations and Messages for the async workflow and standing stream contract.

Pagination

Session and Message lists accept limit and offset. The default limit is 50 and the maximum is 100. Responses include data, total, limit, and offset.

Idempotency

Agent, Response, and Session creation accept Idempotency-Key. Asynchronous Message submission requires it. See Production integration for replay rules.

Errors

{
  "error": {
    "code": "validation_error",
    "message": "Invalid request body",
    "details": []
  }
}

details is present only when the operation has structured error detail. Individual status codes and response schemas are defined in OpenAPI.