minimusdocs
Help center

Providers

Match streams to provider channels

POST/streams/providers/links/match/

write Change: creates or edits. Scopes

Proposes a channel for each stream chosen, of one provider or any: the channel its sources play, else the channel of the same name, with whether linking would rename it. Nothing is saved: send the pairs you keep to "Link streams to provider channels". The totals count every stream; the first 2,000 pairs are listed. Streams are chosen by stream_ids, or by filter (the stream list's own filters, {} for every stream) less exclude. Panel operators who may change streams.

Body

  • stream_idsstring (uuid)[]
  • filterobject
  • excludestring (uuid)[]
  • providerintegercan be null

Response

200 OK

  • countintegerrequired

    Streams with a proposal.

  • by_sourceintegerrequired
  • ambiguousintegerrequired

    Streams whose sources play more than one channel.

  • by_nameintegerrequired
  • pairs_totalintegerrequired
  • name_differsintegerrequired
  • will_renameintegerrequired
  • cappedbooleanrequired

    More pairs than are listed.

  • pairsobject[]required
    • streamstring (uuid)required
    • stream_namestringrequired
    • providerintegerrequired
    • provider_namestringrequired
    • item_idstringrequired
    • item_namestringrequired
    • whystringrequired
      • source - source
      • name - name

      One of: "source" "name"

    • source_orderintegerrequiredcan be null
    • ambiguousbooleanrequired
    • replacesbooleanrequired

      It follows another channel now.

    • name_differsbooleanrequired
    • will_renamebooleanrequired

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