Skip to main content
POST
/
api
/
data-platform
/
sandbox-promote-runs
Create a sandbox promote run
curl --request POST \
  --url https://app.solya.app/api/data-platform/sandbox-promote-runs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "allowWithErrors": false,
  "organizationId": "org-uuid-1234",
  "sandboxIngestRunId": "run-uuid-si-7f3a2b",
  "triggerType": "API"
}
'
{
  "id": "run-uuid-sp-4e8c9d",
  "status": "PENDING",
  "triggeredAt": "2026-05-23T09:05:00.000Z"
}

Authorizations

​
Authorization
string
header
required

Static internal-ops token used by the data platform and internal cron jobs (e.g. zombie-run sweep). Validated via requireBearerToken inside the handler against a service-specific environment variable.

Body

application/json
​
organizationId
string
required

Organization UUID that owns this run

Minimum string length: 1
​
sandboxIngestRunId
string
required

UUID of the sandbox ingest run whose data should be promoted

Minimum string length: 1
​
triggerType
enum<string>
required

What initiated the promotion: MANUAL (user) or API (external caller)

Available options:
MANUAL,
API
​
allowWithErrors
boolean
default:false

When true, promote even if the ingest run had ERROR-severity findings

​
targetLandingPath
string

Override the landing path for the promoted file; omit to use the default derived from the ingest run

Response

Successful response

​
data
object
required
​
success
enum<boolean>
required
Available options:
true