Sign in

v46

latestOpenAPI 3.0.0MITraw.githubusercontent.com2026-08-0311978417.1 KB
Apps

Create an app run

Create and execute a run for an app in the space specified by {spaceId}.

post/api/v1/w/{wId}/spaces/{spaceId}/apps/{aId}/runs

Path parameters

wIdstring required

Unique string identifier for the workspace

spaceIdstring required

ID of the space

aIdstring required

Unique identifier of the app

Request body

specification_hashstring required

Hash of the app specification. Ensures API compatibility across app iterations.

inputsobject[] required

Array of input objects for the app

streamboolean

If true, the response will be streamed

blockingboolean

If true, the request will block until the run is complete

block_filterstring[]

Array of block names to filter the response

Response

App run created and executed successfully

Example response

{
  "run": {
    "run_id": "4a2c6e8b0d",
    "app_id": "9f1d3b5a7c",
    "status": {
      "run": "succeeded",
      "build": "succeeded"
    },
    "results": {},
    "specification_hash": "8c0a4e6d2f",
    "traces": [
      [
        {
          "timestamp": 1234567890,
          "trace": {}
        }
      ]
    ]
  }
}