Stream and admit an NDJSON workflow batch manifest

The first line is a `batch` header with workflow_version_id, priority, configured_concurrency, and optional proxy_type and max_credits_per_request. These optional settings apply to every item in the batch. Every later line is an `item` with variables. The service validates each line as it arrives and accepts at most 100,000 items.

POST
/api/v1/browser/projects/{projectId}/environments/{environmentId}/workflows/{workflowId}/batches/manifest

The first line is a batch header with workflow_version_id, priority, configured_concurrency, and optional proxy_type and max_credits_per_request. These optional settings apply to every item in the batch. Every later line is an item with variables. The service validates each line as it arrives and accepts at most 100,000 items.

Authorization

BrowserWorkflowApiKey
headerX-API-Key<token>

Project- and environment-scoped browser workflow API key.

Path Parameters

projectId*string
Formatuuid
environmentId*string
Formatuuid
workflowId*string
Formatuuid

Header Parameters

Idempotency-Key?string

Optional. Generate a unique value before a write and retain it for an exact-body retry; replay is free and a different body returns 409 IDEMPOTENCY_CONFLICT.

Length8 <= length <= 200

Request Body

body*fileapplication/x-ndjson
Formatbinary

Response Body

Admitted workflow batch Error body uses the documented PublicError DTO.

application/json
  1. response
id*string
Formatuuid
parent_batch_id*|
Formatuuid
project_id*string
Formatuuid
environment_id*string
Formatuuid
workflow_id*string
Formatuuid
workflow_version_id*string
Formatuuid
requested_by?integer|null
status*string
configured_concurrency*integer
priority*integer
estimate_units*integer
actual_cost_units*integer
accepted_count*integer
rejected_count*integer
completed_count*integer
failed_count*integer
created_at*string
Formatdate-time
started_at*|
Formatdate-time
finished_at*|
Formatdate-time
curl -X POST 'https://api.runharvester.com/api/v1/browser/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/environments/497f6eca-6276-4993-bfeb-53cbbbba6f08/workflows/497f6eca-6276-4993-bfeb-53cbbbba6f08/batches/manifest' \  -H 'Content-Type: application/x-ndjson' \  -d '{"type":"batch","workflow_version_id":"9c9b9538-e27b-4d40-a8ae-a50aa2ea701b","priority":0,"configured_concurrency":4,"proxy_type":"premium","max_credits_per_request":100}{"type":"item","variables":{"url":"https://example.com/a"}}' \  --header "X-API-Key: ${RUNHARVESTER_BROWSER_API_KEY:?Set your Browser Workflow API key}" \  --header "Idempotency-Key: ${RUNHARVESTER_IDEMPOTENCY_KEY:?Set a unique key for this submission; reuse it for retries}"
{  "id": "9a20bd58-ed33-4a5b-b63f-b52bb1a62248",  "status": "pending"}