FIREANIME API
Browse API97 operations
POST

UpdateEpisodeLastSeen

UpdateEpisodeLastSeen records the user's current playback position within a specific episode.

/api.v1.watch.WatchService/UpdateEpisodeLastSeen Bearer required
01

Request

UpdateEpisodeLastSeenRequest

UpdateEpisodeLastSeenRequestapi.v1.watch.UpdateEpisodeLastSeenRequest8 fields

UpdateEpisodeLastSeenRequest contains new playback progress data.

slug
string

URL-friendly identifier for the anime.

season
string

Season identifier.

episode
string

Episode identifier.

positionPercent
float

Completion percentage (0.0 to 1.0).

positionSeconds
int32

Current playback position in seconds.

positionMax
int32

Total duration of the episode in seconds.

animeGroupIdoptional
uint32

Optional anime group context used when watching through a group route.

clientUpdatedAt
int64

Client-side Unix timestamp (seconds) used for local progress merge conflict resolution.

Request JSON
{
  "slug": "frieren",
  "season": "1",
  "episode": "1",
  "positionPercent": 1.5,
  "positionSeconds": 1,
  "positionMax": 1,
  "animeGroupId": 1,
  "clientUpdatedAt": "1"
}
02

Response

UpdateEpisodeLastSeenResponse

UpdateEpisodeLastSeenResponseapi.v1.watch.UpdateEpisodeLastSeenResponse1 fields

UpdateEpisodeLastSeenResponse confirms the update.

message
string

A descriptive message indicating the result.

Example response
{
  "message": "success"
}
03

Error handling

Common failure codes

unauthenticatedThe Bearer token is missing or invalid.

invalid_argumentThe request payload failed validation.

internalThe service could not complete the operation.