Medusa

Update a Gift Card

POST

/admin/gift-cards/{id}

Gift Cards

Update a Gift Card's details.

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST '{{BASE_URL}}/admin/gift-cards/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "balance": 0,
    "is_disabled": true,
    "ends_at": "2019-08-24T14:15:22Z",
    "region_id": "string",
    "metadata": {}
}'

Response Example

200 - Example 1

{
    "gift_card": {
        "id": "gift_01G8XKBPBQY2R7RBET4J7E0XQZ",
        "code": "3RFT-MH2C-Y4YZ-XMN4",
        "value": 10,
        "balance": 10,
        "region_id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
        "order_id": "order_01G8TJSYT9M6AVS5N4EMNFS1EK",
        "order": {},
        "is_disabled": false,
        "ends_at": "2019-08-24T14:15:22Z",
        "tax_rate": 0,
        "created_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:15:22Z",
        "deleted_at": "2019-08-24T14:15:22Z",
        "metadata": {
            "car": "white"
        },
        "region": {
            "id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
            "name": "EU",
            "tax_rate": 0,
            "tax_code": null,
            "gift_cards_taxable": true,
            "automatic_taxes": true,
            "tax_provider_id": null,
            "includes_tax": false,
            "created_at": "2019-08-24T14:15:22Z",
            "updated_at": "2019-08-24T14:15:22Z",
            "deleted_at": "2019-08-24T14:15:22Z",
            "currency_code": "usd",
            "metadata": {
                "car": "white"
            },
            "currency": {
                "symbol": "$",
                "symbol_native": "$",
                "name": "US Dollar",
                "includes_tax": false,
                "code": "usd"
            },
            "countries": [
                {
                    "id": 109,
                    "name": "ITALY",
                    "display_name": "Italy",
                    "region_id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
                    "region": {},
                    "iso_2": "it",
                    "iso_3": "ita",
                    "num_code": 380
                }
            ],
            "tax_provider": {
                "id": "manual",
                "is_installed": true
            },
            "payment_providers": [
                {
                    "id": "manual",
                    "is_installed": true
                }
            ],
            "fulfillment_providers": [
                {
                    "id": "manual",
                    "is_installed": true
                }
            ],
            "tax_rates": [
                {
                    "id": "txr_01G8XDBAWKBHHJRKH0AV02KXBR",
                    "rate": 10,
                    "code": "tax01",
                    "name": "Tax Example",
                    "region_id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
                    "region": {},
                    "product_count": 10,
                    "product_type_count": 2,
                    "shipping_option_count": 1,
                    "created_at": "2019-08-24T14:15:22Z",
                    "updated_at": "2019-08-24T14:15:22Z",
                    "metadata": {
                        "car": "white"
                    },
                    "product_types": [
                        {
                            "id": "ptyp_01G8X9A7ESKAJXG2H0E6F1MW7A",
                            "value": "Clothing",
                            "created_at": "2019-08-24T14:15:22Z",
                            "updated_at": "2019-08-24T14:15:22Z",
                            "deleted_at": "2019-08-24T14:15:22Z",
                            "metadata": {
                                "car": "white"
                            }
                        }
                    ],
                    "shipping_options": [
                        {
                            "id": "so_01G1G5V27GYX4QXNARRQCW1N8T",
                            "name": "PostFake Standard",
                            "region_id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
                            "region": {},
                            "profile_id": "sp_01G1G5V239ENSZ5MV4JAR737BM",
                            "provider_id": "manual",
                            "amount": 200,
                            "is_return": false,
                            "admin_only": false,
                            "includes_tax": false,
                            "created_at": "2019-08-24T14:15:22Z",
                            "updated_at": "2019-08-24T14:15:22Z",
                            "deleted_at": "2019-08-24T14:15:22Z",
                            "price_type": "flat_rate",
                            "data": {},
                            "metadata": {
                                "car": "white"
                            },
                            "provider": {
                                "id": "manual",
                                "is_installed": true
                            },
                            "requirements": [
                                {
                                    "id": "sor_01G1G5V29AB4CTNDRFSRWSRKWD",
                                    "shipping_option_id": "so_01G1G5V27GYX4QXNARRQCW1N8T",
                                    "shipping_option": {},
                                    "amount": 100,
                                    "deleted_at": "2019-08-24T14:15:22Z",
                                    "type": "min_subtotal"
                                }
                            ],
                            "profile": {
                                "id": "sp_01G1G5V239ENSZ5MV4JAR737BM",
                                "name": "Default Shipping Profile",
                                "created_at": "2019-08-24T14:15:22Z",
                                "updated_at": "2019-08-24T14:15:22Z",
                                "deleted_at": "2019-08-24T14:15:22Z",
                                "type": "default",
                                "products": [
                                    {}
                                ],
                                "shipping_options": [
                                    {}
                                ],
                                "metadata": {
                                    "car": "white"
                                }
                            }
                        }
                    ],
                    "products": [
                        {
                            "id": "prod_01G1G5V2MBA328390B5AXJ610F",
                            "title": "Medusa Coffee Mug",
                            "subtitle": "string",
                            "description": "Every programmer's best friend.",
                            "handle": "coffee-mug",
                            "is_giftcard": false,
                            "thumbnail": "http://example.com",
                            "profile_id": "sp_01G1G5V239ENSZ5MV4JAR737BM",
                            "weight": null,
                            "length": null,
                            "height": null,
                            "width": null,
                            "hs_code": null,
                            "origin_country": null,
                            "mid_code": null,
                            "material": null,
                            "collection_id": "pcol_01F0YESBFAZ0DV6V831JXWH0BG",
                            "type_id": "ptyp_01G8X9A7ESKAJXG2H0E6F1MW7A",
                            "discountable": true,
                            "external_id": null,
                            "created_at": "2019-08-24T14:15:22Z",
                            "updated_at": "2019-08-24T14:15:22Z",
                            "deleted_at": "2019-08-24T14:15:22Z",
                            "status": "draft",
                            "metadata": {
                                "car": "white"
                            },
                            "images": [
                                {
                                    "id": "img_01G749BFYR6T8JTVW6SGW3K3E6",
                                    "url": "http://example.com",
                                    "created_at": "2019-08-24T14:15:22Z",
                                    "updated_at": "2019-08-24T14:15:22Z",
                                    "deleted_at": "2019-08-24T14:15:22Z",
                                    "metadata": {
                                        "car": "white"
                                    }
                                }
                            ],
                            "categories": [
                                {
                                    "id": "pcat_01G2SG30J8C85S4A5CHM2S1NS2",
                                    "name": "Regular Fit",
                                    "handle": "regular-fit",
                                    "mpath": "pcat_id1.pcat_id2.pcat_id3",
                                    "is_internal": false,
                                    "is_active": false,
                                    "rank": 0,
                                    "parent_category_id": null,
                                    "parent_category": {},
                                    "created_at": "2019-08-24T14:15:22Z",
                                    "updated_at": "2019-08-24T14:15:22Z",
                                    "category_children": [
                                        {}
                                    ],
                                    "products": [
                                        {}
                                    ]
                                }
                            ],
                            "collection": {
                                "id": "pcol_01F0YESBFAZ0DV6V831JXWH0BG",
                                "title": "Summer Collection",
                                "handle": "summer-collection",
                                "created_at": "2019-08-24T14:15:22Z",
                                "updated_at": "2019-08-24T14:15:22Z",
                                "deleted_at": "2019-08-24T14:15:22Z",
                                "products": [
                                    {}
                                ],
                                "metadata": {
                                    "car": "white"
                                }
                            },
                            "tags": [
                                {
                                    "id": "ptag_01G8K2MTMG9168F2B70S1TAVK3",
                                    "value": "Pants",
                                    "created_at": "2019-08-24T14:15:22Z",
                                    "updated_at": "2019-08-24T14:15:22Z",
                                    "deleted_at": "2019-08-24T14:15:22Z",
                                    "metadata": {
                                        "car": "white"
                                    }
                                }
                            ],
                            "profile": {
                                "id": "sp_01G1G5V239ENSZ5MV4JAR737BM",
                                "name": "Default Shipping Profile",
                                "created_at": "2019-08-24T14:15:22Z",
                                "updated_at": "2019-08-24T14:15:22Z",
                                "deleted_at": "2019-08-24T14:15:22Z",
                                "type": "default",
                                "products": [
                                    {}
                                ],
                                "shipping_options": [
                                    {}
                                ],
                                "metadata": {
                                    "car": "white"
                                }
                            },
                            "profiles": [
                                {
                                    "id": "sp_01G1G5V239ENSZ5MV4JAR737BM",
                                    "name": "Default Shipping Profile",
                                    "created_at": "2019-08-24T14:15:22Z",
                                    "updated_at": "2019-08-24T14:15:22Z",
                                    "deleted_at": "2019-08-24T14:15:22Z",
                                    "type": "default",
                                    "products": [
                                        {}
                                    ],
                                    "shipping_options": [
                                        {}
                                    ],
                                    "metadata": {
                                        "car": "white"
                                    }
                                }
                            ],
                            "type": {
                                "id": "ptyp_01G8X9A7ESKAJXG2H0E6F1MW7A",
                                "value": "Clothing",
                                "created_at": "2019-08-24T14:15:22Z",
                                "updated_at": "2019-08-24T14:15:22Z",
                                "deleted_at": "2019-08-24T14:15:22Z",
                                "metadata": {
                                    "car": "white"
                                }
                            },
                            "sales_channels": [
                                {
                                    "id": "sc_01G8X9A7ESKAJXG2H0E6F1MW7A",
                                    "name": "Market",
                                    "description": "Multi-vendor market",
                                    "is_disabled": false,
                                    "created_at": "2019-08-24T14:15:22Z",
                                    "updated_at": "2019-08-24T14:15:22Z",
                                    "deleted_at": "2019-08-24T14:15:22Z",
                                    "metadata": {
                                        "car": "white"
                                    },
                                    "locations": [
                                        {
                                            "id": "scloc_01G8X9A7ESKAJXG2H0E6F1MW7A",
                                            "sales_channel_id": "sc_01G8X9A7ESKAJXG2H0E6F1MW7A",
                                            "location_id": "string",
                                            "sales_channel": {},
                                            "created_at": "2019-08-24T14:15:22Z",
                                            "updated_at": "2019-08-24T14:15:22Z",
                                            "deleted_at": "2019-08-24T14:15:22Z"
                                        }
                                    ]
                                }
                            ],
                            "options": [
                                {
                                    "id": "opt_01F0YESHQBZVKCEXJ24BS6PCX3",
                                    "title": "Size",
                                    "product_id": "prod_01G1G5V2MBA328390B5AXJ610F",
                                    "product": {},
                                    "created_at": "2019-08-24T14:15:22Z",
                                    "updated_at": "2019-08-24T14:15:22Z",
                                    "deleted_at": "2019-08-24T14:15:22Z",
                                    "metadata": {
                                        "car": "white"
                                    },
                                    "values": [
                                        {
                                            "id": "optval_01F0YESHR7S6ECD03RF6W12DSJ",
                                            "value": "large",
                                            "option_id": "opt_01F0YESHQBZVKCEXJ24BS6PCX3",
                                            "option": {},
                                            "variant_id": "variant_01G1G5V2MRX2V3PVSR2WXYPFB6",
                                            "variant": {},
                                            "created_at": "2019-08-24T14:15:22Z",
                                            "updated_at": "2019-08-24T14:15:22Z",
                                            "deleted_at": "2019-08-24T14:15:22Z",
                                            "metadata": {
                                                "car": "white"
                                            }
                                        }
                                    ]
                                }
                            ],
                            "variants": [
                                {
                                    "id": "variant_01G1G5V2MRX2V3PVSR2WXYPFB6",
                                    "title": "Small",
                                    "product_id": "prod_01G1G5V2MBA328390B5AXJ610F",
                                    "product": {},
                                    "sku": "shirt-123",
                                    "barcode": null,
                                    "ean": null,
                                    "upc": null,
                                    "variant_rank": 0,
                                    "inventory_quantity": 100,
                                    "allow_backorder": false,
                                    "manage_inventory": true,
                                    "hs_code": null,
                                    "origin_country": null,
                                    "mid_code": null,
                                    "material": null,
                                    "weight": null,
                                    "length": null,
                                    "height": null,
                                    "width": null,
                                    "created_at": "2019-08-24T14:15:22Z",
                                    "updated_at": "2019-08-24T14:15:22Z",
                                    "deleted_at": "2019-08-24T14:15:22Z",
                                    "purchasable": true,
                                    "metadata": {
                                        "car": "white"
                                    },
                                    "options": [
                                        {
                                            "id": "optval_01F0YESHR7S6ECD03RF6W12DSJ",
                                            "value": "large",
                                            "option_id": "opt_01F0YESHQBZVKCEXJ24BS6PCX3",
                                            "option": {},
                                            "variant_id": "variant_01G1G5V2MRX2V3PVSR2WXYPFB6",
                                            "variant": {},
                                            "created_at": "2019-08-24T14:15:22Z",
                                            "updated_at": "2019-08-24T14:15:22Z",
                                            "deleted_at": "2019-08-24T14:15:22Z",
                                            "metadata": {
                                                "car": "white"
                                            }
                                        }
                                    ],
                                    "inventory_items": [
                                        {
                                            "id": "pvitem_01G8X9A7ESKAJXG2H0E6F1MW7A",
                                            "inventory_item_id": "string",
                                            "variant_id": "string",
                                            "variant": {},
                                            "required_quantity": 1,
                                            "created_at": "2019-08-24T14:15:22Z",
                                            "updated_at": "2019-08-24T14:15:22Z",
                                            "deleted_at": "2019-08-24T14:15:22Z"
                                        }
                                    ],
                                    "prices": [
                                        {
                                            "id": "ma_01F0YESHRFQNH5S8Q0PK84YYZN",
                                            "amount": 100,
                                            "min_quantity": 1,
                                            "max_quantity": 1,
                                            "price_list_id": "pl_01G8X3CKJXCG5VXVZ87H9KC09W",
                                            "price_list": {},
                                            "variant_id": "variant_01G1G5V2MRX2V3PVSR2WXYPFB6",
                                            "variant": {},
                                            "region_id": "reg_01G1G5V26T9H8Y0M4JNE3YGA4G",
                                            "region": {},
                                            "created_at": "2019-08-24T14:15:22Z",
                                            "updated_at": "2019-08-24T14:15:22Z",
                                            "deleted_at": "2019-08-24T14:15:22Z",
                                            "currency_code": "usd",
                                            "currency": {
                                                "symbol": "$",
                                                "symbol_native": "$",
                                                "name": "US Dollar",
                                                "includes_tax": false,
                                                "code": "usd"
                                            }
                                        }
                                    ]
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    }
}

Request

Path Params

string

required

The ID of the Gift Card.

Body Params application/json

balance

integer

optional

The value (excluding VAT) that the Gift Card should represent.

is_disabled

boolean

optional

Whether the Gift Card is disabled on creation. If set to true, the gift card will not be available for customers.

ends_at

string <date-time>

optional

The date and time at which the Gift Card should no longer be available.

region_id

string

optional

The ID of the Region in which the Gift Card can be used.

metadata

object

optional

An optional set of key-value pairs to hold additional information.

Examples

Responses

🟢200OK

application/json

Body

gift_card

object (Gift Card)

required

Gift Cards are redeemable and represent a value that can be used towards the payment of an Order.

string

required

The gift card's ID

Example:

gift_01G8XKBPBQY2R7RBET4J7E0XQZ

code

string

required

The unique code that identifies the Gift Card. This is used by the Customer to redeem the value of the Gift Card.

Example:

3RFT-MH2C-Y4YZ-XMN4

value

integer

required

The value that the Gift Card represents.

Example:

balance

integer

required

The remaining value on the Gift Card.

Example:

region_id

string

required

The ID of the region this gift card is available in.

Example:

reg_01G1G5V26T9H8Y0M4JNE3YGA4G

order_id

string | null

required

The ID of the order that the gift card was purchased in.

Example:

order_01G8TJSYT9M6AVS5N4EMNFS1EK

order

object | null

optional

The details of the order that the gift card was purchased in.

is_disabled

boolean

required

Whether the Gift Card has been disabled. Disabled Gift Cards cannot be applied to carts.

Default:

false

ends_at

string <date-time> | null

required

The time at which the Gift Card can no longer be used.

tax_rate

number | null

required

The gift card's tax rate that will be applied on calculating totals

Example:

created_at

string <date-time>

required

The date with timezone at which the resource was created.

updated_at

string <date-time>

required

The date with timezone at which the resource was updated.

deleted_at

string <date-time> | null

required

The date with timezone at which the resource was deleted.

metadata

object | null

required

An optional key-value map with additional details

Example:

{"car":"white"}

region

object (Region)

optional

A region holds settings specific to a geographical location, including the currency, tax rates, and fulfillment and payment providers. A Region can consist of multiple countries to accomodate common shopping settings across countries.

🟠400Client Error or Multiple Errors

🟠401User is not authorized. Must log in first

🟠404Not Found Error

🟠409Invalid State Error

🟠422Invalid Request Error

🔴500Server Error

Get a Gift Card

Create an Inventory Item