Skip to main content
POST
/
test-plans
curl -X POST "https://nunu.ai/api/v1/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 }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://api-docs.nunu.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.

Request Body

test_plan
object
required
Test plan definition

Response

Returns the newly created test plan with status 201. The shape matches Get Test Plan.
curl -X POST "https://nunu.ai/api/v1/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

Body

application/json
test_plan
object
required

Response

Test plan created

id
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
test_items
object[]

Ordered list of tests in this plan