Skip to main content
POST
Bulk From Dataset

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string | null

Body

application/json

Request body for /bulk-from-dataset.

Fields:

  • dataset_id: target dataset UUID (must be owned by the authenticated user AND have an eligible source_type).
  • client_estimated_credits: REQUIRED. The estimate the user agreed to when they confirmed the spend in the modal. Server tolerance gate fires if 3 * len(eligible_rows) > 1.2 * client_estimated_credits, returning 409 with actual_estimated_credits so the frontend can re-display the modal with the live number.
dataset_id
string<uuid>
required

Dataset UUID owned by the authenticated user

client_estimated_credits
integer
required

User-confirmed estimate from the modal. Must be > 0.

find_on_invalid
boolean
default:true

Response

Successful Response