Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Testiny Test Runs API

Executions of test cases with recorded results.

Testiny Test Runs API is one of 5 APIs that Testiny publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Test Runs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 12 operations across 7 paths, and defines 6 schemas. It is described by OpenAPI 3.0.4, at version 1.38.0.

Requests are made against a single base URL, https://app.testiny.io/api/v1.

12 operations 7 paths 6 schemas 2 DELETE3 GET5 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.4
API Version
1.38.0
Base URL
https://app.testiny.io/api/v1
Authentication
API Key
Contact
Resource Areas
1

Authentication & Security 1

Testiny Test Runs API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Api-Key (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — API key created in Testiny (Account settings / organization) with fine-grained permissions. Passed as the X-Api-Key request header. Treat the API key like a pa…

Paths & Operations 12

Across 7 paths, the API surfaces 12 operations — 2 DELETE, 3 GET, 5 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Test Runs 12

Executions of test cases with recorded results.

GET
/testrun
List test runs
listTestRuns → 200401
POST
/testrun
Create a test run
createTestRun body → 200401
POST
/testrun/find
Find test runs
findTestRuns body → 200
POST
/testrun/bulk
Bulk create test runs
bulkCreateTestRuns → 200
PUT
/testrun/bulk
Bulk update test runs
bulkUpdateTestRuns → 200
DELETE
/testrun/bulk
Bulk delete test runs
bulkDeleteTestRuns → 200
GET
/testrun/{id}
Get a test run
getTestRun 1 param → 200404
PUT
/testrun/{id}
Update a test run
updateTestRun 1 param body → 200
DELETE
/testrun/{id}
Delete a test run
deleteTestRun 1 param → 200
POST
/testrun/mapping/bulk/{otherEntities}
Record results by mapping test cases to a run
mapTestRun 2 params body → 200
POST
/testrun/upload-attachment/{trId}/{tcId}
Upload an attachment to a test case result in a run
uploadTestRunResultAttachment 2 params body → 200
GET
/export/testrun/csv
Export test runs as CSV
exportTestRunsCsv → 200

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are DataReadParams (5 properties), TestRunInput (4 properties), EntityList (2 properties), Entity (2 properties). Each schema is shown below with its type and property counts.

DataReadParams
object
Query parameters for find endpoints - filtering, ordering, paging, and nested mappings. Computed columns are prefixed with $.
5 properties
Entity
object
A generic Testiny entity envelope. Concrete fields vary by entity type.
2 properties
TestRunInput
object
4 properties 2 required
EntityList
object
2 properties
Error
object
1 property
ResultMappingRequest
object
Bulk testcase:testrun mapping payload used to record per-case results in a run.
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

testiny-test-runs-api-openapi.yml Raw ↑

Other APIs Testiny publishes across the network.

Testiny Automation API
Testiny Projects API
Testiny Test Cases API
Testiny Test Plans API