Clatter LabsHelp Center

What event types does the run event stream send?

ReferenceUpdated
EventDataWhen
status{ "status": "running" }The run's status changed
stepA step objectCosmos wrote a message or used a tool
doneThe final runThe run finished (completed, failed or cancelled)
timeout{ "message", "after" }The connection reached 10 minutes; the run continues
error{ "code", "message" }The stream had to stop, for example the key was revoked

How to react#

  • step: show progress; remember index + 1 as your after value.
  • done: you have the final run; stop reading.
  • timeout: reconnect with ?after= set to the after value.
  • error: check the code; reconnect with ?after=N if it makes sense (not if the key was revoked).

Learn more#

Related articles

Still need help?

Tried the steps above and still stuck? Email us. We usually reply within the first hour, and always within 24 hours. A full support team is with you.

Infrastructure questions, or permanent deletion of your data
infrastructure@clatterlabs.xyz
For deleting your whole account or the data of one service.