entries

Update Entry

Update an entry's content, title, or other properties.

put/api/v1/entries/{entry_id}

Request

  • The document declares no server URL.
  • Auth: OAuth 2 (password, token URL /api/v1/auth/token)

Path parameters

entry_idstring uuid required

Cookies

access_tokenstring nullable

Request body

titlestring nullable
journal_idstring uuid nullable
is_draftboolean nullable
expected_updated_atstring date-time nullable

The entry's updated_at as the client last saw it. When given, the update is refused with 409 if the entry has changed since, so a save cannot silently discard an edit made on another device. Omit it for last-write-wins.

Response

Successful Response

created_atstring date-time required
updated_atstring date-time required
titlestring nullable
idstring uuid required
journal_idstring uuid required
moment_idstring uuid required
word_countinteger required
is_draftboolean
user_idstring uuid required
public_idstring nullable

Public URL-safe identifier (12 chars, generated on first publish)

slugstring nullable

URL slug generated from title (user-customizable)

is_publishedboolean

Whether this entry is publicly published

is_indexedboolean

Whether published entry should be indexed by search engines

content_plain_textstring nullable

Changes

No recorded changes to this operation across all 9 revisions of this API.