Skip to main content
POST
/
api
/
v1
/
execution
/
api
/
execute_workflow_id_async
Execute Workflow Id Async
curl --request POST \
  --url https://backend.revyl.ai/api/v1/execution/api/execute_workflow_id_async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workflow_id": "<string>",
  "run_config": {
    "llm_config": {
      "primary_model": "gemini/gemini-3-flash-preview",
      "reflection_model": "gemini/gemini-3-flash-preview",
      "planning_model": "gemini/gemini-3-flash-preview"
    },
    "execution_mode": {
      "human_in_the_loop": false,
      "enable_reflection": true,
      "enable_planning": false,
      "retries": 1,
      "reflection_retries": 1,
      "skip_app_install": false,
      "grounder_type": "moondream3"
    },
    "run_id": "<string>",
    "cache_retry_mode": "full_rerun",
    "fallback_trigger": "final_fail",
    "disable_grid": true
  },
  "build_config": {
    "ios_build": {
      "app_id": "<string>",
      "pinned_version": "<string>"
    },
    "android_build": {
      "app_id": "<string>",
      "pinned_version": "<string>"
    }
  },
  "override_build_config": false
}
'
{
  "status": "initialized",
  "message": "<string>",
  "id": "<string>",
  "task_id": "<string>"
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
X-Revyl-Client
string | null
​
X-CI-System
string | null
​
X-CI-Commit-SHA
string | null
​
X-CI-Branch
string | null
​
X-CI-PR-Number
integer | null
​
X-CI-Run-URL
string | null
​
X-CI-Run-ID
string | null
​
X-CI-Repository
string | null

Body

application/json

Request model for triggering workflow execution.

Attributes: workflow_id: UUID of the workflow to execute. run_config: Optional run configuration override for workflow-triggered tests. build_config: Optional build configuration override for this execution. override_build_config: When True with build_config, overrides test builds.

​
workflow_id
string
required
​
run_config
TestRunConfig · object

Complete configuration for a test run.

​
build_config
WorkflowAppConfig · object

Build configuration override for this workflow execution

​
override_build_config
boolean
default:false

When True, build_config overrides individual test build configurations

Response

Successful Response

Response for async workflow execution start.

​
status
enum<string>
required
Available options:
initialized,
failed,
queued,
running,
completed,
cancelled,
initializing
​
message
string
required
​
id
string
required

Execution ID

​
task_id
string
required

Alias for id, for backwards compatibility with older clients.