Trigger a line run

POST

https://api.islo.dev/factory/lines/:name/runs

POST

/factory/lines/:name/runs

$ curl -X POST https://api.islo.dev/factory/lines/name/runs \
>      -H "Authorization: Bearer <api_key>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

1 {
2   "id": "string",
3   "line_name": "string",
4   "line_version_id": "string",
5   "workflow_run_id": "string",
6   "status": "string",
7   "trigger": {
8     "source": "string",
9     "provider": "string",
10     "event_name": "string",
11     "delivery_id": "string",
12     "payload": {}
13   },
14   "created_at": "2024-01-15T09:30:00Z",
15   "region": "string",
16   "run_params": {},
17   "result_payload": {},
18   "error_message": "string",
19   "iteration_count": 0,
20   "budget_used_usd": "string",
21   "retry": {
22     "stage_name": "string"
23   },
24   "stages": [
25     {
26       "stage_name": "string",
27       "stage_order": 1,
28       "iteration": 1,
29       "status": "string",
30       "outcome": "string",
31       "job_run_id": "string",
32       "started_at": "2024-01-15T09:30:00Z",
33       "completed_at": "2024-01-15T09:30:00Z",
34       "artifact_count": 0,
35       "input_payload": {},
36       "result_payload": {},
37       "artifacts": [
38         {}
39       ]
40     }
41   ],
42   "started_at": "2024-01-15T09:30:00Z",
43   "completed_at": "2024-01-15T09:30:00Z"
44 }

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

namestringRequired

Request

This endpoint expects an object.

version_idstring or nullOptionalformat: "uuid"

Deployed line version to run; defaults to latest

regionstring or nullOptional

Compute region override

paramsmap from strings to anyOptional

trigger_payloadmap from strings to anyOptional

Response

Successful Response

idstringformat: "uuid"

line_namestring

line_version_idstringformat: "uuid"

workflow_run_idstringformat: "uuid"

statusstring

triggerobject

What set a run off.

provider, event_name, and delivery_id are lifted out of the nested payload.trigger object so a list row is readable without walking the envelope. The extracted trigger values are not repeated here; they land in the run’s run_params. payload still carries the whole envelope, minus the raw webhook body on list responses.

created_atdatetime

regionstring or nullOptional

run_paramsmap from strings to anyOptional

result_payloadmap from strings to any or nullOptional

error_messagestring or nullOptional

iteration_countintegerOptionalDefaults to 0

budget_used_usdstring or nullOptionalformat: "^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$"

retryobject or nullOptional

stageslist of objectsOptional

started_atdatetime or nullOptional

completed_atdatetime or nullOptional

Errors

422

Unprocessable Entity Error