Input Schema

{
    "type": "object",
    "required": [
        "agent_id",
        "merchant_domain",
        "checkout_id"
    ],
    "properties": {
        "buyer": {
            "type": "object",
            "required": [
                "email",
                "first_name",
                "last_name",
                "street_address",
                "address_locality",
                "address_region",
                "postal_code",
                "address_country"
            ],
            "properties": {
                "email": {
                    "type": "string",
                    "description": "Buyer email for merchant checkout contact and order confirmation."
                },
                "phone": {
                    "type": "string",
                    "description": "Buyer phone. Prefer E.164, e.g. +15555550100. Non-E.164 values are accepted but may be dropped before reaching the provider and will surface a non-fatal warning."
                },
                "last_name": {
                    "type": "string",
                    "description": "Buyer-provided shipping last name."
                },
                "first_name": {
                    "type": "string",
                    "description": "Buyer-provided shipping first name."
                },
                "postal_code": {
                    "type": "string",
                    "description": "Buyer-provided shipping postal code."
                },
                "phone_number": {
                    "type": "string",
                    "description": "Canonical buyer phone alias. Prefer E.164. Equivalent to `phone`; if both are set, phone_number wins."
                },
                "address_region": {
                    "type": "string",
                    "description": "Buyer-provided shipping state/province/region."
                },
                "street_address": {
                    "type": "string",
                    "description": "Buyer-provided shipping street address."
                },
                "address_country": {
                    "type": "string",
                    "description": "ISO 3166-1 alpha-2 country code. Use 'US', not 'USA'."
                },
                "address_locality": {
                    "type": "string",
                    "description": "Buyer-provided shipping city/locality."
                }
            },
            "description": "Buyer-provided checkout contact and shipping details. Never invent PII; omit phone if unavailable.",
            "additionalProperties": false
        },
        "agent_id": {
            "type": "string",
            "description": "Registered UCP Gateway UUID returned by register_ucp_profile; required for every Shopping tool."
        },
        "checkout": {
            "type": "object",
            "required": [],
            "properties": [],
            "description": "Optional full checkout replacement payload accepted by the provider. Prefer typed buyer for address/phone corrections; buyer address fields placed here are canonicalized into buyer/context/fulfillment with phone_number. Never include payment credentials.",
            "additionalProperties": true
        },
        "checkout_id": {
            "type": "string",
            "description": "Provider checkout ID returned by checkout tools."
        },
        "merchant_domain": {
            "type": "string",
            "description": "Merchant host such as 'outboundpower.com' or 'example.myshopify.com'. Do not include a URL scheme, localhost, private IP, file URL, or ftp URL."
        },
        "client_action_id": {
            "type": "string",
            "description": "Optional UUID generated once for an explicit buyer/operator-confirmed cart or checkout mutation. Reuse only when retrying the same confirmed action."
        }
    },
    "description": "Arguments for updating a checkout. Provide checkout and/or buyer.",
    "additionalProperties": false
}