garden.lexicon.nourishing-earthworm.crepeWatch Documentation (EN)

main record

One viewing of a movie, or of a TV show, season or episode, in crepe's private diary. A watch with no rating and no review text is a plain play (for example an episode Plex reported) and stays out of the diary log.

Record Key tid Timestamp-based ID

Properties

containsSpoilers boolean Optional

No description available.

createdAt string datetime Required

When this record was created (not the watch time).

episodeNumber integer Optional

Required for episode watches.

minimum: 0

episodeTitle string Optional

No description available.

maxLength: 1000 bytes

episodeTmdbId string Optional

The episode's own TMDB id, when known.

maxLength: 32 bytes

genres array of string Optional

No description available.

maxLength: 20 items

imdbId string Optional

No description available.

maxLength: 32 bytes

kind string Required

What was watched.

Known values: movie, show, season, episode

mainCredit string Optional

No description available.

maxLength: 300 bytes

mainCreditRole string Optional

No description available.

Known values: director, creator

place ref #place Optional

Where it was watched: a movie theater from the Foursquare places catalog, or any place of the user's own ("Steve's house").

rating integer Optional

Half stars out of five, times two. Absent means unrated.

minimum: 1maximum: 10

releaseDate string Optional

Snapshot, YYYY-MM-DD.

maxLength: 32 bytes

rewatch boolean Optional

deprecated 2026-09-29: derived by readers, no longer written

seasonNumber integer Optional

Required for season and episode watches.

minimum: 0

source string Optional

Where this watch was first recorded.

Known values: crepe, plex, popfeed, letterboxd

stamps unknown Optional

Map of field group name to hybrid logical clock stamp, for field-level last-write-wins merge between devices and the sync server.

tags array of string Optional

No description available.

maxLength: 50 items

text string Optional

Review text, plain.

maxLength: 100000 bytesmaxGraphemes: 10000 graphemes

title string Optional

Snapshot of the movie or show title, for offline display.

maxLength: 1000 bytes

tmdbId string Required

TMDB id of the movie, or of the show for show, season and episode watches. Never an episode's own id.

maxLength: 32 bytes

updatedAt string datetime Required

An RFC 3339 formatted timestamp.

watchedAt string datetime Optional

When it was watched. Absent for a watch logged without a date.

View raw schema

{
  "description": "One viewing of a movie, or of a TV show, season or episode, in crepe's private diary. A watch with no rating and no review text is a plain play (for example an episode Plex reported) and stays out of the diary log.",
  "key": "tid",
  "record": {
    "properties": {
      "containsSpoilers": {
        "type": "boolean"
      },
      "createdAt": {
        "description": "When this record was created (not the watch time).",
        "format": "datetime",
        "type": "string"
      },
      "episodeNumber": {
        "description": "Required for episode watches.",
        "minimum": 0,
        "type": "integer"
      },
      "episodeTitle": {
        "maxLength": 1000,
        "type": "string"
      },
      "episodeTmdbId": {
        "description": "The episode's own TMDB id, when known.",
        "maxLength": 32,
        "type": "string"
      },
      "genres": {
        "items": {
          "maxLength": 100,
          "type": "string"
        },
        "maxLength": 20,
        "type": "array"
      },
      "imdbId": {
        "maxLength": 32,
        "type": "string"
      },
      "kind": {
        "description": "What was watched.",
        "knownValues": [
          "movie",
          "show",
          "season",
          "episode"
        ],
        "type": "string"
      },
      "mainCredit": {
        "maxLength": 300,
        "type": "string"
      },
      "mainCreditRole": {
        "knownValues": [
          "director",
          "creator"
        ],
        "type": "string"
      },
      "place": {
        "description": "Where it was watched: a movie theater from the Foursquare places catalog, or any place of the user's own (\"Steve's house\").",
        "ref": "#place",
        "type": "ref"
      },
      "rating": {
        "description": "Half stars out of five, times two. Absent means unrated.",
        "maximum": 10,
        "minimum": 1,
        "type": "integer"
      },
      "releaseDate": {
        "description": "Snapshot, YYYY-MM-DD.",
        "maxLength": 32,
        "type": "string"
      },
      "rewatch": {
        "description": "deprecated 2026-09-29: derived by readers, no longer written",
        "type": "boolean"
      },
      "seasonNumber": {
        "description": "Required for season and episode watches.",
        "minimum": 0,
        "type": "integer"
      },
      "source": {
        "description": "Where this watch was first recorded.",
        "knownValues": [
          "crepe",
          "plex",
          "popfeed",
          "letterboxd"
        ],
        "type": "string"
      },
      "stamps": {
        "description": "Map of field group name to hybrid logical clock stamp, for field-level last-write-wins merge between devices and the sync server.",
        "type": "unknown"
      },
      "tags": {
        "items": {
          "maxGraphemes": 64,
          "maxLength": 640,
          "type": "string"
        },
        "maxLength": 50,
        "type": "array"
      },
      "text": {
        "description": "Review text, plain.",
        "maxGraphemes": 10000,
        "maxLength": 100000,
        "type": "string"
      },
      "title": {
        "description": "Snapshot of the movie or show title, for offline display.",
        "maxLength": 1000,
        "type": "string"
      },
      "tmdbId": {
        "description": "TMDB id of the movie, or of the show for show, season and episode watches. Never an episode's own id.",
        "maxLength": 32,
        "type": "string"
      },
      "updatedAt": {
        "format": "datetime",
        "type": "string"
      },
      "watchedAt": {
        "description": "When it was watched. Absent for a watch logged without a date.",
        "format": "datetime",
        "type": "string"
      }
    },
    "required": [
      "kind",
      "tmdbId",
      "createdAt",
      "updatedAt"
    ],
    "type": "object"
  },
  "type": "record"
}

place object

No description available.

Properties

address string Optional

One-line address snapshot, for display.

maxLength: 5000 bytesmaxGraphemes: 500 graphemes

fsqPlaceId string Optional

Foursquare OS Places id when the place came from the catalog. Absent for a place of the user's own.

maxLength: 64 bytes

latitude string Optional

Decimal degrees as a string, like community.lexicon.location.geo.

maxLength: 32 bytes

longitude string Optional

No description available.

maxLength: 32 bytes

name string Required

Display name. A theater's catalog name, or whatever the user typed.

maxLength: 3000 bytesmaxGraphemes: 300 graphemes

View raw schema

{
  "properties": {
    "address": {
      "description": "One-line address snapshot, for display.",
      "maxGraphemes": 500,
      "maxLength": 5000,
      "type": "string"
    },
    "fsqPlaceId": {
      "description": "Foursquare OS Places id when the place came from the catalog. Absent for a place of the user's own.",
      "maxLength": 64,
      "type": "string"
    },
    "latitude": {
      "description": "Decimal degrees as a string, like community.lexicon.location.geo.",
      "maxLength": 32,
      "type": "string"
    },
    "longitude": {
      "maxLength": 32,
      "type": "string"
    },
    "name": {
      "description": "Display name. A theater's catalog name, or whatever the user typed.",
      "maxGraphemes": 300,
      "maxLength": 3000,
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}