Create a test | TesterArmy: Documentation

curl -X POST https://tester.army/api/v1/tests \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "title": "string",
  "steps": [
    {
      "title": "string",
      "type": "act"
    }
  ],
  "projectId": "string"
}'

{
  "test": {
    "id": "string",
    "title": "string",
    "steps": [
      {
        "title": "string",
        "type": "act",
        "disabled": true
      }
    ],
    "description": "string",
    "enabled": true,
    "platform": "web",
    "settings": {
      "executionMode": "fast",
      "browserRegion": "eu",
      "simulatorRegion": "eu-north1",
      "viewport": "desktop",
      "webSearchEnabled": true,
      "prepGroupId": "string"
    },
    "projectId": "string",
    "projectUrl": "string",
    "projectName": "string",
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-01-15T09:30:00Z"
  }
}

Create a structured test definition for a project.

Authentication

AuthorizationBearer

API key authentication using Bearer token format

Request

This endpoint expects an object.

titlestringRequired1-500 characters

stepslist of objectsRequired

projectIdstringRequired

descriptionstringOptional

groupIdstring or nullOptionalformat: "uuid"

platformenumOptional

Allowed values:

settingsobjectOptional

enabledbooleanOptional

Response

Test created

testobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

504

Gateway Timeout Error