Skip to content

Prudai Developer API: workflows

The operations of this part (Workflows).

Base URL https://api.prudai.com/v1. Logging in is in Login, scopes in Scopes and permissions, errors in Errors. Overview.

MethodPathWhat it doesState
GET/v1/workflowsList workflow definitionsComing soon
POST/v1/workflowsCreate a workflow definitionComing soon
GET/v1/workflows/{id}Get a workflow definitionComing soon
PATCH/v1/workflows/{id}Update a workflow definitionComing soon
DELETE/v1/workflows/{id}Soft-delete a workflow definitionComing soon
POST/v1/workflows/{id}/restoreRestore a soft-deleted workflow definitionComing soon
GET/v1/workflows/catalogGet curated templates and office workflowsComing soon
POST/v1/workflows/templates/{id}/copyCopy a curated templateComing soon
POST/v1/workflows/templates/{id}/intake-prefillPre-fill template intake from owned contextComing soon

List workflow definitions

GET /v1/workflows

Lists the caller’s visible definitions with an exact filtered total. Soft-deleted definitions are not listed; restore one with POST /workflows/{id}/restore. 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:workflows:read
  • Approval: none, no extra step.

Parameters

  • X-Product-Slug header · string required
    Product context, checked against the current user and the workflow capability. One of: leo, leo-fiscaal, zia, vera, bever, irma, maia
  • q query · string
    max length 200
  • limit query · integer
    default: 20 · min 1 · max 100
  • cursor query · string
    max length 200
  • sort query · string
    One of: name, createdAt, updatedAt · default: "createdAt"
  • order query · string
    One of: asc, desc · default: "desc"

Responses

StatusMeaning
200Requested data with completeness and follow-up actions.
400Malformed request or unsupported parameter (for example client-sent tools).
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, 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).
404Workflow, run or deliverable not found or inaccessible.
409State conflict, stale If-Match, or cancellation unavailable for the current run state.
422Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body).
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Developer API or a required backing service is unavailable.
curl
curl -s "https://api.prudai.com/v1/workflows" \
-H "Authorization: Bearer $PRUDAI_TOKEN" \
-H "X-Product-Slug: leo"
CLI (coming soon)
prudai leo workflows list

Create a workflow definition

POST /v1/workflows

Creates an editable definition after the app graph validation. next points to startWorkflowRun. 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:workflows:write
  • Approval: none, no extra step.
  • Dry run: ?dryRun=true shows 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-Slug header · string required
    Product context, checked against the current user and the workflow capability. One of: leo, leo-fiscaal, zia, vera, bever, irma, maia
  • dryRun query · string
    Validate and preview without changing definitions, enqueuing jobs or recording gate decisions. One of: true, false
  • Idempotency-Key header · string required
    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.

  • name string required
    max length 200
  • description string
    max length 2000 · may be null
  • graph WorkflowGraph required
  • graph.nodes array<object> required
  • graph.nodes[].id string required
    max length 128
  • graph.nodes[].type string required
    One of: input, persona, output, condition, hitl
  • graph.nodes[].label string required
    max length 300
  • graph.nodes[].prompt string
    max length 20000
  • graph.nodes[].artifact_ref WorkflowArtifactRef
    Exact immutable source version or expected current output version. Version zero denotes the historical empty baseline where supported.
  • graph.nodes[].condition object
  • graph.nodes[].hitl object
  • graph.nodes[].v1Execution string
    One of: noop-passthrough
  • graph.nodes[].description string
    max length 4000
  • graph.nodes[].presetId string
    max length 100
  • graph.nodes[].style string
    One of: onderzoekend, strategisch, adversarieel
  • graph.nodes[].modelTier string
    One of: mini, standard, pro
  • graph.nodes[].runWhenIntake object
  • graph.nodes[].machineTranslation object
  • graph.nodes[].documentPipeline object
  • graph.nodes[].slots object
  • graph.nodes[].statuteCheck boolean
  • graph.nodes[].inputSections array<object>
  • graph.nodes[].dossierTools boolean
  • graph.nodes[].promptAxes object
  • graph.nodes[].sourceIds array<string>
  • graph.nodes[].delivery array<object>
  • graph.nodes[].position object required
  • graph.edges array<object> required
  • graph.edges[].id string required
    max length 256
  • graph.edges[].source string required
    max length 128
  • graph.edges[].target string required
    max length 128
  • graph.edges[].branch string
    One of: ja, nee

