POST/api/v1/runs/{runId}/files
Each file is persisted as an artifact (source of truth) and, if the
container is live, immediately written to the workdir via a
file:inject WebSocket frame.
The response reports which paths were persisted and whether the
write was also liveDelivered to the running container.
Authentication
Requires a project API key — see Authentication.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
runId | path | string | required | UUID of the run. |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
files | array | required |
Responses
| Status | Description |
|---|---|
202 | Files accepted. |
400 | Request body or query parameters failed validation. |
404 | Resource not found or not accessible to this project. |
Tag: Interactions