Skip to main content
A routine run is a single execution attempt for a routine. It records the source, terminal status, timing, error, and linked agent chat transcript when a chat starts.

​
Attributes

​
id
string
Unique identifier for the run, e.g. rrun_Y7mP2kQ9xL4s.
​
object
string
The object type. Always routine.run.
​
routine
string
ID of the routine for this run.
​
status
string
Run status. One of running, succeeded, or failed.
​
source
string
Source that created the run. One of api, hook, manual, or schedule. For the authenticated API create-run endpoint, this is api; runs triggered by an admin from the Plane app are manual.
​
text
string | null
Freeform text passed to this run — the create-run request’s text, or the inbound hook body for hook-fired runs, carried as a literal string.
​
chat
string | null
ID of the linked agent chat transcript, when a chat started.
​
error
string | null
Failure message when the run reaches failed.
​
created
string
Timestamp when the run was created.
​
completed
string | null
Timestamp when the run reached a terminal status.