Responses

StatusMeaning
200Idempotent replay or dry-run preview.
201Completed. With dryRun=true, returns a preview without side effects.
400Malformed request or unsupported parameter (for example client-sent tools).
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, 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).
404Workflow, run or deliverable not found or inaccessible.
409State conflict, stale If-Match, or cancellation unavailable for the current run state.
422Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body).
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Developer API or a required backing service is unavailable.
curl
curl -s -X POST "https://api.prudai.com/v1/workflows" \
-H "Authorization: Bearer $PRUDAI_TOKEN" \
-H "X-Product-Slug: leo" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{ ... }'
CLI (coming soon)
prudai leo workflows create

Get a workflow definition

GET /v1/workflows/{id}

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:workflows:read
  • Approval: none, no extra step.

Parameters

  • X-Product-Slug header · string required
    Product context, checked against the current user and the workflow capability. One of: leo, leo-fiscaal, zia, vera, bever, irma, maia
  • id path · string (uuid) required

Responses

StatusMeaning
200Requested data with completeness and follow-up actions.
400Malformed request or unsupported parameter (for example client-sent tools).
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, 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).
404Workflow, run or deliverable not found or inaccessible.
409State conflict, stale If-Match, or cancellation unavailable for the current run state.
422Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body).
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Developer API or a required backing service is unavailable.

Fields in data (200)

  • id string
  • name string
  • description string
    may be null
  • graph WorkflowGraph
  • graph.nodes array<object>
  • graph.nodes[].id string
    max length 128
  • graph.nodes[].type string
    One of: input, persona, output, condition, hitl
  • graph.nodes[].label string
    max length 300
  • graph.nodes[].prompt string
    max length 20000
  • graph.nodes[].artifact_ref WorkflowArtifactRef
    Exact immutable source version or expected current output version. Version zero denotes the historical empty baseline where supported.
  • graph.nodes[].condition object
  • graph.nodes[].hitl object
  • graph.nodes[].v1Execution string
    One of: noop-passthrough
  • graph.nodes[].description string
    max length 4000
  • graph.nodes[].presetId string
    max length 100
  • graph.nodes[].style string
    One of: onderzoekend, strategisch, adversarieel
  • graph.nodes[].modelTier string
    One of: mini, standard, pro
  • graph.nodes[].runWhenIntake object
  • graph.nodes[].machineTranslation object
  • graph.nodes[].documentPipeline object
  • graph.nodes[].slots object
  • graph.nodes[].statuteCheck boolean
  • graph.nodes[].inputSections array<object>
  • graph.nodes[].dossierTools boolean
  • graph.nodes[].promptAxes object
  • graph.nodes[].sourceIds array<string>
  • graph.nodes[].delivery array<object>
  • graph.nodes[].position object
  • graph.edges array<object>
  • graph.edges[].id string
    max length 256
  • graph.edges[].source string
    max length 128
  • graph.edges[].target string
    max length 128
  • graph.edges[].branch string
    One of: ja, nee
  • organizationId string
    may be null
  • createdBy string
  • productScope string
  • createdAt string
  • updatedAt string
curl
curl -s "https://api.prudai.com/v1/workflows/<id>" \
-H "Authorization: Bearer $PRUDAI_TOKEN" \
-H "X-Product-Slug: leo"
CLI (coming soon)
prudai leo workflows get

Update a workflow definition

PATCH /v1/workflows/{id}

Partial update. If-Match binds the previously read updatedAt: without it 428 precondition_required, a stale value 409 version_conflict. 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:workflows:write
  • Approval: none, no extra step.
  • Dry run: ?dryRun=true shows what would happen and stores nothing.
  • Concurrent changes: send If-Match with the version you read.

