Struct RunResponse 

pub struct RunResponse {

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

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;

JSON schema

{
 "description": "Run response DTO — public API representation of a run.\n\nMaps from the internal [`Run`] model, exposing only necessary fields.\n\n# Examples\n\n```\nuse ironflow_store::models::{Run, RunStatus, TriggerKind};\nuse ironflow_api::entities::RunResponse;\n```",
 "type": "object",
 "required": [
   "cost_usd",
   "created_at",
   "created_by",
   "duration_ms",
   "id",
   "lease_recoveries",
   "max_retries",
   "retry_count",
   "status",
   "trigger",
   "updated_at",
   "workflow_name"
 ],
 "properties": {
   "capacity_wait_kind": {
     "description": "Provider kind the run is waiting capacity for, set only while the\nrun is `sleeping` because every targeted Provider Account is rate\nlimited. `scheduled_at` then holds when the run wakes.",
     "type": [
       "string",
       "null"
     ]
   },
   "completed_at": {
     "description": "When execution completed.",
     "type": [
       "string",
       "null"
     ],
     "format": "date-time"
   },
   "concurrency_key": {
     "description": "Exclusivity key held by this run until it reaches a terminal state,\nwhen one was supplied.",
     "type": [
       "string",
       "null"
     ]
   },
   "concurrency_limits": {
     "description": "Concurrency groups the run belongs to, with the limit it was created\nwith. Omitted when the run belongs to no group.",
     "type": "array",
     "items": {
       "$ref": "#/components/schemas/ConcurrencyLimit"
     }
   },
   "cost_usd": {
     "description": "Aggregated cost in USD.",
     "type": "number",
     "format": "double"
   },
   "created_at": {
     "description": "When created.",
     "type": "string",
     "format": "date-time"
   },
   "created_by": {
     "$ref": "#/components/schemas/CreatedBy"
   },
   "duration_ms": {
     "description": "Total duration in milliseconds.",
     "type": "integer",
     "format": "int64",
     "minimum": 0.0
   },
   "error": {
     "description": "Optional error message.",
     "type": [
       "string",
       "null"
     ]
   },
   "handler_version": {
     "description": "Version of the handler that created this run.",
     "type": [
       "string",
       "null"
     ]
   },
   "id": {
     "description": "Unique run identifier.",
     "type": "string",
     "format": "uuid"
   },
   "idempotency_key": {
     "description": "Idempotency key that produced this run, when one was supplied.",
     "type": [
       "string",
       "null"
     ]
   },
   "labels": {
     "description": "User-defined key-value labels.",
     "type": "object",
     "additionalProperties": {
       "type": "string"
     }
   },
   "lease_recoveries": {
     "description": "Number of times the run was requeued after its worker lost its lease. Separate from `retry_count`: it does not consume `max_retries`.",
     "type": "integer",
     "format": "int32",
     "minimum": 0.0
   },
   "max_cost_usd": {
     "description": "Cumulative cost cap for this run, in USD. `None` means no cap.",
     "type": [
       "number",
       "null"
     ],
     "format": "double"
   },
   "max_retries": {
     "description": "Maximum allowed retries.",
     "type": "integer",
     "format": "int32",
     "minimum": 0.0
   },
   "output": {
     "description": "Typed output the handler set with `WorkflowContext::set_output`.\n\nWritten when the run ends (completed, warning, failed or cancelled).\nOmitted when the handler set no output."
   },
   "priority": {
     "description": "Queue priority, from -100 to 100. Workers pick the pending run with\nthe highest priority first, then the oldest among equal priorities.\n`0` is the default.",
     "type": "integer",
     "format": "int32"
   },
   "resume_status": {
     "$ref": "#/components/schemas/RunStatus"
   },
   "retry_count": {
     "description": "Number of times retried.",
     "type": "integer",
     "format": "int32",
     "minimum": 0.0
   },
   "scheduled_at": {
     "description": "Scheduled execution time. `None` means the run executed immediately.",
     "type": [
       "string",
       "null"
     ],
     "format": "date-time"
   },
   "started_at": {
     "description": "When execution started.",
     "type": [
       "string",
       "null"
     ],
     "format": "date-time"
   },
   "status": {
     "$ref": "#/components/schemas/RunStatus"
   },
   "trigger": {
     "$ref": "#/components/schemas/TriggerKind"
   },
   "updated_at": {
     "description": "When last updated.",
     "type": "string",
     "format": "date-time"
   },
   "worker_tags": {
     "description": "Tags a worker must carry to take this run, sorted. Empty when any\nworker can take it.",
     "type": "array",
     "items": {
       "type": "string"
     }
   },
   "workflow_name": {
     "description": "Workflow name.",
     "type": "string"
   }
 }
}
```ignore
</details>

Fields

capacity_wait_kind: Option<String>

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.

completed_at: Option<DateTime<Utc>>

When execution completed.

concurrency_key: Option<String>

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

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.

cost_usd: f64

Aggregated cost in USD.

created_at: DateTime<Utc>

When created.

created_by: CreatedBy

duration_ms: i64

Total duration in milliseconds.

error: Option<String>

Optional error message.

handler_version: Option<String>

Version of the handler that created this run.

id: Uuid

Unique run identifier.

idempotency_key: Option<String>

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

labels: HashMap<String, String>

User-defined key-value labels.

lease_recoveries: i32

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

max_cost_usd: Option<f64>

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

max_retries: i32

Maximum allowed retries.

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.

priority: Option<i32>

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.

resume_status: Option<RunStatus>

retry_count: i32

Number of times retried.

scheduled_at: Option<DateTime<Utc>>

Scheduled execution time. None means the run executed immediately.

started_at: Option<DateTime<Utc>>

When execution started.

status: RunStatus

trigger: TriggerKind

updated_at: DateTime<Utc>

When last updated.

worker_tags: Vec<String>

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

workflow_name: String

Workflow name.

Implementations

impl RunResponse

pub fn builder() -> RunResponse

Trait Implementations

impl Clone for RunResponse

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

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<RunResponse> for RunResponse

fn from(value: RunResponse) -> 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.

impl TryFrom<RunResponse> for RunResponse

type Error = ConversionError

The type returned in the event of a conversion error.

fn try_from(value: RunResponse) -> Result<Self, ConversionError>

Performs the conversion.