---
title: "Update Token"
method: PUT
path: "/api/v1/admin/tokens/{token_id}"
tags: ["Admin APIs", "tokens", "tokens"]
---

# Update Token

`PUT /api/v1/admin/tokens/{token_id}`

## Path parameters

- `token_id` string, required

## Request body

- TokenUpdate
  - `key` string, nullable
  - `name` string, nullable
  - `is_promotional` boolean, nullable — True for promotional tokens, False for primary tokens
  - `is_active` boolean, nullable
  - `default_expires_days` integer, nullable — Days until token expires from grant date, used if no specific expiry provided during grant
  - `meta_data` object, nullable

## Response `200`

Successful Response

- TokenResponse
  - `name` string, required
  - `is_promotional` boolean, required
  - `provider_id` string, uuid, nullable
  - `default_expires_days` integer, nullable, required
  - `meta_data` object, nullable
  - `is_integration` boolean — True for integration tokens, False for primary tokens
  - `id` string, uuid, required
  - `is_active` boolean, required
  - `usage_scope` string, nullable
  - `can_be_cashed_out` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)