Skip to main content

Run

Description

A single attempt to execute a Task within a WorkflowExecution with idempotency and lease tracking

Properties

NameTypeDescriptionNotes
executionIdUUIDReference to the parent WorkflowExecution[optional]
taskIdUUIDReference to the Task being executed[optional]
execModuleIdUUIDSpecific ExecModule within the task[optional]
attemptIntegerRetry attempt number (1-based)[optional]
stateStateEnumCurrent run state[optional]
leaseUntilOffsetDateTimeLease expiration timestamp for at-least-once delivery[optional]
leasedByStringRunner/pod ID that owns the lease[optional]
runnerIdStringIdentifier of the runner pod executing this run[optional]
idempotencyKeyUUIDContent hash of inputs + config for exact-once semantics (SHA-256)[optional]
inputsHashStringSHA-256 hash of input map for change detection[optional]
configHashStringSHA-256 hash of module config for change detection[optional]
startedAtOffsetDateTimeWhen the run started executing[optional]
finishedAtOffsetDateTimeWhen the run completed or failed[optional]
heartbeatAtOffsetDateTimeLast heartbeat timestamp from runner (for zombie detection)[optional]
outputsStringJSON result map from module execution[optional]
errorStringError message if run failed[optional]
errorTypeErrorTypeEnumClassification of error for retry logic[optional]
retryReadyAtOffsetDateTimeTimestamp after which retry can be attempted (exponential backoff)[optional]
durationMsIntegerExecution duration in milliseconds[optional]
costTokensDoubleCost tokens for LLM/API usage tracking[optional]
idUUIDUnique identifier for object in the system[optional] [readonly]
ownerIdUUIDUUID of owner of the object in the system[optional] [readonly]
createdDateOffsetDateTimeDate of object creation[optional] [readonly]
keyHashStringData, including hash of the key(s) used to encrypt this record.[optional] [readonly]
lastAccessedByIdUUIDLast user to access object[optional] [readonly]
lastAccessedDateOffsetDateTimeTimestamp of last access of object[optional] [readonly]
lastModifiedByIdUUIDUnique identifier for user who last modifed the object in the system[optional] [readonly]
lastModifiedDateOffsetDateTimeDate of last object modification[optional] [readonly]

Enum: StateEnum

NameValue
PENDING"PENDING"
LEASED"LEASED"
RUNNING"RUNNING"
SUCCESS"SUCCESS"
FAILED"FAILED"
DLQ"DLQ"
CANCELLED"CANCELLED"

Enum: ErrorTypeEnum

NameValue
TRANSIENT"TRANSIENT"
PERMANENT"PERMANENT"
TIMEOUT"TIMEOUT"
CIRCUIT_OPEN"CIRCUIT_OPEN"

Implemented Interfaces

  • Serializable

Generated Version Details

~value
GENERATOR VERSIONcom.valkyrlabs:ValkyrAI API 1.0.1-SNAPSHOT
API ARTIFACTcom.valkyrlabs.valkyrai-api.jar
GENERATOR VERSIONorg.openapitools.openapi-generator:7.5.0
GENERATOR CLASSorg.openapitools.codegen.languages.SpringCodegen
GENERATED DATE2025-12-03T11:13:18.492704-08:00[America/Los_Angeles]