minimusdocs
Help center

Playlist imports

Upload a playlist to import

POST/streams/m3u-imports/

write Change: creates or edits. Scopes

Step one of an import: send the M3U file (playlist_file) or its text (playlist_text). The panel reads it in the background: poll the import until status is parsed, then choose its groups and options with start.

Body

Sent as multipart/form-data.

  • playlist_filestring (binary)
  • playlist_textstring
  • filenamestring

Response

202 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

  • 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