Skip to main content
A session is one durable conversation or task run for a Dari agent. It is pinned to the agent version that was active when the session was created, so publishing a new version does not change behavior for sessions that are already running. A message is one user turn inside a session. Messages can include text and file references. Dari records the assistant output, tool calls, tool results, status changes, and errors so you can poll, stream, or replay the session later.

​
Create A Session

dari session create --agent agt_123
Or create a session and send the first message in one command: 
dari session send --agent agt_123 "Review this repository and suggest improvements."

​
Continue A Session

dari session send sess_123 "Apply the safest two changes."
The same flow is available over HTTP with Create Session, Send Agent Message, and Send Session Events.

​
Observe A Session

Use the CLI while developing: 
dari session get sess_123
dari session events sess_123 --limit 50
Use the API when building an application:

​
Per-Session Overrides

At session creation time, you can attach metadata, pass allowed session secrets, provide a one-off LLM provider key, or override sandbox internet access. Secret values are accepted only when the session is created and are never returned by the API.