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
}
Update Test
Apply a partial update to a test case. Uses optimistic concurrency control via expected_version.
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
}
project:edit-testsversion 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
Query Parameters
Request Body
id.error (reject) or drop (silently strip the inline steps).null or "/" moves the test to the project root.
Mutually exclusive with folder_id. Omit both fields to leave folder unchanged.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: onlymax_secondsis allowed; sendingmin_secondsis rejected with400.discovery/task: either bound (or both) may be patched. The merged result must satisfymin_seconds <= max_seconds; e.g. patching onlymin_secondsto a value above the currentmax_secondsis rejected.
Response
Returns the updated test (same shape as Get Test) on success. On version conflict, returns409 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
API key for authentication
Path Parameters
The test ID (UUID)
The project ID. You can copy it from the project settings page or the project URL in the dashboard.
Query Parameters
Whether shared collection steps are expanded inline
Body
Version returned by the most recent Get Test.
x >= 0Partial test body. Object fields are deep-merged; arrays are replaced wholesale.
error, drop Response
Test updated
Full test case body. Shape varies by test_type (verification, discovery, task); see the docs page for the exact shape.
verification, discovery, task repository, bot Test-level minimum runtime in seconds. Allowed for discovery and task only; sending this on a verification test is rejected with 400. Defaults when omitted: discovery=3600 (1h), task=0. Must be ≤ max_seconds (validated against the effective budget after defaults are applied).
0 <= x <= 19800Test-level maximum runtime in seconds. Hard ceiling for any single run is 19800 (5.5h). Defaults when omitted: verification=19800 (5.5h), discovery=10800 (3h), task=19800 (5.5h).
0 <= x <= 19800Test-level memory override. null or omitted means "auto" — inherit the project's default memory setting. disabled turns memory off for this test; read_write lets the agent read and write memory files across runs. Requires the project's knowledge feature to be enabled. Applies to all test types. On read it is always present (null = auto); on a patch, omit it to leave it unchanged.
disabled, read_only, read_write