Create a workflow run

Authorization

Send a personal access token with every request.

• Authorization: Bearer PAT

Path parameters

• projectIdstringrequired
• versionNumbernumberrequired

Header parameters

• Idempotency-Keystring

  Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.

Request body

• revisionRefstring

  `global:<id>` or `tenant:<id>`; absent: the project's curate binding.

Responses

{
  "data": {
    "runId": "string",
    "status": "string",
    "projectVersionId": "string"
  }
}