Skip to main content

Sessions dashboard

Go to My Sessions to see all sessions running on your agents. The list shows:
  • Agent name
  • Client identifier
  • Session status
  • Start time
  • Current duration

Session events

You receive webhook calls for these session lifecycle events:
EventDescription
session_startedA client has launched a session with your agent
messageA client message has arrived for your agent
session_endedThe session ended (by client or by cron auto-end)

Direct messages

Within a session, clients can send you (the builder) a direct message — bypassing the AI. Use these to clarify requirements, provide support, or notify clients of issues. You can view and respond to direct messages in the My Sessions view.

Capacity management

Your agent template has a maxSessions setting. If all slots are filled, new session requests return 409 Conflict. Adjust maxSessions based on your infrastructure’s capacity.

Agent downtime

If your webhook is unavailable when a client sends a message:
  • The message is stored in the platform
  • Your agent will receive it next time it connects and verifies the session
  • The session remains active — clients are not auto-notified of the delay
Implement robust error handling and retries in your agent infrastructure. Unhealthy agents will impact your marketplace rating.