> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nearnode.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Node

> Update a node's label, payload, or status.

### Path Parameters

<ParamField path="slug" type="string" required>
  The node's unique slug.
</ParamField>

### Body

<ParamField body="label" type="string">
  Update the internal display name.
</ParamField>

<ParamField body="function_type" type="string">
  Change the payload type. One of `redirect`, `vcard`, `wifi`, `microsite`, `digital_card`, `action`.
</ParamField>

<ParamField body="payload" type="object">
  Update the type-specific payload configuration. Merges with the existing payload — send only the fields you want to change.
</ParamField>

<ParamField body="status" type="string">
  Update lifecycle status. One of `active`, `paused`, `retired`.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH https://nearnode.io/api/v1/nodes/k9m2xp4q \
    -H "Authorization: Bearer sk_live_..." \
    -H "Content-Type: application/json" \
    -d '{
      "label": "Updated Office Door",
      "payload": {
        "url": "https://acme.com/new-destination"
      }
    }'
  ```

  ```javascript Node.js theme={null}
  await fetch('https://nearnode.io/api/v1/nodes/k9m2xp4q', {
    method: 'PATCH',
    headers: {
      'Authorization': 'Bearer sk_live_...',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      label: 'Updated Office Door',
      payload: {
        url: 'https://acme.com/new-destination',
      },
    }),
  });
  ```

  ```python Python theme={null}
  import requests

  requests.patch(
      "https://nearnode.io/api/v1/nodes/k9m2xp4q",
      headers={"Authorization": "Bearer sk_live_..."},
      json={
          "label": "Updated Office Door",
          "payload": {
              "url": "https://acme.com/new-destination",
          },
      },
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "id": "node_abc123...",
      "slug": "k9m2xp4q",
      "label": "Updated Office Door",
      "url": "https://nearnode.io/v/k9m2xp4q",
      "function_type": "redirect",
      "payload": {
        "url": "https://acme.com/new-destination"
      },
      "status": "active"
    }
  }
  ```
</ResponseExample>