Create Test Plan

curl -X POST "https://nunu.ai/api/v1/project/your-project-id/test-plans" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "test_plan": {
      "name": "Nightly Smoke",
      "test_items": [
        { "multiplayer_test_id": "a5060a07-d386-4269-98ce-b33fb894201e", "retries": 1 },
        { "multiplayer_test_id": "b1234567-89ab-cdef-0123-456789abcdef" }
      ]
    }
  }'

{
  "id": "b3f1a2c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
  "project_id": "test",
  "name": "Nightly Smoke",
  "created_at": null,
  "created_by": null,
  "modified_at": null,
  "modified_by": null,
  "test_items": [
    { "multiplayer_test_id": "a5060a07-d386-4269-98ce-b33fb894201e", "retries": 1 },
    { "multiplayer_test_id": "b1234567-89ab-cdef-0123-456789abcdef", "retries": 0 }
  ]
}

POST

project

{projectId}

test-plans

curl -X POST "https://nunu.ai/api/v1/project/your-project-id/test-plans" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "test_plan": {
      "name": "Nightly Smoke",
      "test_items": [
        { "multiplayer_test_id": "a5060a07-d386-4269-98ce-b33fb894201e", "retries": 1 },
        { "multiplayer_test_id": "b1234567-89ab-cdef-0123-456789abcdef" }
      ]
    }
  }'

{
  "id": "b3f1a2c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
  "project_id": "test",
  "name": "Nightly Smoke",
  "created_at": null,
  "created_by": null,
  "modified_at": null,
  "modified_by": null,
  "test_items": [
    { "multiplayer_test_id": "a5060a07-d386-4269-98ce-b33fb894201e", "retries": 1 },
    { "multiplayer_test_id": "b1234567-89ab-cdef-0123-456789abcdef", "retries": 0 }
  ]
}

Permission Required: project:edit-tests

Create a new test plan for your project. A test plan is an ordered list of test items that can be executed together with Start Test Plan Run.

Cross-platform deployment slots (slots, default_slot_name) are read-only via the API and cannot be supplied here or via Update Test Plan; manage them in the test plan editor. Unknown fields are rejected with a 400 error.

Request Body

test_plan

object

required

Test plan definition

Show test_plan properties

test_plan.id

string

Optional UUID. If omitted, one is generated.

test_plan.name

string

required

Test plan name

test_plan.test_items

TestPlanTestItem[]

required

Ordered list of tests in this plan

Show test_item properties

multiplayer_test_id

string

required

Test UUID to include in the plan

retries

integer

default:"0"

Per-item retry count (0 or higher)

Response

Returns the newly created test plan with status 201. The shape matches Get Test Plan.

curl -X POST "https://nunu.ai/api/v1/project/your-project-id/test-plans" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "test_plan": {
      "name": "Nightly Smoke",
      "test_items": [
        { "multiplayer_test_id": "a5060a07-d386-4269-98ce-b33fb894201e", "retries": 1 },
        { "multiplayer_test_id": "b1234567-89ab-cdef-0123-456789abcdef" }
      ]
    }
  }'

{
  "id": "b3f1a2c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
  "project_id": "test",
  "name": "Nightly Smoke",
  "created_at": null,
  "created_by": null,
  "modified_at": null,
  "modified_by": null,
  "test_items": [
    { "multiplayer_test_id": "a5060a07-d386-4269-98ce-b33fb894201e", "retries": 1 },
    { "multiplayer_test_id": "b1234567-89ab-cdef-0123-456789abcdef", "retries": 0 }
  ]
}

Authorizations

X-Api-Key

string

header

required

API key for authentication

Path Parameters

projectId

string

required

The project ID. You can copy it from the project settings page or the project URL in the dashboard.

Body

application/json

test_plan

object

required

Show child attributes

Response

Test plan created

string<uuid>

Unique identifier for the test plan

project_id

string<uuid>

Project the test plan belongs to

name

string

Test plan name

created_at

string<date-time> | null

created_by

string | null

modified_at

string<date-time> | null

modified_by

string | null

slots

object[]

Extra deployment slots of a cross-platform test plan (read-only via the API; managed in the test plan editor). Their indices key slot_deployment_configs when starting the plan; slot 1 is the implicit default slot.

Show child attributes

default_slot_name

string | null

Optional display name of the implicit default slot (slot 1). Read-only via the API.

test_items

object[]

Ordered list of tests in this plan

Show child attributes

Get Test Plan Update Test Plan

​Request Body

​Response

Authorizations

Path Parameters

Body

Response

Request Body

Response