---
title: "Plan a multi-day itinerary (Pro)"
method: POST
path: "/diaries/{diaryId}/planner"
tags: ["Diary features"]
---

# Plan a multi-day itinerary (Pro)

`POST /diaries/{diaryId}/planner`

## Request

- Base URL: `https://whatareyoudo.ing/api/v1`
- URL: `https://whatareyoudo.ing/api/v1/diaries/{diaryId}/planner`
- Auth: HTTP bearer

Proposes days only. Nothing is written until the caller posts them back to /planner/scaffold.

## Path parameters

- `diaryId` string, uuid, required

## Request body

- PlanDiaryDaysRequest
  - `goal` string, required
  - `startDate` string, required
  - `endDate` string, required
  - `preferences` string, nullable

## Response `200`

OK

- object
  - `data` object, required
    - `days` PlannerDay[], required
      - `date` string, required
      - `title` string, required
      - `description` string, required
  - `meta` object, required
    - `requestId` string, required

## Other responses

- `402`: Pro is required
- `404`: No such diary, or not visible to the caller

---

[API](https://skmtc.dev/whatareyoudo/apis/whatcha-api.md) · [All operations](https://skmtc.dev/whatareyoudo/apis/whatcha-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whatareyoudo/apis/whatcha-api/revisions/48dd8a54abea?raw)