New "Tags" Available on Cards

Overview

Beginning Thursday, October 8th, cards support tags, a map of key-value pairs that users can set and read through the Cards API. Users can attach their own metadata to a card, such as a risk tier or a program segment.

Details

The card object includes a tags field on every endpoint that returns a card. POST /v1/cards accepts tags as the card's initial tags. PATCH /v1/cards/{card_token} merges the supplied tags into the card's current tags:

• A supplied key is added, or overwritten if it exists.
• A key with a null value is removed.
• An omitted key does not change.

A card can have at most 50 tags. Keys can be up to 40 characters, and values can be up to 500 characters.

Example: Updating Tags

curl -X PATCH https://api.lithic.com/v1/cards/7ef7d65c-9023-4da3-b113-3b8583fd7951 \
  -H "Authorization: $LITHIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tags": {
      "risk-level": "high",
      "legacy-program": null
    }
  }'

This request sets risk-level to high, removes legacy-program, and keeps all other tags on the card.

Release Timeline

Production availability: October 8, 2026

User Impact

This change is additive only. Existing integrations will continue to function without modification. At release, tags is an empty object ({}) on every card.

Updated Documentation

For the card object and its endpoints, visit our API Reference for Create card, Update card, and Get card.

If you have any questions or concerns, please contact us via the HELP link in your Lithic Dashboard.

The Lithic changelog has an RSS feed! To monitor for new update announcements, subscribe with your preferred RSS reader.