> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Routine run

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

<ResponseField name="id" type="string">
  Unique identifier for the run, e.g. `rrun_Y7mP2kQ9xL4s`.
</ResponseField>

<ResponseField name="object" type="string">
  The object type. Always `routine.run`.
</ResponseField>

<ResponseField name="routine" type="string">
  ID of the routine for this run.
</ResponseField>

<ResponseField name="status" type="string">
  Run status. One of `running`, `succeeded`, or `failed`.
</ResponseField>

<ResponseField name="source" type="string">
  Source that created the run. One of `api`, `hook`, or `schedule`. For the
  authenticated API create-run endpoint, this is `api`.
</ResponseField>

<ResponseField name="chat" type="string | null">
  ID of the linked agent chat transcript, when a chat started.
</ResponseField>

<ResponseField name="error" type="string | null">
  Failure message when the run reaches `failed`.
</ResponseField>

<ResponseField name="created" type="string">
  Timestamp when the run was created.
</ResponseField>

<ResponseField name="completed" type="string | null">
  Timestamp when the run reached a terminal status.
</ResponseField>