RoutineRun interface
A single routine run returned from the run history API.
Properties
| action_correlation_id | The downstream action correlation identifier, when available. |
| action_type | The action type dispatched for the routine attempt. |
| agent_endpoint_id | The legacy endpoint-scoped agent identifier recorded for the routine attempt. |
| agent_id | The project-scoped agent identifier recorded for the routine attempt. |
| attempt_source | The source path that created the routine attempt. |
| conversation_id | The conversation identifier used by a responses API dispatch. |
| dispatch_id | The dispatch identifier associated with the routine attempt. |
| ended_at | The time when the underlying run reached a terminal state. |
| error_message | The truncated failure message captured for a failed attempt, when available. |
| error_status_code | The downstream error status code captured for a failed attempt, when available. |
| error_type | The fully qualified error type captured for a failed attempt, when available. |
| id | The unique run identifier for the routine attempt. |
| phase | The AgentExtensions lifecycle phase for the routine attempt. |
| response_id | The downstream response or invocation identifier, when available. |
| scheduled_fire_at | The scheduled fire time recorded for timer and schedule deliveries. |
| session_id | The hosted-agent session identifier used by an invocations API dispatch. |
| started_at | The time when the underlying run started. |
| status | The run status. |
| task_id | The workspace task identifier linked to the routine attempt, when available. |
| triggered_at | The logical trigger time recorded for the routine attempt. |
| trigger_name | The configured trigger name that produced the routine attempt. |
| trigger_type | The trigger type that produced the routine attempt. |
Property Details
action_correlation_id
The downstream action correlation identifier, when available.
action_correlation_id?: string
Property Value
string
action_type
The action type dispatched for the routine attempt.
action_type?: RoutineActionType
Property Value
agent_endpoint_id
The legacy endpoint-scoped agent identifier recorded for the routine attempt.
agent_endpoint_id?: string
Property Value
string
agent_id
The project-scoped agent identifier recorded for the routine attempt.
agent_id?: string
Property Value
string
attempt_source
The source path that created the routine attempt.
attempt_source?: RoutineAttemptSource
Property Value
conversation_id
The conversation identifier used by a responses API dispatch.
conversation_id?: string
Property Value
string
dispatch_id
The dispatch identifier associated with the routine attempt.
dispatch_id?: string
Property Value
string
ended_at
The time when the underlying run reached a terminal state.
ended_at?: Date
Property Value
Date
error_message
The truncated failure message captured for a failed attempt, when available.
error_message?: string
Property Value
string
error_status_code
The downstream error status code captured for a failed attempt, when available.
error_status_code?: number
Property Value
number
error_type
The fully qualified error type captured for a failed attempt, when available.
error_type?: string
Property Value
string
id
The unique run identifier for the routine attempt.
id: string
Property Value
string
phase
The AgentExtensions lifecycle phase for the routine attempt.
phase?: RoutineRunPhase
Property Value
response_id
The downstream response or invocation identifier, when available.
response_id?: string
Property Value
string
scheduled_fire_at
The scheduled fire time recorded for timer and schedule deliveries.
scheduled_fire_at?: Date
Property Value
Date
session_id
The hosted-agent session identifier used by an invocations API dispatch.
session_id?: string
Property Value
string
started_at
The time when the underlying run started.
started_at?: Date
Property Value
Date
status
The run status.
status?: string
Property Value
string
task_id
The workspace task identifier linked to the routine attempt, when available.
task_id?: string
Property Value
string
triggered_at
The logical trigger time recorded for the routine attempt.
triggered_at?: Date
Property Value
Date
trigger_name
The configured trigger name that produced the routine attempt.
trigger_name?: string
Property Value
string
trigger_type
The trigger type that produced the routine attempt.
trigger_type?: RoutineTriggerType