Update Test - nunu.ai

curl -X PATCH "https://nunu.ai/api/v1/project/your-project-id/tests/a5060a07-d386-4269-98ce-b33fb894201e" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_version": 4,
    "patch": { "name": "Sanity smoke v2", "tags": ["smoke", "regression"] }
  }'

curl -X PATCH "https://nunu.ai/api/v1/project/your-project-id/tests/a5060a07-d386-4269-98ce-b33fb894201e" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_version": 4,
    "patch": {},
    "folder_path": "regression/full"
  }'

curl -X PATCH "https://nunu.ai/api/v1/project/your-project-id/tests/a5060a07-d386-4269-98ce-b33fb894201e" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_version": 4,
    "patch": { "max_seconds": 14400 }
  }'

{
  "id": "a5060a07-d386-4269-98ce-b33fb894201e",
  "project_id": "test",
  "name": "Sanity smoke v2",
  "version": 5,
  "tags": ["smoke", "regression"],
  "test_type": "verification",
  "...": "..."
}

{
  "error": "version conflict",
  "expected_version": 4,
  "latest_version": 5
}

PATCH

project

{projectId}

tests

{testId}

curl -X PATCH "https://nunu.ai/api/v1/project/your-project-id/tests/a5060a07-d386-4269-98ce-b33fb894201e" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_version": 4,
    "patch": { "name": "Sanity smoke v2", "tags": ["smoke", "regression"] }
  }'

curl -X PATCH "https://nunu.ai/api/v1/project/your-project-id/tests/a5060a07-d386-4269-98ce-b33fb894201e" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_version": 4,
    "patch": {},
    "folder_path": "regression/full"
  }'

curl -X PATCH "https://nunu.ai/api/v1/project/your-project-id/tests/a5060a07-d386-4269-98ce-b33fb894201e" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_version": 4,
    "patch": { "max_seconds": 14400 }
  }'

{
  "id": "a5060a07-d386-4269-98ce-b33fb894201e",
  "project_id": "test",
  "name": "Sanity smoke v2",
  "version": 5,
  "tags": ["smoke", "regression"],
  "test_type": "verification",
  "...": "..."
}

{
  "error": "version conflict",
  "expected_version": 4,
  "latest_version": 5
}

Permission Required: project:edit-tests

Apply a partial update to a test case. Updates are protected by an optimistic version check — supply the version you fetched from Get Test as expected_version. If the test has been modified since, the update fails with a 409 Conflict and the latest version is returned so the caller can rebase. The patch field is deep-merged into the current test body. To replace a list (e.g. tags or player_order), include the full new list — arrays are replaced, not merged.

Path Parameters

testId

string

required

The test ID (UUID)

Query Parameters

include_shared_collection_steps

boolean

default:"true"

Whether shared collection steps are expanded inline in the response.

Request Body

expected_version

integer

required

The version returned by the most recent Get Test. Must be a non-negative integer.

patch

object

required

Partial test body. Object fields are deep-merged; arrays are replaced wholesale. Cannot change the test id.

shared_collection_steps_mode

string

default:"error"

How to handle shared collection items that contain inline steps in the patch: error (reject) or drop (silently strip the inline steps).

folder_path

string

New folder placement. null or "/" moves the test to the project root. Mutually exclusive with folder_id. Omit both fields to leave folder unchanged.

folder_id

string

Pre-resolved folder UUID. Mutually exclusive with folder_path.

Patching the time budget

Time budgets live at the test level (min_seconds / max_seconds on the test body) — see Create Test for the per-framework rules. Patches accept the same fields with the same constraints:

verification: only max_seconds is allowed; sending min_seconds is rejected with 400.
discovery / task: either bound (or both) may be patched. The merged result must satisfy min_seconds <= max_seconds; e.g. patching only min_seconds to a value above the current max_seconds is rejected.

Response

Returns the updated test (same shape as Get Test) on success. On version conflict, returns 409 with:

{
  "error": "version conflict",
  "expected_version": 3,
  "latest_version": 5
}

curl -X PATCH "https://nunu.ai/api/v1/project/your-project-id/tests/a5060a07-d386-4269-98ce-b33fb894201e" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_version": 4,
    "patch": { "name": "Sanity smoke v2", "tags": ["smoke", "regression"] }
  }'

curl -X PATCH "https://nunu.ai/api/v1/project/your-project-id/tests/a5060a07-d386-4269-98ce-b33fb894201e" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_version": 4,
    "patch": {},
    "folder_path": "regression/full"
  }'

curl -X PATCH "https://nunu.ai/api/v1/project/your-project-id/tests/a5060a07-d386-4269-98ce-b33fb894201e" \
  -H "X-Api-Key: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "expected_version": 4,
    "patch": { "max_seconds": 14400 }
  }'

{
  "id": "a5060a07-d386-4269-98ce-b33fb894201e",
  "project_id": "test",
  "name": "Sanity smoke v2",
  "version": 5,
  "tags": ["smoke", "regression"],
  "test_type": "verification",
  "...": "..."
}

{
  "error": "version conflict",
  "expected_version": 4,
  "latest_version": 5
}

Authorizations

X-Api-Key

string

header

required

API key for authentication

Path Parameters

testId

string<uuid>

required

The test ID (UUID)

projectId

string

required

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

Query Parameters

include_shared_collection_steps

boolean

default:true

Whether shared collection steps are expanded inline

Body

application/json

expected_version

integer

required

Version returned by the most recent Get Test.

Required range: x >= 0

patch

object

required

Partial test body. Object fields are deep-merged; arrays are replaced wholesale.

shared_collection_steps_mode

enum<string>

default:error

Available options:

error,

drop

folder_path

string | null

folder_id

string<uuid>

Response

Test updated

Full test case body. Shape varies by test_type (verification, discovery, task); see the docs page for the exact shape.

string<uuid>

project_id

string

name

string

version

integer

​Path Parameters

​Query Parameters

​Request Body

​Patching the time budget

​Response

Authorizations

Path Parameters

Query Parameters

Body

Response

Path Parameters

Query Parameters

Request Body

Patching the time budget

Response