TOtower

Run app

Changed on

Runs an app with the supplied parameters.

post/apps/{name}/runs

Request

Path parameters

namestring required

The name of the app to fetch runs for.

Request body

$schemastring uri

A URL to the JSON Schema for this object.

environmentstring required

The environment to run this app in.

parametersobject required

The parameters to pass into this app.

parent_run_idstring nullable

The ID of the run that invoked this run, if relevant. Should be null, if none.

run_size'basic.xsmall' | 'basic.small' | 'basic.medium' | 'basic.large'

Compute size for managed runners. Defaults to the app version's run size (basic.medium if the version declares none). Accepted without effect for self-hosted runners.

Example request

{
  "$schema": "https://api.tower.dev/v1/schemas/RunAppParams.json"
}

Response

Created

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://api.tower.dev/v1/schemas/RunAppResponse.json"
}

Changes

  • d4eb8af936b9Revision changes
    • info

      the request property default value basic.medium was removed

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

  • 40c3fdc951e3Revision changes
    • info

      added the required property / to the response with the status