> ## 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.

# wallet/updatewitness | TRON

> TRON API method that creates a transaction to update a witness account's URL. Reference for wallet/updatewitness on TRON via Chainstack.

TRON API method that creates a transaction to update a witness account's URL. This allows witnesses to update their public information and promotional content displayed to voters in the TRON network governance system.

## Parameters

* `owner_address` — hexadecimal address of the witness account to update
* `update_url` — new URL string for the witness (maximum 256 bytes)
* `visible` — boolean indicating whether addresses should be in visible format (Base58Check)

## Response

* `visible` — boolean indicating whether addresses are in visible format
* `txID` — unique transaction ID for the witness update transaction
* `raw_data` — raw transaction data containing:
  * `contract` — array with witness update contract details
  * `ref_block_bytes` — reference block bytes for transaction validation
  * `ref_block_hash` — hash of the reference block
  * `expiration` — transaction expiration timestamp
  * `timestamp` — transaction creation timestamp
* `raw_data_hex` — complete transaction data encoded in hexadecimal format

## Use case

The `wallet/updatewitness` method is used for:

* Updating witness promotional URLs and information for voters.
* Maintaining current witness contact information and websites.
* Building witness management dashboards and governance tools.
* Implementing automated witness information updates in applications.
* Creating witness profile management systems for TRON governance participants.

<Note>
  Only the witness account owner can update their witness information. The URL field can contain website links, social media profiles, or other promotional content to help voters make informed decisions. Updates require network confirmation and consume bandwidth.
</Note>


## OpenAPI

````yaml openapi/tron_node_api/updatewitness.json post /95e61622bf6a8af293978377718e3b77/wallet/updatewitness
openapi: 3.0.0
info:
  title: wallet/updatewitness TRON API
  version: 1.0.0
  description: Update witness URL and information
servers:
  - url: https://tron-mainnet.core.chainstack.com
security: []
paths:
  /95e61622bf6a8af293978377718e3b77/wallet/updatewitness:
    post:
      tags:
        - Witness and Governance
      summary: wallet/updatewitness
      operationId: updateWitness
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                owner_address:
                  type: string
                  description: Hexadecimal address of the witness account to update
                update_url:
                  type: string
                  description: New URL string for the witness (maximum 256 bytes)
                visible:
                  type: boolean
                  description: Whether addresses should be in visible format (Base58Check)
              required:
                - owner_address
              example:
                owner_address: TPswDDCAWhJAZGdHPidFg5nEf8TkNToDX1
                update_url: https://example.com/witness
                visible: true
      responses:
        '200':
          description: Witness update transaction
          content:
            application/json:
              schema:
                type: object
                properties:
                  visible:
                    type: boolean
                    description: Whether addresses are in visible format
                  txID:
                    type: string
                    description: Transaction ID for witness update transaction
                  raw_data:
                    type: object
                    properties:
                      contract:
                        type: array
                        description: Contract details for witness update
                        items:
                          type: object
                          properties:
                            type:
                              type: string
                              example: UpdateWitnessContract
                            parameter:
                              type: object
                              properties:
                                type_url:
                                  type: string
                                  example: >-
                                    type.googleapis.com/protocol.UpdateWitnessContract
                                value:
                                  type: object
                                  properties:
                                    owner_address:
                                      type: string
                                    update_url:
                                      type: string
                      ref_block_bytes:
                        type: string
                        description: Reference block bytes for validation
                      ref_block_hash:
                        type: string
                        description: Hash of the reference block
                      expiration:
                        type: integer
                        description: Transaction expiration timestamp
                      timestamp:
                        type: integer
                        description: Transaction creation timestamp
                  raw_data_hex:
                    type: string
                    description: Raw transaction data in hex format

````