---
title: "Create an entry (one per diary-day, §11.4) + its initial commit"
method: POST
path: "/entries"
tags: ["Entries"]
---

# Create an entry (one per diary-day, §11.4) + its initial commit

`POST /entries`

## Request

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

## Request body

- CreateEntryRequest
  - `diaryId` string, uuid, required
  - `occurredAt` string, date-time, required
  - `content` object, required
    - `format` 'plain' | 'markdown'
    - `body` string, required
    - `title` string, nullable
    - `mood` string, nullable
    - `location` string, nullable
    - `locationLat` number, nullable
    - `locationLng` number, nullable
    - `tags` string[]
    - `coverMediaAssetId` string, uuid, nullable
  - `media` object[]
    - `mediaAssetId` string, uuid, required
    - `caption` string, nullable
  - `commitMessage` string, nullable

## Response `201`

Created

- object
  - `data` object, required
    - `id` string, uuid, required
    - `headCommitId` string, uuid, nullable, required
  - `meta` object, required
    - `requestId` string, required

## Other responses

- `409`: An entry already exists for this diary-day (details.existingEntryId)

---

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