minimusdocs
Help center

Playlist imports

Get a playlist import

GET/streams/m3u-imports/{id}/

read Read: looks, changes nothing. Scopes

One import and its progress: poll it while the playlist is read and while the import runs.

Path parameters

  • idstring (uuid)required

    The playlist import's id.

Response

200 OK

  • idstring (uuid)requiredread-only
  • filenamestringrequiredread-only
  • statusstringrequiredread-only
  • group_summaryanyrequiredread-only

    [[group-title, channel count], …] as parsed from the upload.

  • selected_groupsanyrequiredread-only
  • optionsanyrequiredread-only

    The settings applied to every stream this import creates.

  • totalintegerrequiredread-only
  • createdintegerrequiredread-only
  • updatedintegerrequiredread-only
  • skippedintegerrequiredread-only
  • failed_countintegerrequiredread-only
  • started_countintegerrequiredread-only
  • total_channelsintegerrequiredread-only

    Channels in the playlist, before any group is left out.

  • processedintegerrequiredread-only

    Channels dealt with so far, whatever was done with them.

  • start_totalintegerrequiredread-only

    Streams waiting to be started a few at a time; started_count of them have started.

  • is_finishedbooleanrequiredread-only
  • messagestringrequiredread-only
  • warningsanyrequiredread-only
  • streams_countintegerrequiredread-only

    Streams that still carry this import's stamp — created or updated by it, and not deleted since.

  • created_by_usernamestringrequiredread-only
  • created_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