action britbox_get_next_playback_item {
  label: "getNextPlaybackItem"
  description: "Returns the next item to play given a source item id.\n\nFor an unwatched show it returns the first episode available to the account.\n\nFor a watched show it returns the last incompletely watched episode by the profile,\nor the episode that immediately follows the last completely watched episode \nor nothing.\n\nFor an episode it always returns the immediately following episode, if available to\nthe account, or nothing.\n\nIf the response does not contain a `next` property then no item was found.\n"
  provider: britbox
  method: GET
  path: "/account/profile/items/{itemId}/next"
  encoding: json
  input: {
    type: "object"
    properties: {
      expand: {
        type: "string"
        enum: ["parent", "ancestors"]
      }
      itemId: {
        type: "string"
      }
      max_rating: {
        type: "string"
      }
    }
    required: ["itemId"]
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["sourceItemId"]
    properties: {
      firstWatchedDate: {
        type: "string"
        format: "date-time"
        description: "Time when the item corresponding to the itemId passed in by the client was\nfirst watched by the user. Will be `undefined` if the user has never\nwatched the item.\n\nIt can be used to identify the scenario where the user has never watched a\nshow and we are suggesting they watch the first episode (i.e. it is\nmissing in this scenario)\n\n**This will only be populated when a `showId` is passed in**\n"
      }
      lastWatchedDate: {
        type: "string"
        format: "date-time"
        description: "Time when the item corresponding to the itemId passed in by the client was\nlast watched by the user. Will be `undefined` if the user has never\nwatched the item.\n\nIt can be used to identify the scenario where the user has never watched a\nshow and we are suggesting they watch the first episode (i.e. it is\nmissing in this scenario)\n\n**This will only be populated when a `showId` is passed in**\n"
      }
      next: {
        type: "object"
      }
      sourceItemId: {
        type: "string"
        description: "The id of the item used to determine the next item to play."
      }
      suggestionType: {
        type: "string"
        description: "Field indicating the type or reason behind the suggestion.\n\nId Type   | Show Watched Status| Value            | Description\n----------|--------------------|------------------|---------------------------------\nshowId    | Unwatched          | StartWatching    |\nshowId    | Completely watched | RestartWatching  |\nshowId    | Partly watched     | ContinueWatching | Suggested episode partly watched\nshowId    | Partly watched     | Sequential       | Suggested episode unwatched\nepisodeId | Any                | Sequential       | Next episode in show\n"
        enum: ["StartWatching", "ContinueWatching", "RestartWatching", "Sequential", "None"]
      }
    }
    additionalProperties: false
  }
}