Execute ValidateHardwareWorkflow

POST

///v1/workflow/ngc/cumulus_hardware_validation

Validate hardware components (fans, PSUs, LEDs, voltage) across network devices

Authentication

AuthorizationBearer

Bearer JWT used by CLI and machine clients on svc-* endpoints. Authentication is required by default, but deployments may disable it with [auth] required = false. Browser OIDC sessions, mTLS, SPIFFE identities, and trusted gateway identity headers may also satisfy authentication outside this generated client flow.

Request

This endpoint expects an object.

sitestringRequired

Site used to select network devices for validation.

tenantstringRequired

Tenant used to filter the selected network devices.

device_type_idslist of stringsOptionalDefaults to []

Device type identifiers used to filter network devices.

raise_for_invalidbooleanOptionalDefaults to false

Whether invalid hardware should fail the workflow.

roleslist of stringsOptionalDefaults to []

Device roles used to filter the selected network devices.

statuslist of stringsOptionalDefaults to []

Device statuses used to filter the selected network devices.

Response

Successful Response

hrefstringRead-only

Calculate URL to Temporal UI Workflow View.

idstring

Errors

422

Unprocessable Entity Error

$	curl -X POST /v1/workflow/ngc/cumulus_hardware_validation \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"site": "datacenter-west-01",
>	"tenant": "enterprise-network"
>	}'