# Automation run objects

Each items entry in the list uses the same public DTO as run details. Internal workflow/Mowl/runtime associations, revision, trace, and similar fields are not exposed by this DTO. Do not substitute a run ID for these internal identifiers.

## Run record

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | ID of this run, not a task ID. |
| `workspace_id` | string | Workspace owning the run. |
| `automation_task_id` | string | Owning automation task definition ID. |
| `automation_task_version` | integer | Task version used when creating this run. |
| `trigger_type` | string | cron/api/manual/callback. A manual run's configured mode can still be cron. |
| `trigger_config_snapshot` | object | Trigger configuration snapshot at run creation; see below. |
| `status` | string | Current run state. See query rules for the eight states. |
| `final_text` | string | Final text produced so far; may be omitted before production. |
| `structured_output` | object or null | Structured output; may be omitted when unset. Its presence alone does not establish successful output validation. |
| `output_validation_status` | string | passed/failed/skipped; omitted when unset. |
| `output_validation_error` | string | Structured output validation failure information; omitted when unset. |
| `artifact_refs` | object[] | Artifact references; omitted when empty. Not file contents. |
| `error` | object or null | Open object for run errors; optional. Known native errors receive a public projection, while unknown contracts are retained unchanged. Not an authentication or HTTP error envelope. |
| `started_at` | string | Start time in RFC3339; omitted before starting. |
| `completed_at` | string | End time in RFC3339; omitted before ending. |
| `created_at` | string | Creation time in RFC3339; always returned. |
| `updated_at` | string | Most recent update time in RFC3339; always returned. |

## Trigger configuration snapshot

| Field | Type | Description |
| --- | --- | --- |
| `mode` | string | cron/api/callback。 |
| `cron_expression` | string | Configured Cron expression; omitted when empty. |
| `result_mode` | string | Configured result mode; omitted when empty. |
| `service_name` | string | API trigger service name; omitted when empty. |
| `input_schema` | object or null | Open input JSON Schema; may be omitted when unset. |
| `config` | object or null | Open trigger configuration; may be omitted when unset. |

## Artifact references

| Field | Type | Description |
| --- | --- | --- |
| `type` | string | Artifact type marker. |
| `id` | string | Artifact identifier; omitted when empty. Not a run ID. |
| `uri` | string | Artifact URI; omitted when empty. Does not guarantee unauthenticated access or direct downloading. |
| `name` | string | Display name; omitted when empty. |
| `mime` | string | Media type; omitted when empty. |
| `meta` | object or null | Open metadata; may be omitted when unset. |

structured_output, input_schema/config, meta, and error retain their respective open-object boundaries. Do not turn unverified internal fields into a fixed contract. Check succeeded and output_validation_status separately. Reading a result does not automatically wait for a terminal state; HTTP200 is not execution success.
