Workflows and apps
Run a test execution
Schedule a cloud test execution of the published version with an optional trigger payload. Poll the execution for the result.
POST
https://cloud.generalinput.com/v1/workflows/:id/testAuthenticationRequires
workflows:manage on a personal API key. A CLI session always passes.Runs the live bundle, so publish first. Test runs execute even when the workflow is disabled. The call returns as soon as the run is scheduled; read the outcome from get an execution.
Body
| Field | Type | Notes |
|---|---|---|
triggerPayload | object | Optional. Becomes the run's input. Defaults to {}. |
Response
{ "executionId": "exec_01HX…" }When the workflow is not ready, nothing is scheduled and the blockers are returned instead:
{
"executionId": null,
"blockers": [{ "message": "Credential slot 'slack' is not wired." }]
}Fix them with update config and call again.
Polling
curl -s "https://cloud.generalinput.com/v1/workflows/wf_01HX/executions/exec_01HX" \
-H "Authorization: Bearer $GI_API_KEY" | jq '{status, error}'Poll every few seconds until status leaves scheduled and running. Code runs usually finish in seconds; agent runs take minutes.