Get startedAgent APIQuickstart
Core conceptsExecution model
Agent APIAgentsTools and SkillsResponsesConversations and Messages
SDKs and toolsTypeScript SDKCLI and agent.toml
ProductionProduction integration
ReferenceAPI reference

Agent API

The Agent API lets an application define a Rebyte Agent and run it without operating the execution loop or tool infrastructure.

The object model

Agent
  └── Conversation
        ├── Response 1
        ├── Response 2
        └── Response 3
ResourcePurpose
AgentReusable instructions, model, tools, and Skills.
ConversationDurable state and transcript for one interaction.
ResponseOne input and the Agent execution it produces.

The Agent is configuration. A Conversation takes a snapshot of that configuration when it is created. Each Response is one turn in that Conversation.

The interfaces

agent.toml ── Rebyte CLI ──┐
                           │
OpenAI SDK ────────────────┼── Agent API ── Agent ── Conversation ── Response
Rebyte Core SDK ───────────┤
Your server ───────────────┘
    ▲
    └── React SDK ── optional Rebyte UI ── browser
InterfaceWhat it is
OpenAI SDKCalls Rebyte's Responses-compatible endpoint. Use the Agent ID as model.
Rebyte Core SDKTypeScript client with Response streams and Conversation helpers.
React SDK and UIBrowser chat state and optional components. They call your server, not Rebyte with an exposed key.
Rebyte CLIValidates and applies local agent.toml files.
REST APIDirect Agent, Response, Conversation, and Message endpoints.

agent.toml is a local representation of an Agent. The API stores the resolved Agent fields, not the TOML file, comments, or prompt_file path.

Start here

  1. Create an API key and run an Agent.
  2. Define its tools and Skills.
  3. Choose the OpenAI SDK or Rebyte TypeScript SDK.

Base URL:

https://api.rebyte.ai/v1

Create organization API keys in Settings → API Keys. Keep the key on your server.

Agent API and Runtime API

The Agent API controls Agents and their execution. It does not expose an “Agent Computer” resource.

Direct sandbox, browser, filesystem, process, and compute control belongs to a separate Runtime API. An Agent may use those facilities through configured tools without the application managing their lifecycle.

OpenAPI 3.1 JSON · OpenAPI Markdown · SDK source and releases

Next →Quickstart