---
title: "Update a Token"
method: PATCH
path: "/digital_wallet_token/{id}"
tags: ["Digital Wallet Tokens"]
---

# Update a Token

`PATCH /digital_wallet_token/{id}`

## Path parameters

- `id` string, required — Unique identifier for object

## Request body

- object
  - `status` string — One of: `active`, `suspended`, `terminated`. Patch this field to control the active or inactive state of the token

## Response `200`

The digital_wallet_token updated

- object
  - `card_id` string — The ID of the card object the token is associated with. Filterable.
  - `created_at` string — Timestamp of when the object was created
  - `device` object — An object that defines additional fields for the device that initiated tokenization
    - `device_id` string — A unique identifier of the device
    - `ip_address` string — The IP address of the device
    - `location` string — Approximate latitude and longitude coordinates of the device
    - `name` string — Name of the device
    - `phone_number` string — The last four numbers of the device's telephone number
    - `type` string — The type of the device. Can be one of `mobile_phone`, `watch`, `tablet`, `unknown`
  - `fulfillment` object — An object that defines additional fields for fulfillment of the token
    - `status` string — One of: `decision_green`, `decision_yellow`, `provisioned`, `rejected`
  - `id` string — Unique identifier for object
  - `status` string — The status of the token. One of: `active`, `requested`, `request_declined`, `suspended`, `terminated`. Filterable.
  - `token_service_provider` object — An object that defines additional fields for requestor of the token
    - `network` string — The card network the tokenization occurred on. Can be one of `visa`, `mastercard`, or `unknown.
    - `pan_reference_id` string — A unique identifier of digital wallet token PAN
    - `token_pan_last4` string — Last 4 of the digital wallet token PAN
    - `token_reference_id` string — The unique identifier of the digital wallet token
    - `token_requestor_id` string — Unique numerical identifier of the digital wallet token requestor within the card network. These IDs map to a `token_requestor_name`
    - `token_requestor_name` string — Name of the token requestor within the card network
  - `updated_at` string — Timestamp of when the object was updated

---

[API](https://skmtc.net/treasuryprime/apis/account.md) · [All operations](https://skmtc.net/treasuryprime/apis/account/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasuryprime/account/revisions/95a3c69c14e8/schema)