---
title: "Update a checkout session"
method: POST
path: "/api/agent/update_checkout"
tags: ["checkout"]
---

# Update a checkout session

`POST /api/agent/update_checkout`

## Request

- Base URL: `https://www.test-well.com`
- URL: `https://www.test-well.com/api/agent/update_checkout`
- Auth: none declared

Change items, state or buyer details on an open checkout session and get it re-priced. Returns the same session object as create_checkout.

## Request body

- object
  - `checkout_session_id` string, required
  - `items` object[]
    - `id` string, required
    - `quantity` integer
  - `state` string
  - `buyer` object
    - `first_name` string
    - `last_name` string
    - `email` string, email
    - `phone_number` string

## Response `200`

Tool result

- object
  - `tool` 'update_checkout', required
  - `result` object, required
    - `id` string, required
    - `status` string, required
    - `line_items` object[], required
      - `id` string, required
      - `total` number, required
    - `totals` object[], required
      - `type` string, required
      - `display_text` string, required
      - `amount` number, required
    - `messages` object[], required
      - `type` 'info' | 'error', required
      - `content` string, required

## Other responses

- `400`: Invalid input
- `429`: Rate limited

---

[API](https://skmtc.dev/test-well/apis/testwell-agent-api.md) · [All operations](https://skmtc.dev/test-well/apis/testwell-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/test-well/apis/testwell-agent-api/revisions/6e260731dfa4?raw)