What parameters does POST /V1/guest-carts/:cartId/gift-message/:itemId accept?

This endpoint accepts 3 parameters: cartId (string) required; itemId (int) required; giftMessage (Magento\GiftMessage\Api\Data\MessageInterface) required.

Does POST /V1/guest-carts/:cartId/gift-message/:itemId require authentication?

This endpoint can be called anonymously — no Authorization header required.

MageSmith

POSTGiftMessage · Magento 2.4.9 Anonymous

POST /V1/guest-carts/:cartId/gift-message/:itemId

Q: What does the POST /V1/guest-carts/:cartId/gift-message/:itemId endpoint do in Magento 2?

POST /V1/guest-carts/:cartId/gift-message/:itemId is a Magento 2 REST endpoint in the GiftMessage module. Set the gift message for a specified item in a specified shopping cart. Callable anonymously — no Authorization header required.

POST /V1/guest-carts/:cartId/gift-message/:itemId is a Magento 2 REST endpoint in the GiftMessage module. Set the gift message for a specified item in a specified shopping cart. Callable anonymously — no Authorization header required.

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

bool

Service contract

Magento\GiftMessage\Api\GuestItemRepositoryInterface::save

Authorization

Anonymous — no Authorization header required.

Path parameters

cartId string Required

The cart ID.

itemId int Required

The item ID.

Body parameters

giftMessage Magento\GiftMessage\Api\Data\MessageInterface Required

The gift message.

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.

Headers

application/json

Content-Type

application/json

Path

/V1/guest-carts/{cartId}/gift-message/{itemId}

Body

{
  "giftMessage": {
    "customer_id": 0,
    "extension_attributes": {},
    "gift_message_id": 0,
    "message": "",
    "recipient": "",
    "sender": ""
  }
}