Run a dataset against a registered HTTP Target
Start a Zespan-executed run: for every item in the dataset, Zespan hydrates the target’s request template with the item’s input and POSTs it directly to the registered HTTP Target’s endpoint, capturing the raw response as a trace tagged sdk_name: "zespan-http-endpoint". Unlike every other dataset-run endpoint on this page, Zespan itself makes the call — no SDK integration on the target’s side is required.
The target itself is created, updated, and deleted from the dashboard (Project Settings → HTTP Targets), not through this public API — see HTTP Targets.
The run is created (or re-attached to, if runName matches an existing run) and its execution is enqueued asynchronously; poll GET /v1/datasets/{datasetId}/runs/{runId} for progress and to see each item link as it completes.
Authorizations
Project API key. Manage keys in the Zespan dashboard under project settings.
Path Parameters
Dataset id.
Body
Id of a registered HTTP Target in this project.
Optional run name. Reusing an existing run's name re-attaches to it instead of creating a duplicate. Defaults to an auto-generated http-target-<id> name.
1 - 120Optional when authenticating with an API key.
Response
Run created and execution enqueued (or created but not enqueued — see note).

