Quick Run Test Plan

This endpoint triggers a "fast run" for a specific test plan, allowing the execution of selected scenarios in specific environments. The user must have the PLAN_RUN authority to access this endpoint.


Endpoint Information


Request Body

The request body specifies the test plan (planId) to be executed by a given user (userId). It also contains a list of scenarioEnvironmentPairs, where each pair defines a specific scenario and the environment in which it should run.

{
  "planId": 12345,
  "userId": 67890,
  "scenarioEnvironmentPairs": [
    {
      "scenarioId": 111,
      "environmentId": 222
    },
    {
      "scenarioId": 333,
      "environmentId": 444
    }
  ]
}

Request Fields

Field
Type
Description

planId

Long

The ID of the test plan to execute.

userId

Long

The ID of the user who triggers plan.

scenarioId

Long

The ID of the scenario to execute.

environmentId

List

The ID of the environment where the scenario will be executed.


Response

This response indicates that the operation was completed successfully, with no additional data returned.

{
    "data": null,
    "result": {
        "code": 0,
        "message": "success"
    }
}

Response Fields

Field
Type
Description

data

Object

The payload of the response. In this case null since no extra data is returned.

result

Object

Contains details about the outcome of the operation.

result.code

Integer

The result code (e.g., 0 indicates success).

result.message

String

A message describing the outcome (e.g., "success").


Error Codes

HTTP Code
Error Message
Description

400

INVALID_REQUEST

The request was malformed or contained errors.

500

INTERNAL_SERVER_ERROR

An unexpected error occurred on the server side.


Application Error Codes

Code
Error Message
10000
"Plan not found!"
10002
User not found!

Example Request

curl 'https://gateway.testinium.io/queue/quickRun' \
  -H 'accept: application/json, text/plain, */*' \
  -H 'authorization: Bearer <token>' \
  -H 'content-type: application/json' \
  --data-raw '{"planId":<planId>,"userId":<userId>,"scenarioEnvironmentPairs":[{"scenarioId":<scenarioId>,"environmentId":<environmentId>},{"scenarioId":<scenarioId>,"environmentId":<environmentId>}]}' 

Last updated