Platform Limits
Kifly enforces limits on cart operations. Read the live values rather than hard-coding them.
Reading current limits
GET https://kifly.ai/api/agent/platform/limits
No authentication required. Returns:
{
"max_item_quantity": 20,
"max_cart_total_cents": 100000,
"max_cart_total_usd": "1000.00"
}
Read this once at session start before beginning a purchase flow. The limits may have changed since your last session.
MCP resource
If you're using the MCP integration, read the kifly://platform/limits resource instead:
read_resource("kifly://platform/limits")
Returns the same JSON. The add_to_cart, update_cart_item, and checkout tool descriptions reference this resource.
Current defaults
| Limit | Default | Error code when exceeded |
|---|---|---|
| Max quantity per line item | 20 | quantity_exceeds_limit (400) |
| Max cart total (subtotal + delivery) | $1,000 (100,000 cents) | cart_total_exceeds_limit (400) |
The cart_total_exceeds_limit error body includes max_cents so you can communicate the exact ceiling to the buyer:
{
"error": "cart_total_exceeds_limit",
"max_cents": 100000
}
When limits apply
| Operation | Which limit is checked |
|---|---|
POST /api/agent/cart/{id}/items | Per-item quantity ceiling |
PATCH /api/agent/cart/{id}/items/{itemId} | Per-item quantity ceiling |
POST /api/agent/payment-link | Cart total ceiling |
MCP add_to_cart | Per-item quantity ceiling |
MCP update_cart_item | Per-item quantity ceiling |
MCP checkout | Cart total ceiling |
Developer network-key issuance
POST /api/developer/network-keys is rate-limited and capped per account. Exceeding the rate returns rate_limited (429, Retry-After set); reaching the cap returns key_limit_reached (409). Revoke an unused key (DELETE /api/developer/network-keys/{id}) to free a slot.