Prudai Developer API: workflow runs
The operations of this part (Workflow runs).
Base URL https://api.prudai.com/v1. Logging in is in Login, scopes in Scopes and permissions, errors in Errors. Overview.
| Method | Path | What it does | State |
|---|---|---|---|
GET | /v1/artifacts/{id}/runs | List workflow runs that produced an artifact | Coming soon |
GET | /v1/workflow-runs | List the caller’s workflow runs | Coming soon |
GET | /v1/workflow-runs/{id} | Get workflow status, steps and events | Coming soon |
POST | /v1/workflow-runs/{id}/cancel | Stop a workflow run | Coming soon |
POST | /v1/workflow-runs/{id}/continue | Continue a resumable workflow run | Coming soon |
GET | /v1/workflow-runs/{id}/deliverables | List workflow run deliverables | Coming soon |
GET | /v1/workflow-runs/{id}/deliverables/{deliverable_id}/download | Download a workflow deliverable | Coming soon |
POST | /v1/workflow-runs/{id}/gate | Answer a waiting human gate | Coming soon |
GET | /v1/workflow-runs/{id}/tables | List named tables produced by a workflow run | Coming soon |
POST | /v1/workflows/{id}/runs | Start a workflow definition run | Coming soon |
POST | /v1/workflows/templates/{id}/runs | Start a curated workflow template run | Coming soon |
List workflow runs that produced an artifact
GET /v1/artifacts/{id}/runs
Returns metadata only after checking the artifact source access and the run owner. The exact total is unknown (completeness.total is null); next contains the next page when more rows exist. Personal tokens and signed-in user tokens only; service keys are rejected. The same product, organisation, workflow capability and ownership rules as the app apply, including 403 workflows_upgrade_required for VERA without Pro.
- State: coming soon, not in production yet.
- Scope:
prudai:artifacts:read,prudai:workflows:read - Approval:
none, no extra step.
Parameters
X-Product-Slugrequired
Product context, checked against the current user and the workflow capability. One of:leo,leo-fiscaal,zia,vera,bever,irma,maiaidrequiredlimit
default:20· min 1 · max 100cursor
max length 200
Responses
| Status | Meaning |
|---|---|
200 | Requested data with completeness and follow-up actions. |
400 | Malformed request or unsupported parameter (for example client-sent tools). |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Workflow, run or deliverable not found or inaccessible. |
409 | State conflict, stale If-Match, or cancellation unavailable for the current run state. |
422 | Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body). |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
503 | Developer API or a required backing service is unavailable. |
curl -s "https://api.prudai.com/v1/artifacts/<id>/runs" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "X-Product-Slug: leo"prudai leo artifacts runs[ { "run_id": "00000000-0000-4000-8000-000000000000", "artifact_ref": { "artifact_id": "00000000-0000-4000-8000-000000000000", "version": 1 }, "created_at": "2026-11-05T09:30:00.000Z" }]List the caller's workflow runs
GET /v1/workflow-runs
Only workflow runs are included. The existing app listing is capped; when the complete total is unknown completeness.total is null and notIncluded explains the source limit. Personal tokens and signed-in user tokens only; service keys are rejected. The same product, organisation, workflow capability and ownership rules as the app apply, including 403 workflows_upgrade_required for VERA without Pro.
- State: coming soon, not in production yet.
- Scope:
prudai:workflow_runs:read - Approval:
none, no extra step.
Parameters
X-Product-Slugrequired
Product context, checked against the current user and the workflow capability. One of:leo,leo-fiscaal,zia,vera,bever,irma,maiaprojectIdstatus
max length 80limit
default:20· min 1 · max 100cursor
max length 200
Responses
| Status | Meaning |
|---|---|
200 | Requested data with completeness and follow-up actions. |
400 | Malformed request or unsupported parameter (for example client-sent tools). |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Workflow, run or deliverable not found or inaccessible. |
409 | State conflict, stale If-Match, or cancellation unavailable for the current run state. |
422 | Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body). |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
503 | Developer API or a required backing service is unavailable. |
curl -s "https://api.prudai.com/v1/workflow-runs" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "X-Product-Slug: leo"prudai leo workflow-runs listGet workflow status, steps and events
GET /v1/workflow-runs/{id}
Returns the app run state including logs, progress, budget and any waiting gate. Once completed, next points to listWorkflowRunDeliverables. Personal tokens and signed-in user tokens only; service keys are rejected. The same product, organisation, workflow capability and ownership rules as the app apply, including 403 workflows_upgrade_required for VERA without Pro.
- State: coming soon, not in production yet.
- Scope:
prudai:workflow_runs:read - Approval:
none, no extra step.
Parameters
X-Product-Slugrequired
Product context, checked against the current user and the workflow capability. One of:leo,leo-fiscaal,zia,vera,bever,irma,maiaidrequired
Responses
| Status | Meaning |
|---|---|
200 | Requested data with completeness and follow-up actions. |
400 | Malformed request or unsupported parameter (for example client-sent tools). |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Workflow, run or deliverable not found or inaccessible. |
409 | State conflict, stale If-Match, or cancellation unavailable for the current run state. |
422 | Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body). |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
503 | Developer API or a required backing service is unavailable. |
Fields in data (200)
artifact_ref
Exact immutable source version or expected current output version. Version zero denotes the historical empty baseline where supported.artifact_ref.artifact_idartifact_ref.version
min 0previousAttemptpreviousAttempt.statuspreviousAttempt.finishedAt
may benullpreviousAttempt.archivedAtpreviousAttempt.resultpreviousAttempt.error
may benullpreviousAttempt.deliverableCountjobIdstatustopiccreatedAtprojectIdprojectDocumentIdsdocumentMode
One of:auto,selection,noneeffectiveProjectDocumentIdsprojectNamelogslogs[].agentlogs[].messagelogs[].timestampresulterror
may benullwarnings
may benulluiUrlmetadocumentScopequeuequeue.statequeue.position
may benullqueue.etaSeconds
may benullqueue.reason
may benullqueue.checkedAt
may benullbudgetUsageprogressbudgetbudget.limitsbudget.limits.maxEstimatedTokens
This list stops after 40 fields.
curl -s "https://api.prudai.com/v1/workflow-runs/<id>" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "X-Product-Slug: leo"prudai leo workflow-runs getStop a workflow run
POST /v1/workflow-runs/{id}/cancel
Stops the caller’s own run. At a waiting human gate it submits the gate abort. A queued or running run is stopped cooperatively: no further step starts, the steps already in flight finish, and the run ends as aborted with everything that completed as partial result (the run history is kept, nothing is deleted); the response is status: stopping and getWorkflowRun shows aborted shortly after. A run that is still waiting in the queue (for example for capacity) starts no step at all: it ends as aborted with an empty partial result, without a model call and therefore without cost, as soon as it is picked up; until then getWorkflowRun still shows queued. A run that has already ended returns 409 workflow_cancel_unavailable. Personal tokens and signed-in user tokens only; service keys are rejected. The same product, organisation, workflow capability and ownership rules as the app apply, including 403 workflows_upgrade_required for VERA without Pro.
- State: coming soon, not in production yet.
- Scope:
prudai:workflow_runs:write - Approval:
none, no extra step. - Dry run:
?dryRun=trueshows what would happen and stores nothing.
Parameters
X-Product-Slugrequired
Product context, checked against the current user and the workflow capability. One of:leo,leo-fiscaal,zia,vera,bever,irma,maiaidrequireddryRun
Validate and preview without changing definitions, enqueuing jobs or recording gate decisions. One of:true,false
Body
JSON, required.
Responses
| Status | Meaning |
|---|---|
200 | Completed. With dryRun=true, returns a preview without side effects. |
400 | Malformed request or unsupported parameter (for example client-sent tools). |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Workflow, run or deliverable not found or inaccessible. |
409 | State conflict, stale If-Match, or cancellation unavailable for the current run state. |
422 | Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body). |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
503 | Developer API or a required backing service is unavailable. |
curl -s -X POST "https://api.prudai.com/v1/workflow-runs/<id>/cancel" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "X-Product-Slug: leo" \ -H "Content-Type: application/json" \ -d '{}'prudai leo workflow-runs cancelContinue a resumable workflow run
POST /v1/workflow-runs/{id}/continue
Preserves completed steps and starts a fresh budget window through the existing app continuation service. The owner continues their own run directly, as in the app; the run budget still applies. Personal tokens and signed-in user tokens only; service keys are rejected. The same product, organisation, workflow capability and ownership rules as the app apply, including 403 workflows_upgrade_required for VERA without Pro.
- State: coming soon, not in production yet.
- Scope:
prudai:workflow_runs:write - Approval:
none, no extra step. - Dry run:
?dryRun=trueshows what would happen and stores nothing.
Parameters
X-Product-Slugrequired
Product context, checked against the current user and the workflow capability. One of:leo,leo-fiscaal,zia,vera,bever,irma,maiaidrequireddryRun
Validate and preview without changing definitions, enqueuing jobs or recording gate decisions. One of:true,false
Body
JSON, required.
Responses
| Status | Meaning |
|---|---|
200 | Completed. With dryRun=true, returns a preview without side effects. |
400 | Malformed request or unsupported parameter (for example client-sent tools). |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Workflow, run or deliverable not found or inaccessible. |
409 | State conflict, stale If-Match, or cancellation unavailable for the current run state. |
422 | Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body). |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
503 | Developer API or a required backing service is unavailable. |
curl -s -X POST "https://api.prudai.com/v1/workflow-runs/<id>/continue" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "X-Product-Slug: leo" \ -H "Content-Type: application/json" \ -d '{}'prudai leo workflow-runs continueList workflow run deliverables
GET /v1/workflow-runs/{id}/deliverables
A run of your own without deliverables (yet) returns an empty list, not 404. Personal tokens and signed-in user tokens only; service keys are rejected. The same product, organisation, workflow capability and ownership rules as the app apply, including 403 workflows_upgrade_required for VERA without Pro.
- State: coming soon, not in production yet.
- Scope:
prudai:workflow_runs:read - Approval:
none, no extra step.
Parameters
X-Product-Slugrequired
Product context, checked against the current user and the workflow capability. One of:leo,leo-fiscaal,zia,vera,bever,irma,maiaidrequired
Responses
| Status | Meaning |
|---|---|
200 | Requested data with completeness and follow-up actions. |
400 | Malformed request or unsupported parameter (for example client-sent tools). |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Workflow, run or deliverable not found or inaccessible. |
409 | State conflict, stale If-Match, or cancellation unavailable for the current run state. |
422 | Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body). |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
503 | Developer API or a required backing service is unavailable. |
curl -s "https://api.prudai.com/v1/workflow-runs/<id>/deliverables" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "X-Product-Slug: leo"prudai leo workflow-runs-deliverables listDownload a workflow deliverable
GET /v1/workflow-runs/{id}/deliverables/{deliverable_id}/download
Returns the original rendered bytes with Content-Type and Content-Disposition, as in the app. This binary response is an explicit exception to the JSON envelope. Personal tokens and signed-in user tokens only; service keys are rejected. The same product, organisation, workflow capability and ownership rules as the app apply, including 403 workflows_upgrade_required for VERA without Pro.
- State: coming soon, not in production yet.
- Scope:
prudai:workflow_runs:read - Approval:
none, no extra step.
Parameters
X-Product-Slugrequired
Product context, checked against the current user and the workflow capability. One of:leo,leo-fiscaal,zia,vera,bever,irma,maiaidrequireddeliverable_idrequired
max length 64format
One of:docx,csv,json,markdown
Responses
| Status | Meaning |
|---|---|
200 | The rendered deliverable. |
400 | Malformed request or unsupported parameter (for example client-sent tools). |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Workflow, run or deliverable not found or inaccessible. |
409 | State conflict, stale If-Match, or cancellation unavailable for the current run state. |
422 | Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body). |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
503 | Developer API or a required backing service is unavailable. |
Response format: application/vnd.openxmlformats-officedocument.wordprocessingml.document, text/csv, text/markdown.
curl -s "https://api.prudai.com/v1/workflow-runs/<id>/deliverables/<deliverable_id>/download" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "X-Product-Slug: leo"prudai leo workflow-runs-deliverables download"string"Answer a waiting human gate
POST /v1/workflow-runs/{id}/gate
Approve, request revision or abort the exact waiting node. Decisions use the existing decision-event record and run ownership checks. An abort is final: the response carries status aborted (the run ends with its partial result). Personal tokens and signed-in user tokens only; service keys are rejected. The same product, organisation, workflow capability and ownership rules as the app apply, including 403 workflows_upgrade_required for VERA without Pro.
- State: coming soon, not in production yet.
- Scope:
prudai:workflow_runs:write - Approval:
none, no extra step. - Dry run:
?dryRun=trueshows what would happen and stores nothing.
Parameters
X-Product-Slugrequired
Product context, checked against the current user and the workflow capability. One of:leo,leo-fiscaal,zia,vera,bever,irma,maiaidrequireddryRun
Validate and preview without changing definitions, enqueuing jobs or recording gate decisions. One of:true,false
Body
JSON, required.
nodeIdrequired
max length 128decisionrequired
One of:approve,revise,abortnote
max length 4000
Responses
| Status | Meaning |
|---|---|
200 | Completed. With dryRun=true, returns a preview without side effects. |
400 | Malformed request or unsupported parameter (for example client-sent tools). |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Workflow, run or deliverable not found or inaccessible. |
409 | State conflict, stale If-Match, or cancellation unavailable for the current run state. |
422 | Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body). |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
503 | Developer API or a required backing service is unavailable. |
curl -s -X POST "https://api.prudai.com/v1/workflow-runs/<id>/gate" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "X-Product-Slug: leo" \ -H "Content-Type: application/json" \ -d '{ "nodeId": "string", "decision": "approve", "note": "string" }'prudai leo workflow-runs gateList named tables produced by a workflow run
GET /v1/workflow-runs/{id}/tables
Personal tokens and signed-in user tokens only; service keys are rejected. The same product, organisation, workflow capability and ownership rules as the app apply, including 403 workflows_upgrade_required for VERA without Pro.
- State: coming soon, not in production yet.
- Scope:
prudai:workflow_runs:read - Approval:
none, no extra step.
Parameters
X-Product-Slugrequired
Product context, checked against the current user and the workflow capability. One of:leo,leo-fiscaal,zia,vera,bever,irma,maiaidrequired
Responses
| Status | Meaning |
|---|---|
200 | Requested data with completeness and follow-up actions. |
400 | Malformed request or unsupported parameter (for example client-sent tools). |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Workflow, run or deliverable not found or inaccessible. |
409 | State conflict, stale If-Match, or cancellation unavailable for the current run state. |
422 | Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body). |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
503 | Developer API or a required backing service is unavailable. |
curl -s "https://api.prudai.com/v1/workflow-runs/<id>/tables" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "X-Product-Slug: leo"prudai leo workflow-runs tablesStart a workflow definition run
POST /v1/workflows/{id}/runs
Starting spends credits and requires confirm approval. next points to getWorkflowRun. Per-run costs are not yet listed in /v1/usage (planned); the run budget is shown on getWorkflowRun. Personal tokens and signed-in user tokens only; service keys are rejected. The same product, organisation, workflow capability and ownership rules as the app apply, including 403 workflows_upgrade_required for VERA without Pro.
- State: coming soon, not in production yet.
- Scope:
prudai:workflow_runs:write - Approval:
confirm, the user confirms exactly this call. - Dry run:
?dryRun=trueshows what would happen and stores nothing. - Idempotency: send
Idempotency-Key; the same key with the same body does not run the action twice.
Parameters
X-Product-Slugrequired
Product context, checked against the current user and the workflow capability. One of:leo,leo-fiscaal,zia,vera,bever,irma,maiaidrequireddryRun
Validate and preview without changing definitions, enqueuing jobs or recording gate decisions. One of:true,falsex-prudai-approval
Approved one-use request id. Repeat the exact method, path, query and body. The grant is consumed before execution; obtain a new approval after a failed execution. Idempotency-Key is excluded from the approval fingerprint. pattern^apr_[A-Za-z0-9]{24}$Idempotency-Keyrequired
Client-chosen key. Retry the same request safely; changed arguments with the same key are rejected. min length 8 · max length 255 · pattern^[\x21-\x7E]+$
Body
JSON, required.
inputrequiredinput.queryrequired
max length 100000input.projectIdinput.documentIdsinput.artifact_ref
Exact immutable source version or expected current output version. Version zero denotes the historical empty baseline where supported.input.artifact_ref.artifact_idrequiredinput.artifact_ref.versionrequired
min 0input.output_artifact_ref
Exact immutable source version or expected current output version. Version zero denotes the historical empty baseline where supported.input.output_artifact_ref.artifact_idrequiredinput.output_artifact_ref.versionrequired
min 0
Responses
| Status | Meaning |
|---|---|
200 | Idempotent replay or dry-run preview. |
201 | Completed. With dryRun=true, returns a preview without side effects. |
202 | Waiting for human approval. Replay the exact request with its one-use approval grant. |
400 | Malformed request or unsupported parameter (for example client-sent tools). |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Workflow, run or deliverable not found or inaccessible. |
409 | State conflict, stale If-Match, or cancellation unavailable for the current run state. |
422 | Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body). |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
503 | Developer API or a required backing service is unavailable. |
curl -s -X POST "https://api.prudai.com/v1/workflows/<id>/runs" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "X-Product-Slug: leo" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "input": { "query": "string", "projectId": "00000000-0000-4000-8000-000000000000", "documentIds": [ "00000000-0000-4000-8000-000000000000" ], "artifact_ref": { "artifact_id": "00000000-0000-4000-8000-000000000000", "version": 1 }, "output_artifact_ref": { "artifact_id": "00000000-0000-4000-8000-000000000000", "version": 1 } } }'prudai leo workflows runsStart a curated workflow template run
POST /v1/workflows/templates/{id}/runs
Validates intake and selected sources through the same app service. Starting spends credits and requires confirm approval. next points to getWorkflowRun. Personal tokens and signed-in user tokens only; service keys are rejected. The same product, organisation, workflow capability and ownership rules as the app apply, including 403 workflows_upgrade_required for VERA without Pro.
- State: coming soon, not in production yet.
- Scope:
prudai:workflow_runs:write - Approval:
confirm, the user confirms exactly this call. - Dry run:
?dryRun=trueshows what would happen and stores nothing. - Idempotency: send
Idempotency-Key; the same key with the same body does not run the action twice.
Parameters
X-Product-Slugrequired
Product context, checked against the current user and the workflow capability. One of:leo,leo-fiscaal,zia,vera,bever,irma,maiaidrequired
max length 120 · pattern^[a-z0-9]+(?:-[a-z0-9]+)*$dryRun
Validate and preview without changing definitions, enqueuing jobs or recording gate decisions. One of:true,falsex-prudai-approval
Approved one-use request id. Repeat the exact method, path, query and body. The grant is consumed before execution; obtain a new approval after a failed execution. Idempotency-Key is excluded from the approval fingerprint. pattern^apr_[A-Za-z0-9]{24}$Idempotency-Keyrequired
Client-chosen key. Retry the same request safely; changed arguments with the same key are rejected. min length 8 · max length 255 · pattern^[\x21-\x7E]+$
Body
JSON, required.
artifact_ref
Exact immutable source version or expected current output version. Version zero denotes the historical empty baseline where supported.artifact_ref.artifact_idrequiredartifact_ref.versionrequired
min 0output_artifact_ref
Exact immutable source version or expected current output version. Version zero denotes the historical empty baseline where supported.output_artifact_ref.artifact_idrequiredoutput_artifact_ref.versionrequired
min 0intakeprojectIdenabledSourceIds
Responses
| Status | Meaning |
|---|---|
200 | Idempotent replay or dry-run preview. |
201 | Completed. With dryRun=true, returns a preview without side effects. |
202 | Waiting for human approval. Replay the exact request with its one-use approval grant. |
400 | Malformed request or unsupported parameter (for example client-sent tools). |
401 | Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment. |
403 | Authenticated, but not allowed (missing scope, product not on the key or organisation, organisation suspended, Developer API switched off for the organisation, IP not on the allowlist, depth not permitted, licence does not permit redistribution). |
404 | Workflow, run or deliverable not found or inaccessible. |
409 | State conflict, stale If-Match, or cancellation unavailable for the current run state. |
422 | Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body). |
429 | Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded. |
503 | Developer API or a required backing service is unavailable. |
curl -s -X POST "https://api.prudai.com/v1/workflows/templates/<id>/runs" \ -H "Authorization: Bearer $PRUDAI_TOKEN" \ -H "X-Product-Slug: leo" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "artifact_ref": { "artifact_id": "00000000-0000-4000-8000-000000000000", "version": 1 }, "output_artifact_ref": { "artifact_id": "00000000-0000-4000-8000-000000000000", "version": 1 }, "intake": {}, "projectId": "00000000-0000-4000-8000-000000000000", "enabledSourceIds": [ "string" ] }'prudai leo workflows-templates runs