post
https://api.trakt.tv/sync/history
🔒 OAuth Required
Add items to a user's watch history. Accepts shows, seasons, episodes and movies. If only a show is passed, all episodes for the show will be added. If seasons are specified, only episodes in those seasons will be added.
Send a watched_at UTC datetime to mark items as watched in the past. This is useful for syncing past watches from a media center.
IMPORTANTPlease be careful with sending duplicate data. We don't verify the
item+watched_atto ensure it's unique, it is up to your app to veify this and not send duplicate plays.
JSON POST Data
| Key | Type | Value |
|---|---|---|
movies | array | Array of movie objects. (see examples ->) |
shows | array | Array of show objects. |
seasons | array | Array of season objects. |
episodes | array | Array of episode objects. |
Media Object POST Data
| Key | Type | Value |
|---|---|---|
| item * | object | movie, show, or episode object. |
watched_at | datetime | UTC datetime when the item was watched. Set to released to automatically use the initial release date + runtime (episodes only). Set to unknown to mark the item as watched without a specific date. |
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…