Skip to main content
POST
Search runs

Authorizations

Authorization
string
header
required

Voiceflow bearer token

Query Parameters

projectID
string
required

The ID of the project to operate on.

environmentAlias
string
required

The alias of the environment to operate on (e.g. main).

Body

application/json
take
number
default:20

The maximum number of results to return, used for pagination.

Required range: 1 <= x <= 100
skip
integer
default:0

The number of results to skip, used for pagination.

Required range: 0 <= x <= 9007199254740991
testID
string

Restrict results to runs of this test. Omit to search across all tests.

Response

200 - application/json

Returns the runs matching the search body, each carrying the testID it belongs to, its status, its check tallies, and the credits it consumed. Set testID in the body to narrow to one test's history, or omit it to search every test in the environment.

runs
object[]
required