Archive Custom-price Link
Permanently stop a custom-price link from selling.
Irreversible
The link stops selling immediately. There is no unarchive, and an archived
link cannot be updated. Buyers who open its checkout_url can no longer buy
through it.
To stop a link at a set time and keep the option to extend it later, set
expires_at with Update Custom-price Link
instead. Moving the expiry further into the future makes an expired link sell
again.
The archived link stays in the list (filter with
?status=archived) and can still be read by id. It has status: "archived"
and archived_at set.
Archiving an already-archived link returns 200 with the link unchanged.
Request
POST /custom-price-links/{id}/archive
No request body.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Custom-price link UUID. |
Example Request
curl -X POST "https://cart.easy.tools/api/v1/custom-price-links/3f9c2b7e-8d41-4a6f-b2e5-7c1d9a0e4f63/archive" \
-H "Authorization: Bearer YOUR_API_TOKEN"
Response
Success Response (200)
{
"id": "3f9c2b7e-8d41-4a6f-b2e5-7c1d9a0e4f63",
"product_id": "0632bef5-c308-42cd-9cba-89a7a4f722bb",
"variant_id": "d91c65aa-b221-4aa4-b626-cf0d8a198749",
"amount": 1499,
"currency": "usd",
"is_net": false,
"max_purchases": 20,
"purchases_count": 7,
"expires_at": "2027-01-01T05:59:00+01:00",
"archived_at": "2026-11-20T09:30:00+01:00",
"status": "archived",
"checkout_url": "https://cart.easy.tools/checkout/mystore/premium-coffee?_sig=amount%2Cplan%2Cprice_link&amount=1499&plan=price_123&price_link=3f9c2b7e-8d41-4a6f-b2e5-7c1d9a0e4f63&signature=4b8f0c2e9d7a6153e1f04b9c8a2d7e6f5c3b1a0d9e8f7c6b5a4d3e2f1c0b9a8e",
"created_at": "2026-11-18T15:20:41+01:00"
}
Error Responses
Bad Request (400)
{
"message": "Invalid custom-price link ID"
}
Not Found Error (404)
{
"message": "Custom-price link with ID 3f9c2b7e-8d41-4a6f-b2e5-7c1d9a0e4f63 not found"
}
Unauthorized Error (401)
{
"message": "Unauthenticated."
}
Forbidden Error (403)
{
"message": "You do not have API access to the requested store."
}