---
title: "Start a draft"
method: POST
path: "/entries/drafts"
tags: ["Entry drafts"]
---

# Start a draft

`POST /entries/drafts`

## Request

- Base URL: `https://whatareyoudo.ing/api/v1`
- URL: `https://whatareyoudo.ing/api/v1/entries/drafts`
- Auth: HTTP bearer

## Request body

- CreateEntryDraftRequest
  - `diaryId` string, uuid, required
  - `occurredAt` string, date-time, required
  - `content` DraftContent, nullable
    - `format` 'plain' | 'markdown'
    - `body` string
    - `title` string, nullable
    - `mood` string, nullable
    - `location` string, nullable
    - `tags` string[]
    - `coverMediaAssetId` string, uuid, nullable
  - `media` MediaRef[]
    - `mediaAssetId` string, uuid, required
    - `caption` string, nullable

## Response `201`

Created

- object
  - `data` EntryDraft, required
    - `id` string, uuid, required
    - `diaryId` string, uuid, required
    - `entryId` string, uuid, nullable, required
    - `occurredAt` string, nullable, required
    - `content` DraftContent, nullable, required
      - `format` 'plain' | 'markdown'
      - `body` string
      - `title` string, nullable
      - `mood` string, nullable
      - `location` string, nullable
      - `tags` string[]
      - `coverMediaAssetId` string, uuid, nullable
    - `media` MediaRef[], nullable, required
      - `mediaAssetId` string, uuid, required
      - `caption` string, nullable
    - `createdAt` string, required
    - `updatedAt` string, required
  - `meta` object, required
    - `requestId` string, required

---

[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)