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

# Update a node access rule with the Chainstack Platform API v2

> Change the value of a node access rule, or activate or deactivate the rule, using the Chainstack Platform API v2. Send a PATCH request to /v2/nodes/{node_id}/access-rules/{id}/.



## OpenAPI

````yaml patch /v2/nodes/{node_id}/access-rules/{id}/
openapi: 3.0.3
info:
  x-logo:
    url: https://chainstack.com/assets/docs/api-docs-logo.svg
    backgroundColor: '#F5F8FC'
    altText: Chainstack
  title: 💙 CHAINSTACK PLATFORM API
  version: v2
  contact:
    name: API Support
    email: support@chainstack.com
  description: >
    A set of API endpoints to operate and manage the platform resources.<br>

    See also a [quick API
    tutorial](https://docs.chainstack.com/reference/quick-tutorial).
servers:
  - url: https://api.chainstack.com
    description: API endpoint
security: []
paths:
  /v2/nodes/{node_id}/access-rules/{id}/:
    parameters:
      - $ref: '#/components/parameters/NodeIdPath'
      - $ref: '#/components/parameters/Id'
    patch:
      tags:
        - Node access rules V2
      summary: Update node access rule
      description: >
        Change an access rule's value, activate it, or deactivate it. The rule's
        `type` can't be changed — create a new rule instead.
      operationId: updateNodeAccessRuleV2
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NodeAccessRuleUpdateV2'
            examples:
              activate:
                summary: Activate a rule
                value:
                  status: activated
              value:
                summary: Change the allowed IP address
                value:
                  value: 198.51.100.24
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NodeAccessRuleV2'
              examples:
                rule:
                  value:
                    id: NAR-123-456-789
                    node_id: ND-123-456-789
                    type: ip
                    value: 203.0.113.10
                    status: activated
                    created_at: '2026-10-01T09:30:00.000000Z'
                    updated_at: '2026-10-01T09:45:00.000000Z'
          description: ''
        '400':
          $ref: '#/components/responses/ValidationError'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          $ref: '#/components/responses/ForbiddenError'
        '404':
          $ref: '#/components/responses/NotFoundError'
      security:
        - APIKeyAuthentication: []
components:
  parameters:
    NodeIdPath:
      name: node_id
      in: path
      required: true
      description: ID of the node.
      schema:
        type: string
        example: ND-123-456-789
    Id:
      name: id
      in: path
      required: true
      description: A unique value identifying the Object.
      schema:
        type: string
  schemas:
    NodeAccessRuleUpdateV2:
      type: object
      properties:
        value:
          type: string
          description: >-
            The new value, in the format the rule's type requires — see `value`
            in [Create node access
            rule](/reference/chainstack-platform-api-v2-create-node-access-rule).
        status:
          type: string
          enum:
            - activated
            - deactivated
          description: Activate or deactivate the rule.
    NodeAccessRuleV2:
      type: object
      properties:
        id:
          type: string
          readOnly: true
          description: ID of the access rule.
          example: NAR-123-456-789
        node_id:
          type: string
          readOnly: true
          description: ID of the node the rule belongs to.
          example: ND-123-456-789
        type:
          type: string
          readOnly: true
          enum:
            - ip
            - origin
          description: >
            Rule type:

            * `ip` — allow requests from an IP address.

            * `origin` — allow requests whose HTTP `Origin` header matches the
            value.
        value:
          type: string
          readOnly: true
          description: The allowed IP address or origin.
          example: 203.0.113.10
        status:
          type: string
          readOnly: true
          enum:
            - activated
            - deactivated
          description: Whether the rule is enforced. New rules start as `deactivated`.
        created_at:
          type: string
          format: date-time
          readOnly: true
          description: When the rule was created.
        updated_at:
          type: string
          format: date-time
          readOnly: true
          description: When the rule was last changed.
  responses:
    ValidationError:
      description: Validation error.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  code:
                    type: string
                    description: A string indicating the kind of error.
                  message:
                    type: string
                    description: A human-readable description of the error.
                  fields:
                    type: object
                    additionalProperties:
                      type: array
                      items:
                        type: string
                    description: Optional. Field-level validation errors.
    UnauthorizedError:
      description: Authentication credentials were missing or incorrect.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  code:
                    type: string
                    description: A string indicating the kind of error.
                  message:
                    type: string
                    description: A human-readable description of the error.
    ForbiddenError:
      description: The request is not allowed with the current permissions.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  code:
                    type: string
                    description: A string indicating the kind of error.
                  message:
                    type: string
                    description: A human-readable description of the error.
    NotFoundError:
      description: >-
        Object does not exist or caller has insufficient permissions to access
        it.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  code:
                    type: string
                    description: A string indicating the kind of error.
                  message:
                    type: string
                    description: A human-readable description of the error.
  securitySchemes:
    APIKeyAuthentication:
      type: http
      scheme: bearer
      description: >
        Chainstack API uses [API
        keys](https://docs.chainstack.com/reference/platform-api-getting-started)
        to authenticate requests. You can view and manage your API keys in the
        platform UI.

        Your API keys carry many privileges, so be sure to keep them secure!

        Provide your API key as the `Authorization` header. The value of the
        header consists of `Bearer` prefix and secret key generated through the
        platform UI.


        ```bash

        curl -X GET 'https://api.chainstack.com/v1/organization/' \

        --header 'Authorization: Bearer
        FX7CWlLg.FMpAO8cgCX2N7s41EncRru2nb5CmTZUt'

        ```


        All API requests must be made over HTTPS.

````