minimusdocs
Help center

TV shows

Fill a TV show from TMDB

POST/tv/series/{id}/tmdb-sync/

write Change: creates or edits. Scopes

Creates or updates every season and episode of the show from TMDB, each with its own details, in the background. seasons limits it to some season numbers; include_specials adds season 0. Answers 202 with the import, to follow on GET /tv/imports/{id}/. 400 when the show has no TMDB id or no TMDB key is set.

Path parameters

  • idstring (uuid)required

    The TV show's id.

Body

  • seasonsinteger[]
  • include_specialsboolean

    Default: false

Response

202 OK

  • idstring (uuid)requiredread-only
  • seriesstring (uuid)requiredread-only
  • series_namestringrequiredread-only
  • kindstringrequiredread-only
  • statusstringrequiredread-only
  • optionsanyrequiredread-only

    What the operator chose: delivery, node, bucket, seasons to sync, …

  • itemsanyrequiredread-only

    For a file import, one entry per file: where it is, which season and episode it is, and — once applied — the episode it landed on and what happened.

  • totalintegerrequiredread-only
  • doneintegerrequiredread-only
  • failedintegerrequiredread-only
  • messagestringrequiredread-only
  • errorsanyrequiredread-only

    The first problems met, each with the item it concerns. Bounded.

  • created_atstring (date-time)requiredread-only
  • updated_atstring (date-time)requiredread-only
  • started_atstring (date-time)requiredread-onlycan be null
  • finished_atstring (date-time)requiredread-onlycan be null

Errors

  • 400 Something sent is not valid. Each field that is wrong is named with what is wrong.
  • 401 No credential, or one that is wrong, expired or revoked.
  • 403 The account, or the key's or app's scopes, may not do this.
  • 404 Nothing with this id, or nothing the account can see.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means