Skip to main content

List per-node failures for a registration job

GET 
/v1/admin/nodes/registration-jobs/:requestId/failed-nodes

Paginated list of per-node failure detail (node_id, code, reason, recorded_at) for the given registration job. Use this when the job's aggregate failed_count is non-zero and you need to know which nodes failed and why.

Returns 200 with failed_nodes: [] when the job exists but has zero failures; returns 404 when the job doesn't exist or belongs to a different flow.

Failures are written in a single batch at end-of-job, so polling this endpoint mid-run returns an empty list. The accompanying job status's status=completed indicates the failure detail is final.

Request​

Responses​

Page of failed-node rows