API
Sessions, messages, events and integration endpoints.
List sessions
Create a session
Create a conversation using an admitted agent loop. In this example, replace the component id with the id returned by uploading your loop to POST /v1/agentloops, and replace the model API key. Loop configuration depends on the chosen package; the empty object suits the reference loop.
Delete a session
Read a session
Interrupt session work
End a session
Send a message
Read the conversation transcript
Read or stream session events
List models
Prepare reusable code on the built-in Environment workers
Waits until the declared artifacts are loaded on eligible workers. Preparation is retained for this server process, restored after worker replacement, and independent of session lifetime. Repeating the request checks current resources again. It grants no session authority.
Manage session environments
Run an environment-control operation. Every request, including list and get, requires an Idempotency-Key. Reuse the key only when retrying the same request.
Call an environment method
Upload an agent loop
Read agent loop admission
Store UTF-8 program source for a compatible runtime
Read program admission
Upload a tool
Read Tool admission
Register an application host
Call a service from a host invocation
Receive host commands
Report a host event
Call a model from a host invocation
Complete a host command
Suspend the current host connection if its sessions have drained
Report an environment observation
Call a granted execution service
Invoke a service granted to this execution using the invocation bearer token supplied by Brain. The method must be within the grant and the execution must still be open.