Skip to main content
POST
/
v1
/
runs
POST /api/v1/runs
curl --request POST \
  --url https://api.magica.com/api/v1/runs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
Use this endpoint to start a full workflow run. The response returns a runId; poll GET /v1/runs/{runId} for status and node outputs. 
curl -X POST https://api.magica.com/api/v1/runs \
  -H "Authorization: Bearer $MAGICA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflowId": "workflow-or-system-slug",
    "values": {
      "request-node-id": {
        "prompt": "Create a product hero image"
      }
    }
  }'

Authorizations

​
Authorization
string
header
required

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

Body

application/json

StartRunInputSchema

Response

202

Accepted