VEverbiflow
growth-artifact-jobs

Start Ai Row Enrichment

post/api/rows/ai-enrich/start

Request

  • Base URL
    https://platform.verbiflow.com/api/bridge
  • URL
    https://platform.verbiflow.com/api/bridge/api/rows/ai-enrich/start
  • Auth
    • HTTP bearer and API key in header x-flage-org-id
    • or HTTP bearer and API key in header x-flage-org-slug

Headers

x-verbiflow-operation-partitionstring nullable

Request body

columnsstring[]

Complete ordered source-column projection from staging.

input_artifact_idstring nullable

Immutable staged-input artifact identity, or null for a legacy upload.

input_format'csv' | 'artifact_json_v1'

Encoding of the staged input object.

input_s3_keystring required

Opaque staged-input key returned with upload_id.

max_rowsinteger

Maximum rows admitted for this partition.

mode'medium' | 'max' | 'copy' | 'copy_verifier'

Model-quality policy. copy and copy_verifier are legacy aliases that select writing and evaluation workloads.

model_input_fieldsstring[] nullable

Exact source-column allowlist exposed to the model, or null for the canonical projection that omits evidence-reference and duplicate page fields.

next_start_rowinteger nullable

One-based first row of the next partition, or null when complete.

promptstring required

Analysis instruction applied independently to every projected row.

remaining_rowsinteger

Source rows after this partition.

row_countinteger required

Rows present in this staged partition.

start_rowinteger

One-based first source row in this partition.

submission_idstring nullable

Stable caller submission identity for idempotent admission, or null.

total_rowsinteger required

Rows in the complete source input.

upload_idstring required

Opaque identity returned by an AI input staging route.

workload'analysis' | 'writing' | 'evaluation' nullable

Explicit model workload, or null to derive it from mode.

Response

Successful Response

artifact_idstring nullable required

Immutable result artifact identity when admitted.

execution_idstring nullable required

Customer-credit accounting execution identity.

job_idstring required

Durable analysis job identity.

next_start_rowinteger nullable required

One-based first row of the next chunk, or null.

remaining_rowsinteger required

Rows after this admitted chunk.

row_countinteger required

Rows admitted in this job chunk.

status'queued' | 'running' | 'blocked' | 'completed' | 'failed' required

Durable job lifecycle status.

submission_idstring nullable required

Caller submission identity, or null for legacy admission.

total_rowsinteger required

Rows in the complete caller input.

workflow_run_idstring required

Workflow progress identity; equal to job_id.

Changes

No recorded changes to this operation across all 1 revision of this API.