Skip to main content

​
POST /api/v1/growth/run

Confirm a growth quote and start the run. Returns immediately with status: "running" and a run_id you can use to poll status via GET /api/v1/growth/runs/{run_id}. Credits are deducted from your balance when the run starts.
Requires an active paid subscription. The quote token must have been minted for your account and must not have been used or expired.

​
Request body

​
quote_token
string
required
Single-use token from POST /api/v1/growth/quote. Consumed on success.
​
goal_plan
object
required
Normalised goal plan. Use the goal_plan field returned by /growth/quote, not the original resolve response.
​
chat_id
string
UUID of a chat to attach the run to. The chat must belong to your account.

​
Response

Returns 202 Accepted.
​
status
string
"running" — the job has been queued for execution.
​
run_id
string
UUID of the BD job created for this run. Use this to poll /growth/runs/{run_id}.
​
preview
object
Confirmation preview with provider preset and requested capabilities.
​
data_source_mix
object
Counts of input assets supplied and enrichment pipeline details.
​
gap_report
object
Any gaps identified in the goal plan input.

​
Example

cURL
curl -X POST https://api.deepcurrent.app/api/v1/growth/run \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "goal_plan": {
      "pipeline_id": "email_discovery_v1",
      "preset": "full_pipeline",
      "output": { "required_fields": ["email"], "preview_rows": 10 }
    }
  }'
Response
{
  "status": "running",
  "run_id": "7c3e1d22-9b4a-4f8c-b1e2-3d5f0a7c9e1b",
  "preview": {
    "message": "Enrichment has been queued.",
    "pipeline_id": "full_pipeline"
  }
}