Parameters

  • X-Product-Slug header · string required
    Product context, checked against the current user and the workflow capability. One of: leo, leo-fiscaal, zia, vera, bever, irma, maia
  • id path · string (uuid) required
  • dryRun query · string
    Validate and preview without changing definitions, enqueuing jobs or recording gate decisions. One of: true, false
  • If-Match header · string required
    The quoted updatedAt value from the last read. Missing returns 428 precondition_required; a stale value returns 409 version_conflict.

Body

JSON, required.

  • name string
    max length 200
  • description string
    max length 2000 · may be null
  • graph WorkflowGraph
  • graph.nodes array<object> required
  • graph.nodes[].id string required
    max length 128
  • graph.nodes[].type string required
    One of: input, persona, output, condition, hitl
  • graph.nodes[].label string required
    max length 300
  • graph.nodes[].prompt string
    max length 20000
  • graph.nodes[].artifact_ref WorkflowArtifactRef
    Exact immutable source version or expected current output version. Version zero denotes the historical empty baseline where supported.
  • graph.nodes[].condition object
  • graph.nodes[].hitl object
  • graph.nodes[].v1Execution string
    One of: noop-passthrough
  • graph.nodes[].description string
    max length 4000
  • graph.nodes[].presetId string
    max length 100
  • graph.nodes[].style string
    One of: onderzoekend, strategisch, adversarieel
  • graph.nodes[].modelTier string
    One of: mini, standard, pro
  • graph.nodes[].runWhenIntake object
  • graph.nodes[].machineTranslation object
  • graph.nodes[].documentPipeline object
  • graph.nodes[].slots object
  • graph.nodes[].statuteCheck boolean
  • graph.nodes[].inputSections array<object>
  • graph.nodes[].dossierTools boolean
  • graph.nodes[].promptAxes object
  • graph.nodes[].sourceIds array<string>
  • graph.nodes[].delivery array<object>
  • graph.nodes[].position object required
  • graph.edges array<object> required
  • graph.edges[].id string required
    max length 256
  • graph.edges[].source string required
    max length 128
  • graph.edges[].target string required
    max length 128
  • graph.edges[].branch string
    One of: ja, nee

Responses

StatusMeaning
200Completed. With dryRun=true, returns a preview without side effects.
400Malformed request or unsupported parameter (for example client-sent tools).
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, 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).
404Workflow, run or deliverable not found or inaccessible.
409State conflict, stale If-Match, or cancellation unavailable for the current run state.
422Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body).
428If-Match is missing (precondition_required).
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Developer API or a required backing service is unavailable.
curl
curl -s -X PATCH "https://api.prudai.com/v1/workflows/<id>" \
-H "Authorization: Bearer $PRUDAI_TOKEN" \
-H "X-Product-Slug: leo" \
-H 'If-Match: "<etag>"' \
-H "Content-Type: application/json" \
-d '{ ... }'
CLI (coming soon)
prudai leo workflows update

Soft-delete a workflow definition

DELETE /v1/workflows/{id}

Moves the definition to the trash: it leaves every list and the app, and POST /workflows/{id}/restore brings it back unchanged. Runs keep their own snapshot, so past and running runs are not affected. Waits for a reviewer (an owner or administrator, with a reason). The app’s own delete takes the same soft path. 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:workflows:delete
  • Approval: review, a second person or role approves.
  • Dry run: ?dryRun=true shows what would happen and stores nothing.
  • Deleting is soft; see Conventions.

Parameters

  • X-Product-Slug header · string required
    Product context, checked against the current user and the workflow capability. One of: leo, leo-fiscaal, zia, vera, bever, irma, maia
  • id path · string (uuid) required
  • dryRun query · string
    Validate and preview without changing definitions, enqueuing jobs or recording gate decisions. One of: true, false
  • x-prudai-approval header · string
    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}$

Responses

