Update an Instrument Identifier {#tms-ii-tkn-update-intro}
==========================================================

This section describes how to update an instrument identifier.

Endpoint {#tms-ii-tkn-update-intro_section_rlf_5mk_dwb}
-------------------------------------------------------

**Test:** `PATCH ``https://apitest.visaacceptance.com``/tms/v1/instrumentidentifiers/{instrumentIdentifierTokenId}`{#tms-ii-tkn-update-intro_restcust-test}  
**Production:** `PATCH ``https://api.visaacceptance.com``/tms/v1/instrumentidentifiers/{instrumentIdentifierTokenId}`  
*`{instrumentIdentifierTokenId}`* is the instrument identifier token ID returned in the id field when you created the instrument identifier token. For more information, see [Create an Instrument Identifier](/docs/vas/en-us/tms/developer/all/rest/tms/tms-ii-tkn/tms-manage-ii-tkn/tms-ii-tkn-create-intro.md "").

Optional Fields for Updating an Instrument Identifier {#tms-ii-tkn-update-optfields}
====================================================================================

bankAccount.number
:

bankAccount.routingNumber
:

billTo.address1
:

billTo.address2
:

billTo.administrativeArea
:

billTo.country
:

billTo.locality
:

billTo.postalCode
:

card.expirationMonth
:

card.expirationYear
:

card.securityCode
:
{#tms-ii-tkn-update-optfields_dl_u12_vqy_dwb}

REST Example: Updating an Instrument Identifier {#tms-ii-tkn-update-ex-rest}
============================================================================

Request

```keyword
PATCH https://apitest.visaacceptance.com/tms/v1/instrumentidentifiers/7010000000016241111
```

Response to a Successful Request

```keyword
{
  "_links": {
    "self": {
      "href": "https://apitest.visaacceptance.com/tms/v1/instrumentidentifiers/7010000000016241111"
    },
    "paymentInstruments": {
      "href": "https://apitest.visaacceptance.com/tms/v1/instrumentidentifiers/7010000000016241111/paymentinstruments"
    }
  },
  "id": "7010000000016241111",
  "object": "instrumentIdentifier",
  "state": "ACTIVE",
  "card": {
    "number": "411111XXXXXX1111"
  },
  "processingInformation": {
    "authorizationOptions": {
      "initiator": {
        "merchantInitiatedTransaction": {
          "previousTransactionId": "123456789012345"
        }
      }
    }
  },
  "metadata": {
    "creator": "testrest"
  }
}
```