Struct RunResponse 

pub struct RunResponse {

    pub id: Uuid,
    pub workflow_name: String,
    pub status: RunStatus,
    pub trigger: TriggerKind,
    pub error: Option<String>,
    pub retry_count: u32,
    pub max_retries: u32,
    pub lease_recoveries: u32,
    pub cost_usd: Decimal,
    pub duration_ms: u64,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub started_at: Option<DateTime<Utc>>,
    pub completed_at: Option<DateTime<Utc>>,
    pub handler_version: Option<String>,
    pub labels: HashMap<String, String>,
    pub scheduled_at: Option<DateTime<Utc>>,
    pub capacity_wait_kind: Option<ProviderKind>,
    pub created_by: CreatedBy,
    pub idempotency_key: Option<String>,
    pub concurrency_key: Option<String>,
    pub priority: i16,
    pub concurrency_limits: Vec<ConcurrencyLimit>,
    pub max_cost_usd: Option<Decimal>,
    pub worker_tags: Vec<String>,
    pub output: Option<Value>,
    pub resume_status: Option<RunStatus>,
}

Run response DTO — public API representation of a run.

Maps from the internal Run model, exposing only necessary fields.

Examples

use ironflow_store::models::{Run, RunStatus, TriggerKind};
use ironflow_api::entities::RunResponse;

Fields

id: Uuid

Unique run identifier.

workflow_name: String

Workflow name.

status: RunStatus

Current status.

trigger: TriggerKind

How the run was triggered.

error: Option<String>

Optional error message.

retry_count: u32

Number of times retried.

max_retries: u32

Maximum allowed retries.

lease_recoveries: u32

Number of times the run was requeued after its worker lost its lease. Separate from retry_count: it does not consume max_retries.

cost_usd: Decimal

Aggregated cost in USD.

duration_ms: u64

Total duration in milliseconds.

created_at: DateTime<Utc>

When created.

updated_at: DateTime<Utc>

When last updated.

started_at: Option<DateTime<Utc>>

When execution started.

completed_at: Option<DateTime<Utc>>

When execution completed.

handler_version: Option<String>

Version of the handler that created this run.

labels: HashMap<String, String>

User-defined key-value labels.

scheduled_at: Option<DateTime<Utc>>

Scheduled execution time. None means the run executed immediately.

capacity_wait_kind: Option<ProviderKind>

Provider kind the run is waiting capacity for, set only while the run is sleeping because every targeted Provider Account is rate limited. scheduled_at then holds when the run wakes.

created_by: CreatedBy

Who triggered the run. Always present.

idempotency_key: Option<String>

Idempotency key that produced this run, when one was supplied.

concurrency_key: Option<String>

Exclusivity key held by this run until it reaches a terminal state, when one was supplied.

priority: i16

Queue priority, from -100 to 100. Workers pick the pending run with the highest priority first, then the oldest among equal priorities. 0 is the default.

concurrency_limits: Vec<ConcurrencyLimit>

Concurrency groups the run belongs to, with the limit it was created with. Omitted when the run belongs to no group.

max_cost_usd: Option<Decimal>

Cumulative cost cap for this run, in USD. None means no cap.

worker_tags: Vec<String>

Tags a worker must carry to take this run, sorted. Empty when any worker can take it.

output: Option<Value>

Typed output the handler set with WorkflowContext::set_output.

Written when the run ends (completed, warning, failed or cancelled). Omitted when the handler set no output.

resume_status: Option<RunStatus>

State a paused run returns to when it is resumed. Omitted in every other state.

Trait Implementations

impl Debug for RunResponse

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RunResponse

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Run> for RunResponse

fn from(run: Run) -> Self

Converts to this type from the input type.

impl Serialize for RunResponse

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.