🔒 OAuth Required
Check into a movie or episode. This should be tied to a user action to manually indicate they are watching something. The item will display as watching on the site, then automatically switch to watched status once the duration has elapsed. A unique history id (64-bit integer) will be returned and can be used to reference this checkin directly.
JSON POST Data
| Key | Type | Value |
|---|---|---|
| item * | object | movie or episode object. (see examples ->) |
sharing | object | Control sharing to any connected social networks. (see below ↓) |
message | string | Message used for sharing. If not sent, it will use the watching string in the user settings. |
Sharing
The sharing object is optional and will apply the user's settings if not sent. If sharing is sent, each key will override the user's setting for that social network. Send true to post or false to not post on the indicated social network. You can see which social networks a user has connected with the /users/settings method.
| Key | Type |
|---|---|
twitter | boolean |
mastodon | boolean |
tumblr | boolean |
NoteIf a checkin is already in progress, a
409HTTP status code will returned. The response will contain anexpires_attimestamp which is when the user can check in again.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||