---
title: "PUT /cards/{id}"
method: PUT
path: "/cards/{id}"
tags: ["Cards"]
---

# PUT /cards/{id}

`PUT /cards/{id}`

Always perform a partial update.

## Path parameters

- `id` string, required

## Query parameters

- `assigned_to` string
- `category` string
- `department` string
- `label` string
- `location` string
- `state` string
- `description` string
- `created_before` string
- `created_after` string
- `ordering` string

## Request body

- APICard
  - `id` string, uuid
  - `url` string
  - `description` string, required
  - `name` string
  - `product` object, nullable
    - `id` string, uuid
  - `is_virtual` boolean, required
  - `last_four` string, required
  - `state` string
  - `suspension_reason` string, nullable
  - `assigned_to` object, nullable
    - `id` string, uuid
    - `url` string
    - `email` string
    - `code` string, nullable
    - `first_name` string, required
    - `last_name` string, required
  - `category` object, nullable
    - `id` string, uuid
    - `name` string, required
    - `code` string, nullable
    - `parent` object, required
    - `is_archived` boolean
    - `created_at` string, date-time
    - `url` string
  - `department` object, nullable
    - `id` string, uuid
    - `name` string, required
    - `code` string, nullable
    - `parent` object, required
    - `is_archived` boolean
    - `created_at` string, date-time
    - `url` string
  - `location` object, nullable
    - `id` string, uuid
    - `name` string, required
    - `code` string, nullable
    - `parent` object, required
    - `is_archived` boolean
    - `created_at` string, date-time
    - `url` string
  - `label` object, nullable
    - `id` string, uuid
    - `name` string, required
    - `code` string, nullable
    - `parent` object, required
    - `is_archived` boolean
    - `created_at` string, date-time
    - `url` string
  - `allowance` object, required
    - `id` string, uuid
    - `url` string
    - `interval` string, nullable
    - `amount` number
    - `transaction_limit` number, nullable
    - `daily_limit` number, nullable
    - `single_use` boolean
    - `start_time` string, date-time, nullable
    - `end_time` string, date-time, nullable
    - `scope` integer[]
    - `balance` number, required
  - `expiration` string, date, required
  - `billing_name` string
  - `billing_address` string, nullable
  - `shipping_address` string, nullable
  - `shipping` object, nullable
    - `address` object, nullable, required
      - `attn` string
      - `address_1` string, required
      - `address_2` string
      - `city` string
      - `state` string
      - `postal_code` string, required
      - `country` string, required
    - `carrier` 'fedex' | 'usps' | 'royal_mail' | 'dhl'
    - `eta` string, date-time
    - `name` string
    - `order_size` 'individual' | 'bulk'
    - `phone_number` string, nullable
    - `require_signature` boolean
    - `service` 'standard' | 'express' | 'priority'
    - `status` 'pending' | 'shipped' | 'delivered' | 'returned' | 'failure' | 'canceled'
    - `tracking_number` string
    - `tracking_url` string
  - `created_at` string, date-time, required
  - `network` string, nullable

## Response `200`

- APICard
  - `id` string, uuid
  - `url` string
  - `description` string, required
  - `name` string
  - `product` object, nullable
    - `id` string, uuid
  - `is_virtual` boolean, required
  - `last_four` string, required
  - `state` string
  - `suspension_reason` string, nullable
  - `assigned_to` object, nullable
    - `id` string, uuid
    - `url` string
    - `email` string
    - `code` string, nullable
    - `first_name` string, required
    - `last_name` string, required
  - `category` object, nullable
    - `id` string, uuid
    - `name` string, required
    - `code` string, nullable
    - `parent` object, required
    - `is_archived` boolean
    - `created_at` string, date-time
    - `url` string
  - `department` object, nullable
    - `id` string, uuid
    - `name` string, required
    - `code` string, nullable
    - `parent` object, required
    - `is_archived` boolean
    - `created_at` string, date-time
    - `url` string
  - `location` object, nullable
    - `id` string, uuid
    - `name` string, required
    - `code` string, nullable
    - `parent` object, required
    - `is_archived` boolean
    - `created_at` string, date-time
    - `url` string
  - `label` object, nullable
    - `id` string, uuid
    - `name` string, required
    - `code` string, nullable
    - `parent` object, required
    - `is_archived` boolean
    - `created_at` string, date-time
    - `url` string
  - `allowance` object, required
    - `id` string, uuid
    - `url` string
    - `interval` string, nullable
    - `amount` number
    - `transaction_limit` number, nullable
    - `daily_limit` number, nullable
    - `single_use` boolean
    - `start_time` string, date-time, nullable
    - `end_time` string, date-time, nullable
    - `scope` integer[]
    - `balance` number, required
  - `expiration` string, date, required
  - `billing_name` string
  - `billing_address` string, nullable
  - `shipping_address` string, nullable
  - `shipping` object, nullable
    - `address` object, nullable, required
      - `attn` string
      - `address_1` string, required
      - `address_2` string
      - `city` string
      - `state` string
      - `postal_code` string, required
      - `country` string, required
    - `carrier` 'fedex' | 'usps' | 'royal_mail' | 'dhl'
    - `eta` string, date-time
    - `name` string
    - `order_size` 'individual' | 'bulk'
    - `phone_number` string, nullable
    - `require_signature` boolean
    - `service` 'standard' | 'express' | 'priority'
    - `status` 'pending' | 'shipped' | 'delivered' | 'returned' | 'failure' | 'canceled'
    - `tracking_number` string
    - `tracking_url` string
  - `created_at` string, date-time, required
  - `network` string, nullable

## Other responses

- `400` — Bad Request - Invalid arguments or malformed request
- `401` — Unauthorized - Invalid or missing authentication token
- `403` — Forbidden - Insufficient permissions for this operation
- `404` — Not Found - Resource does not exist
- `409` — Conflict - Request conflicts with existing data
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error

---

[API](https://skmtc.net/emburse/apis/emburse-cards-api.md) · [All operations](https://skmtc.net/emburse/apis/emburse-cards-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/emburse/emburse-cards-api/revisions/f5e3ea16a648/schema)