StatusMeaning
200Completed. With dryRun=true, returns a preview without side effects.
202Waiting for human approval. Replay the exact request with its one-use approval grant.
400Malformed request or unsupported parameter (for example client-sent tools).
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, 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).
404Workflow, run or deliverable not found or inaccessible.
409State conflict, stale If-Match, or cancellation unavailable for the current run state.
422Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body).
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Developer API or a required backing service is unavailable.
curl
curl -s -X DELETE "https://api.prudai.com/v1/workflows/<id>" \
-H "Authorization: Bearer $PRUDAI_TOKEN" \
-H "X-Product-Slug: leo"
CLI (coming soon)
prudai leo workflows delete

Restore a soft-deleted workflow definition

POST /v1/workflows/{id}/restore

Brings a soft-deleted definition back exactly as it was, with a fresh updatedAt. next points to startWorkflowRun. 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:workflows:write
  • Approval: confirm, the user confirms exactly this call.
  • Dry run: ?dryRun=true shows what would happen and stores nothing.

Parameters

  • X-Product-Slug header · string required
    Product context, checked against the current user and the workflow capability. One of: leo, leo-fiscaal, zia, vera, bever, irma, maia
  • id path · string (uuid) required
  • dryRun query · string
    Validate and preview without changing definitions, enqueuing jobs or recording gate decisions. One of: true, false
  • x-prudai-approval header · string
    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}$

Responses

StatusMeaning
200Completed. With dryRun=true, returns a preview without side effects.
202Waiting for human approval. Replay the exact request with its one-use approval grant.
400Malformed request or unsupported parameter (for example client-sent tools).
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, 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).
404Workflow, run or deliverable not found or inaccessible.
409State conflict, stale If-Match, or cancellation unavailable for the current run state.
422Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body).
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Developer API or a required backing service is unavailable.
curl
curl -s -X POST "https://api.prudai.com/v1/workflows/<id>/restore" \
-H "Authorization: Bearer $PRUDAI_TOKEN" \
-H "X-Product-Slug: leo"
CLI (coming soon)
prudai leo workflows restore

Get curated templates and office workflows

GET /v1/workflows/catalog

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:workflows:read
  • Approval: none, no extra step.

Parameters

  • X-Product-Slug header · string required
    Product context, checked against the current user and the workflow capability. One of: leo, leo-fiscaal, zia, vera, bever, irma, maia

Responses

StatusMeaning
200Requested data with completeness and follow-up actions.
400Malformed request or unsupported parameter (for example client-sent tools).
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, 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).
404Workflow, run or deliverable not found or inaccessible.
409State conflict, stale If-Match, or cancellation unavailable for the current run state.
422Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body).
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Developer API or a required backing service is unavailable.

Fields in data (200)

  • recommended array<object>
  • recommended[].id string
  • recommended[].engine string
    One of: workflow, research
  • recommended[].nameKey string
  • recommended[].promiseKey string
  • recommended[].practiceAreas array<string>
  • recommended[].personaMiniGraph object
  • recommended[].personaMiniGraph.nodes array<object>
  • recommended[].personaMiniGraph.edges array<object>
  • recommended[].outputBadges array<string>
    One of: memo-docx, tabel-matrix, chronologie, conceptbrief
  • recommended[].sourceStripIds array<string>
  • recommended[].optionalSourceIds array<string>
  • recommended[].durationCostClass string
    One of: kort, middel, lang
  • recommended[].intake object
  • recommended[].intake.fields array<object>
  • all array<object>
  • all[].id string
  • all[].engine string
    One of: workflow, research
  • all[].nameKey string
  • all[].promiseKey string
  • all[].practiceAreas array<string>
  • all[].personaMiniGraph object
  • all[].personaMiniGraph.nodes array<object>
  • all[].personaMiniGraph.edges array<object>
  • all[].outputBadges array<string>
    One of: memo-docx, tabel-matrix, chronologie, conceptbrief
  • all[].sourceStripIds array<string>
  • all[].optionalSourceIds array<string>
  • all[].durationCostClass string
    One of: kort, middel, lang
  • all[].intake object
  • all[].intake.fields array<object>
  • kantoor array<object>
  • kantoor[].id string
  • kantoor[].name string
  • kantoor[].description string
    may be null
  • kantoor[].personaMiniGraph object
  • kantoor[].personaMiniGraph.nodes array<object>
  • kantoor[].personaMiniGraph.edges array<object>
  • kantoor[].organizationId string
    may be null
  • kantoor[].updatedAt string
