keepcard_select_return_items
Tell Keepcard which items the customer wants to return. Only call this when keepcard_check_return_eligibility returned needs_item_selection: true. Single-item orders skip this step entirely and go straight to keepcard_submit_return_reason. Present the items from the order to the customer and ask which one or ones they want to return. Each selection requires the item id from order.items; quantity defaults to 1. After this tool returns, the next step is always keepcard_submit_return_reason.
Input Schema
{
"type": "object",
"required": [
"session_id",
"selected_items"
],
"properties": {
"session_id": {
"type": "string",
"description": "The session_id returned by keepcard_check_return_eligibility."
},
"selected_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Item id from order.items."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Units to return. Defaults to 1."
}
}
},
"description": "Items the customer wants to return."
}
}
}
Stores exposing the keepcard_select_return_items tool
Get the agentic commerce digest every Monday
Real adoption data, ecosystem trends, new spec versions, and the stores that broke or recovered this week. Read by founders and engineers building the next generation of commerce.
