---
title: >-
  Gift Card line_item_id will become read-only in REST Admin API version 2027-01
  - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/rest-gift-card-line_item_id-will-become-read-only-in-api-version-2027-01
  md: >-
    https://shopify.dev/changelog/posts/rest-gift-card-line_item_id-will-become-read-only-in-api-version-2027-01.md
metadata:
  effectiveApiVersion: 2027-01
  affectedApi:
    - displayName: Admin REST API
      handle: admin-rest
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Breaking API Change
    handle: breaking-api-change
  indicatesActionRequired: true
  createdAt: '2026-10-28T13:38:57-04:00'
  postedAt: '2026-10-30T12:00:00-04:00'
  updatedAt: '2026-11-02T14:58:25-05:00'
  effectiveAt: '2026-10-30T12:00:00-04:00'
---

October 30, 2026

# Gift Card line\_item\_id will become read-only in REST Admin API version 2027-01

DateOctober 30, 2026

Version[2027-01](https://shopify.dev/changelog?api_version=2027-01)

Flags[Breaking API Change](https://shopify.dev/changelog?filter=breaking-api-change)[Action required](https://shopify.dev/changelog?action_required=true)

SurfacesAPI

Affected APIs[Admin REST API](https://shopify.dev/changelog?api_type=admin-rest)

In REST Admin API version 2027-01 and later, the `line_item_id` property on the Gift Card resource is read-only. Shopify ignores the property in create and update requests. Remove it from those requests before you upgrade.

## What changed

In REST Admin API version 2027-01 and later, apps can't add, replace, or clear a gift card's line-item association through Gift Card create or update requests. Shopify ignores any `line_item_id` value in those requests.

Gift Card responses still include existing line-item and order associations. Earlier API versions keep their current behavior.

## Who's affected

This change affects you if all of the following are true:

* Your app uses the REST Admin API Gift Card resource.
* Your app includes `line_item_id` when it creates or updates gift cards.
* You plan to upgrade your app to API version 2027-01 or later.

If your app only reads `line_item_id` from Gift Card responses, or stays on an API version earlier than 2027-01, then this change doesn't affect you.

## Why this matters

A gift card's line-item association records the order line item that created the gift card. Making `line_item_id` read-only stops apps from changing the link between a gift card and its order.

## Breaking changes and migrations

In REST Admin API version 2027-01 and later, Shopify accepts create and update requests that include `line_item_id` and ignores the property. The gift card keeps its existing line-item association.

Before you upgrade to API version 2027-01:

1. Find the REST Gift Card create and update calls that send `line_item_id`.
2. Remove `line_item_id` from those request payloads.
3. If your app needs the existing association, then keep reading `line_item_id` from Gift Card responses.

There isn't a replacement API for adding, replacing, or clearing a gift card's line-item association from outside Shopify.

To confirm the migration:

1. Send a create or update request without `line_item_id`.
2. Read the same gift card, and check that its `line_item_id` value didn't change.

## Action required

Before you move production traffic to REST Admin API version 2027-01 or later, stop sending `line_item_id` in Gift Card create and update requests. Otherwise, your app's records might not match Shopify's, because Shopify keeps the original association.

## Related docs

* [REST Admin API Gift Card resource for 2027-01](https://shopify.dev/docs/api/admin-rest/2027-01/resources/gift-card)
* [Shopify API versioning](https://shopify.dev/docs/api/usage/versioning)