---
title: "PATCH /v1/{+name}"
method: PATCH
path: "/v1/{+name}"
tags: ["projects"]
---

# PATCH /v1/{+name}

`PATCH /v1/{+name}`

Updates the parameters of a single blockchain node.

## Path parameters

- `name` string, required

## Query parameters

- `requestId` string
- `updateMask` string

## Request body

- BlockchainNode — A representation of a blockchain node.
  - `updateTime` string, google-datetime — Output only. The timestamp at which the blockchain node was last updated.
  - `createTime` string, google-datetime — Output only. The timestamp at which the blockchain node was first created.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'DELETING' | 'RUNNING' | 'ERROR' | 'UPDATING' | 'REPAIRING' | 'RECONCILING' | 'SYNCING' — Output only. A status representing the state of the node.
  - `ethereumDetails` EthereumDetails — Ethereum-specific blockchain node details.
    - `validatorConfig` ValidatorConfig — Configuration for validator-related parameters on the beacon client, and for any GCP-managed validator client.
      - `managedValidatorClient` boolean — Immutable. When true, deploys a GCP-managed validator client alongside the beacon client.
      - `mevRelayUrls` string[] — URLs for MEV-relay services to use for block building. When set, a GCP-managed MEV-boost service is configured on the beacon client.
      - `beaconFeeRecipient` string — An Ethereum address which the beacon client will send fee rewards to if no recipient is configured in the validator client. See https://lighthouse-book.sigmaprime.io/suggested-fee-recipient.html or https://docs.prylabs.network/docs/execution-node/fee-recipient for examples of how this is used. Note that while this is often described as "suggested", as we run the execution node we can trust the execution node, and therefore this is considered enforced.
    - `nodeType` 'NODE_TYPE_UNSPECIFIED' | 'LIGHT' | 'FULL' | 'ARCHIVE' — Immutable. The type of Ethereum node.
    - `gethDetails` GethDetails — Options for the Geth execution client. See [Command-line Options](https://geth.ethereum.org/docs/fundamentals/command-line-options) for more details.
      - `garbageCollectionMode` 'GARBAGE_COLLECTION_MODE_UNSPECIFIED' | 'FULL' | 'ARCHIVE' — Immutable. Blockchain garbage collection mode.
    - `network` 'NETWORK_UNSPECIFIED' | 'MAINNET' | 'TESTNET_GOERLI_PRATER' | 'TESTNET_SEPOLIA' | 'TESTNET_HOLESKY' — Immutable. The Ethereum environment being accessed.
    - `apiEnableDebug` boolean — Immutable. Enables JSON-RPC access to functions in the `debug` namespace. Defaults to `false`.
    - `executionClient` 'EXECUTION_CLIENT_UNSPECIFIED' | 'GETH' | 'ERIGON' — Immutable. The execution client
    - `consensusClient` 'CONSENSUS_CLIENT_UNSPECIFIED' | 'LIGHTHOUSE' | 'ERIGON_EMBEDDED_CONSENSUS_LAYER' — Immutable. The consensus client.
    - `additionalEndpoints` EthereumEndpoints — Contains endpoint information specific to Ethereum nodes.
      - `beaconApiEndpoint` string — Output only. The assigned URL for the node's Beacon API endpoint.
      - `beaconPrometheusMetricsApiEndpoint` string — Output only. The assigned URL for the node's Beacon Prometheus metrics endpoint. See [Prometheus Metrics](https://lighthouse-book.sigmaprime.io/advanced_metrics.html) for more details.
      - `executionClientPrometheusMetricsApiEndpoint` string — Output only. The assigned URL for the node's execution client's Prometheus metrics endpoint.
    - `apiEnableAdmin` boolean — Immutable. Enables JSON-RPC access to functions in the `admin` namespace. Defaults to `false`.
  - `name` string — Output only. The fully qualified name of the blockchain node. e.g. `projects/my-project/locations/us-central1/blockchainNodes/my-node`.
  - `labels` object — User-provided key-value pairs.
  - `blockchainType` 'BLOCKCHAIN_TYPE_UNSPECIFIED' | 'ETHEREUM' — Immutable. The blockchain type of the node.
  - `connectionInfo` ConnectionInfo — The connection information through which to interact with a blockchain node.
    - `endpointInfo` EndpointInfo — Contains endpoint information through which to interact with a blockchain node.
      - `websocketsApiEndpoint` string — Output only. The assigned URL for the node WebSockets API endpoint.
      - `jsonRpcApiEndpoint` string — Output only. The assigned URL for the node JSON-RPC API endpoint.
    - `serviceAttachment` string — Output only. A service attachment that exposes a node, and has the following format: projects/{project}/regions/{region}/serviceAttachments/{service_attachment_name}
  - `privateServiceConnectEnabled` boolean — Optional. When true, the node is only accessible via Private Service Connect; no public endpoints are exposed. Otherwise, the node is only accessible via public endpoints. Warning: These nodes are deprecated, please use public endpoints instead.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/blockchainnodeengine.md) · [All operations](https://skmtc.net/google/apis/blockchainnodeengine/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/blockchainnodeengine/versions/8180782a9427/schema)