Skip to content

Add TV Show Watch History

POST
/v1/tv/{id}/history

Only one of season_number and episode_number, or []episode_ids should be defined.
By default, if []episode_ids are used, this won't clear existing playback progress for
those episodes, however, this behavior might change in the future. For the season_number,
episode_number case, the current playback progress will be cleared if the watched_at is newer
than the existing playback progress.

Parameters

Path Parameters

id*

Media ID

Type
integer
Required

Request Body

application/json
JSON
{
  
"action_type": "string",
  
"episode_ids": [
  
  
0
  
],
  
"episode_number": 0,
  
"rewatch_id": 0,
  
"season_number": 0,
  
"watched_at": "string"
}

Responses

OK

application/json
JSON
{
  
"data": {
  
  
"inserted_episode_ids": [
  
  
  
0
  
  
],
  
  
"media_source": "string",
  
  
"skipped_episode_ids": [
  
  
  
0
  
  
]
  
},
  
"status": "success"
}

Playground

Variables
Key
Value
Body

Samples

Powered by VitePress OpenAPI