Skip to main content
POST
/
v1
/
apps
/
{appId}
/
runs
Start a run
curl --request POST \
  --url https://apis.tryflowy.ai/genstudio-svc-v2/api/v1/apps/{appId}/runs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": {
    "node_1": "https://example.com/me.jpg",
    "node_2": "studio lighting, neutral background"
  }
}
'
{
  "data": {
    "runId": "64c3f2a1e8b9c0d1f2e3a4b5",
    "status": "queued"
  }
}
The run starts asynchronously and returns a runId immediately. Poll Get a run until its status is completed or failed.

Authorizations

​
Authorization
string
header
required

A workspace API key. Secret keys (flowy_…) are server-side — keep them private. Publishable keys (flowy_pk_…) are browser-safe but only work from their allowlisted domains.

Path Parameters

​
appId
string
required

Body

application/json
​
inputs
object

Map of input nodeId -> value (text, or a URL for media inputs). Get the keys from GET /v1/apps/{appId}.

Response

Run accepted. Poll GET /v1/runs/{runId}.

​
data
object