---
title: "Update API token"
method: PUT
path: "/public/v1/accounts/api-tokens/{id}"
tags: ["ApiTokens"]
---

# Update API token

`PUT /public/v1/accounts/api-tokens/{id}`

Update API token.
Available for all account types (Operations account, Client account, Vendor account).
Accepts a delta payload with fields to update (e.g. name, description, icon, modules).
Returns the updated API token object.

## Path parameters

- `id` string, required

## Request body

- ApiToken
  - `id` string
  - `audit` PlatformObjectAudit
    - `created` PlatformObjectEvent
      - `at` string, date-time, nullable
      - `by` PlatformIdentityRef
        - `id` string
        - `name` string
        - `icon` string, nullable
        - `revision` integer
    - `updated` PlatformObjectEvent
      - `at` string, date-time, nullable
      - `by` PlatformIdentityRef
        - `id` string
        - `name` string
        - `icon` string, nullable
        - `revision` integer
  - `$meta` PlatformMetadata
    - `omitted` string[]
  - `name` string
  - `icon` string, nullable
  - `revision` integer
  - `status` string
  - `description` string, nullable
  - `lastAccessAt` string, date-time, nullable
  - `token` string
  - `account` AccountRef
    - `id` string
    - `name` string
    - `icon` string, nullable
    - `revision` integer
    - `type` 'Client' | 'Vendor' | 'Operations'
    - `status` 'Active' | 'Enabled' | 'Disabled'
  - `modules` ModuleRef[]
    - `id` string
    - `name` string
    - `revision` integer
    - `description` string
    - `filters` Filters
      - `group.buyers` string[]
    - `settings` ModuleSettings
      - `sharedAccount` boolean
      - `configurable` boolean
      - `default` boolean
      - `paid` boolean
      - `type` string[]
      - `obsolete` boolean
      - `eligibility` ModuleSettingsEligibility
        - `multi` boolean
        - `single` boolean
  - `extensions` PlatformObjectAuditPlatformExtension[], nullable
    - `id` string
    - `audit` PlatformObjectAudit
      - `created` PlatformObjectEvent
        - `at` string, date-time, nullable
        - `by` PlatformIdentityRef
          - `id` string
          - `name` string
          - `icon` string, nullable
          - `revision` integer
      - `updated` PlatformObjectEvent
        - `at` string, date-time, nullable
        - `by` PlatformIdentityRef
          - `id` string
          - `name` string
          - `icon` string, nullable
          - `revision` integer
    - `$meta` PlatformMetadata
      - `omitted` string[]
    - `name` string
    - `icon` string, nullable
    - `revision` integer
    - `status` 'Draft' | 'Private' | 'Public' | 'Deleted'

## Response `200`

OK

- ApiToken
  - `id` string
  - `audit` PlatformObjectAudit
    - `created` PlatformObjectEvent
      - `at` string, date-time, nullable
      - `by` PlatformIdentityRef
        - `id` string
        - `name` string
        - `icon` string, nullable
        - `revision` integer
    - `updated` PlatformObjectEvent
      - `at` string, date-time, nullable
      - `by` PlatformIdentityRef
        - `id` string
        - `name` string
        - `icon` string, nullable
        - `revision` integer
  - `$meta` PlatformMetadata
    - `omitted` string[]
  - `name` string
  - `icon` string, nullable
  - `revision` integer
  - `status` string
  - `description` string, nullable
  - `lastAccessAt` string, date-time, nullable
  - `token` string
  - `account` AccountRef
    - `id` string
    - `name` string
    - `icon` string, nullable
    - `revision` integer
    - `type` 'Client' | 'Vendor' | 'Operations'
    - `status` 'Active' | 'Enabled' | 'Disabled'
  - `modules` ModuleRef[]
    - `id` string
    - `name` string
    - `revision` integer
    - `description` string
    - `filters` Filters
      - `group.buyers` string[]
    - `settings` ModuleSettings
      - `sharedAccount` boolean
      - `configurable` boolean
      - `default` boolean
      - `paid` boolean
      - `type` string[]
      - `obsolete` boolean
      - `eligibility` ModuleSettingsEligibility
        - `multi` boolean
        - `single` boolean
  - `extensions` PlatformObjectAuditPlatformExtension[], nullable
    - `id` string
    - `audit` PlatformObjectAudit
      - `created` PlatformObjectEvent
        - `at` string, date-time, nullable
        - `by` PlatformIdentityRef
          - `id` string
          - `name` string
          - `icon` string, nullable
          - `revision` integer
      - `updated` PlatformObjectEvent
        - `at` string, date-time, nullable
        - `by` PlatformIdentityRef
          - `id` string
          - `name` string
          - `icon` string, nullable
          - `revision` integer
    - `$meta` PlatformMetadata
      - `omitted` string[]
    - `name` string
    - `icon` string, nullable
    - `revision` integer
    - `status` 'Draft' | 'Private' | 'Public' | 'Deleted'

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.dev/softwareone/apis/marketplace-api.md) · [All operations](https://skmtc.dev/softwareone/apis/marketplace-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/softwareone/marketplace-api/revisions/deb9c91ba13c/schema)