Complete a managed CDP run with bounded metadata

Complete a managed CDP run with bounded metadata

POST
/api/v1/browser/projects/{projectId}/environments/{environmentId}/cdp-sessions/{sessionId}/complete

Complete a managed CDP run with bounded metadata

Authorization

BrowserWorkflowApiKey
headerX-API-Key<token>

Project- and environment-scoped browser workflow API key.

Path Parameters

projectId*string
Formatuuid
environmentId*string
Formatuuid
sessionId*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

application/json
  1. body
status*string
Value in"succeeded""failed""cancelled"
metadata?
Default{}

Response Body

Terminal workflow run Error body uses the documented PublicError DTO.

application/json
  1. response
id*string
Formatuuid
project_id*string
Formatuuid
environment_id*string
Formatuuid
workflow_id*string
Formatuuid
workflow_version_id*string
Formatuuid
proxy_type*|

Proxy class selected when the run was created; null for legacy runs that predate class selection.

max_credits_per_request*|

Request-wide credit ceiling fixed at admission; null for legacy runs without a configured cap.

Range1 <= value
requested_by?integer|null
status*string
Value in"queued""running""succeeded""failed""cancelled""expired"
execution_kind*string
Value in"workflow""cdp"
variables*
result*|null
action_trace*array<>
Itemsitems <= 100
result_metadata*
quality_state*string
Value in"pending""validated""unavailable"
error_code*|

Terminal workflow error, including budget_exhausted and PROXY_CLASS_UNAVAILABLE when applicable.

error_message*string|null
attempt_count*integer
max_attempts*integer
priority*integer
created_at*string
Formatdate-time
started_at*|
Formatdate-time
finished_at*|
Formatdate-time
expires_at*string
Formatdate-time
curl -X POST 'https://api.runharvester.com/api/v1/browser/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/environments/497f6eca-6276-4993-bfeb-53cbbbba6f08/cdp-sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/complete' \  -H 'Content-Type: application/json' \  -d '{  "status": "succeeded"}' \  --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"}