---
title: "Itinerary Legs"
method: POST
path: "/trips/{trip_id}/itinerary/legs"
tags: ["itinerary"]
---

# Itinerary Legs

`POST /trips/{trip_id}/itinerary/legs`

## Request

- Base URL: `https://stardrift.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://stardrift.ai/trips/{trip_id}/itinerary/legs`
- Auth: none declared

Road or footpath lines between the given pairs of the trip's places, in
the order asked. Pairs Valhalla cannot route are left out.

## Path parameters

- `trip_id` string, required

## Request body

- ItineraryLegsRequest
  - `legs` LegRequest[], required
    - `from_item_id` string, required
    - `to_item_id` string, required
    - `mode` 'walk' | 'drive', required

## Response `200`

Successful Response

- ItineraryLegsResponse
  - `legs` ItineraryLeg[], required
    - `from_item_id` string, required
    - `to_item_id` string, required
    - `mode` 'walk' | 'drive', required
    - `polyline` string, required
    - `seconds` integer, required
    - `meters` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-09** `c3802252fcff`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/stardrift/apis/stardrift-api/changes/trips/:trip_id/itinerary/legs/post.md)

---

[API](https://skmtc.dev/stardrift/apis/stardrift-api.md) - [All operations](https://skmtc.dev/stardrift/apis/stardrift-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stardrift/apis/stardrift-api/revisions/be9ed1e6c38a?raw)