Create an on-demand Machine validation run

POST

https://nico-rest-api.nico.svc.cluster.local/v2/org/:org/nico/machine/:machineId/validation/run

POST

/v2/org/:org/nico/machine/:machineId/validation/run

$ curl -X POST https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/machine/machineId/validation/run \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "tags": [
>     "dgxcloud"
>   ],
>   "allowedTests": [
>     "forge_DcgmFullLong"
>   ],
>   "runUnverifiedTests": false,
>   "contexts": [
>     "OnDemand"
>   ]
> }'

1 {
2   "validationID": "20000000-0000-0000-0000-000000000001",
3   "machineID": "fm100htes3rn1npvbtm5qd57dkilaag7ljugl1llmm7rfuq1ov50i0rpl30",
4   "startTime": "2026-08-03T20:00:00Z",
5   "endTime": null,
6   "name": "Test_fm100htes3rn1npvbtm5qd57dkilaag7ljugl1llmm7rfuq1ov50i0rpl30",
7   "context": "OnDemand",
8   "status": {
9     "state": "InProgress",
10     "total": 1,
11     "completed": 0
12   },
13   "durationToCompleteSecs": 7200
14 }

Create an on-demand Machine validation run. The Machine must be in a state accepted by NICo Core.

Org must have an Infrastructure Provider entity and own the Site that the Machine belongs to. User must have authorization role with PROVIDER_ADMIN suffix.

Authentication

AuthorizationBearer

export JWT_BEARER_TOKEN="<jwt-bearer-token>"
# Example org name: "acme-inc
export ORG_NAME=<org-name>
# Use the JWT bearer token in your API request auth header:
curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current

``` export JWT_BEARER_TOKEN="<jwt-bearer-token>" # Example org name: "acme-inc export ORG_NAME=<org-name> # Use the JWT bearer token in your API request auth header: curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current ```

Path parameters

orgstringRequired

Name of the Org

machineIdstringRequired

ID of the Machine

Request

This endpoint expects an object.

tagslist of stringsOptional

Tags used to select validation tests.

allowedTestslist of stringsOptional

Validation test names allowed for this run.

runUnverifiedTestsbooleanOptionalDefaults to false

Whether unverified validation tests may run.

contextslist of stringsOptional

Contexts used to select validation tests.

Response

On-demand Machine validation request was accepted

validationIDstring

ID of the Machine validation run.

machineIDstring

ID of the validated Machine.

startTimedatetime

Time the validation run started.

endTimedatetime or null

Time the validation run completed, or null while it is active.

namestring

Name of the validation run.

contextstring

Context in which the validation run was created.

statusobject

Progress and outcome of a Machine validation run

durationToCompleteSecsinteger

Estimated maximum duration of the validation run in seconds. A value of zero can mean the estimate has not yet been calculated.

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error