Sources

Move sources to a provider's new address

POST/streams/sources/replace-host/

write Change: creates or edits. Scopes

Rewrites the scheme, host and port of every source on from_host to to_base, keeping each path. With dry_run (the default) nothing is written: the answer says what would change. Running streams that are always on restart on the new address; on-demand streams use it from their next start. Movies played from that host move too for accounts that see the whole catalogue.

Body

  • from_hoststringrequired

    Hostname the sources point at now, e.g. old-provider.example. Matches http and https and any port; subdomains are not included.

  • to_basestringrequired

    Scheme and host to use instead, e.g. https://new-provider.example. Each source keeps its own path.

  • dry_runboolean

    Report what would change and write nothing.

    Default: true

Response

200 OK

  • from_hoststringrequired
  • to_basestringrequired
  • sourcesintegerrequired

    Sources that change.

  • streamsintegerrequired

    Streams using them.

  • running_restartedintegerrequired

    Running always-on streams that restart on the new address.

  • moviesintegerrequired
  • already_existingintegerrequired

    New addresses another source already has.

  • examplesobject[]required
    • fromstringrequired
    • tostringrequired
  • updated_sourcesinteger

    Real run only.

  • updated_moviesinteger

    Real run only.

  • restarted_streamsinteger

    Real run only.

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.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means