curl
curl -s "https://api.prudai.com/v1/workflows/catalog" \
-H "Authorization: Bearer $PRUDAI_TOKEN" \
-H "X-Product-Slug: leo"
CLI (coming soon)
prudai leo workflows catalog

Copy a curated template

POST /v1/workflows/templates/{id}/copy

Copies a curated template into an editable definition and reports anything omitted. next points to startWorkflowRun. 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:workflows:write
  • Approval: none, no extra step.
  • Dry run: ?dryRun=true shows 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-Slug header · string required
    Product context, checked against the current user and the workflow capability. One of: leo, leo-fiscaal, zia, vera, bever, irma, maia
  • id path · string required
    max length 120 · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$
  • dryRun query · string
    Validate and preview without changing definitions, enqueuing jobs or recording gate decisions. One of: true, false
  • Idempotency-Key header · string required
    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.

  • name string
    max length 200
  • includeKernprompts boolean

Responses

StatusMeaning
200Idempotent replay or dry-run preview.
201Completed. With dryRun=true, returns a preview without side effects.
400Malformed request or unsupported parameter (for example client-sent tools).
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, 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).
404Workflow, run or deliverable not found or inaccessible.
409State conflict, stale If-Match, or cancellation unavailable for the current run state.
422Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body).
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Developer API or a required backing service is unavailable.
curl
curl -s -X POST "https://api.prudai.com/v1/workflows/templates/<id>/copy" \
-H "Authorization: Bearer $PRUDAI_TOKEN" \
-H "X-Product-Slug: leo" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"name": "string",
"includeKernprompts": false
}'
CLI (coming soon)
prudai leo workflows-templates copy

Pre-fill template intake from owned context

POST /v1/workflows/templates/{id}/intake-prefill

Uses only caller-authorised draft, conversation and dossier context. Missing or uncertain answers remain open. It runs directly, like the app; it may spend a small amount of credits on the pre-fill itself, while starting the run stays behind approval. 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:workflows:write
  • Approval: none, no extra step.
  • Dry run: ?dryRun=true shows what would happen and stores nothing.

Parameters

  • X-Product-Slug header · string required
    Product context, checked against the current user and the workflow capability. One of: leo, leo-fiscaal, zia, vera, bever, irma, maia
  • id path · string required
    max length 120 · pattern ^[a-z0-9]+(?:-[a-z0-9]+)*$
  • dryRun query · string
    Validate and preview without changing definitions, enqueuing jobs or recording gate decisions. One of: true, false

Body

JSON, required.

  • draft string
    max length 100000
  • conversationId string (uuid)
  • projectId string (uuid)
  • templateName string
    max length 200

Responses

StatusMeaning
200Completed. With dryRun=true, returns a preview without side effects.
400Malformed request or unsupported parameter (for example client-sent tools).
401Missing, malformed, unknown, expired or revoked key, or a key used against the wrong environment.
403Authenticated, 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).
404Workflow, run or deliverable not found or inaccessible.
409State conflict, stale If-Match, or cancellation unavailable for the current run state.
422Well-formed request with invalid values (for example an unknown reasoning_effort, empty messages, or an Idempotency-Key reused with a different body).
429Rate limit, concurrency limit, Ultra daily quota or fair-use limit of the free sources operations exceeded.
503Developer API or a required backing service is unavailable.
curl
curl -s -X POST "https://api.prudai.com/v1/workflows/templates/<id>/intake-prefill" \
-H "Authorization: Bearer $PRUDAI_TOKEN" \
-H "X-Product-Slug: leo" \
-H "Content-Type: application/json" \
-d '{
"draft": "string",
"conversationId": "00000000-0000-4000-8000-000000000000",
"projectId": "00000000-0000-4000-8000-000000000000",
"templateName": "string"
}'
CLI (coming soon)
prudai leo workflows-templates intake-prefill