---
title: "Update pending node status"
method: POST
path: "/nodes/pending/{nodeId}"
tags: ["Nodes"]
---

# Update pending node status

`POST /nodes/pending/{nodeId}`

Accept or refuse a pending node

## Path parameters

- `nodeId` string, uuid (or "root"), required

## Request body

- object
  - `status` 'accepted' | 'refused' — New status of the pending node

## Response `200`

Nodes

- object
  - `result` 'success' | 'error', required — Result of the request
  - `action` 'changePendingNodeStatus', required — The id of the action
  - `data` object, required — Information about the node
    - `nodes` NodePendingResult[], required
      - `id` string, uuid (or "root"), required — Unique id of the node
      - `hostname` string, required — Fully qualified name of the node
      - `status` 'pending' | 'accepted' | 'deleted', required — Status of the node
      - `osName` string — Operating system name (distribution on Linux, etc.)
      - `osVersion` string — OS version
      - `machineType` 'physical' | 'vm' | 'hyperv' | 'qemu' | 'vbox' | 'vmware' | 'xen' — The kind of machine for the node (use vm for a generic VM)

---

[API](https://skmtc.net/rudder/apis/rudder-api.md) · [All operations](https://skmtc.net/rudder/apis/rudder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rudder/rudder-api/revisions/eab988254fba/schema)