Watch folders

List a watch folder's files

GET/vod/watch-folders/{id}/files/

read Read: looks, changes nothing. Scopes

What the folder found, newest first, 50 a page.

Path parameters

  • idstring (uuid)required

    The watch folder's id.

Query parameters

  • kindstring

    One of: "episode" "movie"

  • pageinteger
  • page_sizeinteger

    At most 200.

  • searchstring

    Matches the name or the path.

  • statestring

    A file state, needs_you (not found on TMDB, or failed), in_panel, no_details or missing; several with commas.

Response

200 OK

  • countintegerrequired
  • nextstring (uri)requiredcan be null
  • previousstring (uri)requiredcan be null
  • resultsobject[]required
    • idintegerrequiredread-only
    • refstringrequiredread-only
    • namestringrequiredread-only
    • size_bytesintegerrequiredread-only
    • modifiedstring (date-time)requiredread-onlycan be null
    • statestringrequiredread-only
    • kindstringrequiredread-only
    • notestringrequiredread-only
    • titleobjectrequiredread-onlycan be null
      • kindstringrequired
        • movie - movie
        • series - series

        One of: "movie" "series"

      • idstring (uuid)required
      • namestringrequired
    • without_detailsbooleanrequiredread-only

      In the panel under a title TMDB gave nothing for ("Find on TMDB" fills it).

    • missingbooleanrequiredread-only
    • tmdb_idstringrequiredread-only
    • as_isbooleanrequiredread-only
    • seen_atstring (date-time)requiredread-only
    • updated_atstring (date-time)requiredread-only

Errors

  • 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