---
title: "Edit Hotel Shortlist"
method: POST
path: "/conv/trips/{trip_id}/hotel-shortlist"
tags: ["conversational"]
---

# Edit Hotel Shortlist

`POST /conv/trips/{trip_id}/hotel-shortlist`

## Request

- Base URL: `https://api.helloaxel.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.helloaxel.com/conv/trips/{trip_id}/hotel-shortlist`
- Auth: HTTP bearer

## Path parameters

- `trip_id` string, required

## Request body

- HotelShortlistRequest: Edit the shortlist for one existing hotel search; set supports comparisons.
  - `hotel_search_session_id` string, uuid, required
  - `map_session_id` string, required
  - `criteria_hash` string, required
  - `action` 'add' | 'remove' | 'set', required
  - `hotel_ids` integer[], required

## Response `200`

Successful Response

- HotelMapPickPatch: Authoritative Axel-pick update for an already-mounted hotel map. This deliberately carries no hotel inventory. The existing Content session remains the source of pins/prices; Brain only replaces the ordered set that receives Axel-pick treatment.
  - `shortlist_hotel_ids` integer[], nullable
  - `component` 'hotel_map'
  - `map_session_id` string, required
  - `update_mode` 'pick_patch'
  - `hotel_search_session_id` string, uuid, required
  - `criteria_hash` string, required
  - `take` string
  - `picks` HotelCurationPick[]
    - `hotel_id` integer, required
    - `fit` 'great' | 'good' | 'fine', required
    - `map_tag` string, nullable
    - `verdict` string, required
    - `reasons` HotelCurationReason[]
      - `stance` 'for' | 'tradeoff' | 'against', required
      - `text` string, required
  - `map_annotations` HotelMapAnnotation[]
    - `hotel_id` integer, required
    - `map_tag` string, required
    - `kind` 'draw' | 'caveat', required
  - `pick_hotel_ids` integer[]
  - `curation_status` 'applied' | 'waiting_for_inventory' | 'preserved'
  - `comparison_refresh_token` string, uuid, nullable

## Other responses

- `422`: Validation Error

## Changes

> 68 revisions in range; 1 not diffed.

- **2026-10-15** `ba2f26081946`: 1 info
  - added the optional property `comparison_refresh_token` to the response with the `200` status
- **2026-10-12** `7aacdbd25f73`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/helloaxel/apis/client-api-gateway/changes/conv/trips/:trip_id/hotel-shortlist/post.md)

---

[API](https://skmtc.dev/helloaxel/apis/client-api-gateway.md) · [All operations](https://skmtc.dev/helloaxel/apis/client-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/helloaxel/apis/client-api-gateway/revisions/8824999a7a0a?raw)