Songlist API

Version: 2.0.0

Export

Download

Download JSONDownload YAML

Copy URL

delete/queue/{queueId}/requests/{requestId}

Remove a request from a queue entry

Authorization

Required scopes

  • streamer.queue.writeWrite streamer queue

Parameters

NameInTypeRequiredDescription
queueIdpathintegerYes-
requestIdpathintegerYes-

Responses

200OK

application/json

Schema

DeleteQueueRequestResponseBody

$schemastring

A URL to the JSON Schema for this object.

queueQueueDetails
$schemastring

A URL to the JSON Schema for this object.

createdAtstringrequired
idintegerrequired
nonlistArtiststringrequired
nonlistSongstringrequired
nonlistTitlestringrequired
notestringrequired
positionintegerrequired
prioritystringrequired
requestsRequest[]required

Array items:

Request

amountnumberrequired
createdAtstringrequired
idintegerrequired
mineboolean
namestringrequired
requestTextstringrequired
sourcestringrequired
userRequestUserrequired
platformstringrequired
usernamestringrequired
songQueueSongrequired
albumArtstringrequired
artiststringrequired
attributesQueueSongAttribute[]required

Array items:

QueueSongAttribute

imagestringrequired
namestringrequired
capostringrequired
commentstringrequired
durationintegerrequired
hasChordsbooleanrequired
hasLyricsbooleanrequired
hasTabsbooleanrequired
isNewbooleanrequired
lastPlayedstringrequired
lastPlayedFromstringrequired
timesPlayedintegerrequired
titlestringrequired
songIdintegerrequired
streamerIdintegerrequired
queueDeletedbooleanrequired

Example

{
  "$schema": "https://example.com",
  "queue": {
    "$schema": "https://example.com",
    "createdAt": "2024-01-01T00:00:00Z",
    "id": 0,
    "nonlistArtist": "string",
    "nonlistSong": "string",
    "nonlistTitle": "string",
    "note": "string",
    "position": 0,
    "priority": "string",
    "requests": [
      {
        "amount": 0,
        "createdAt": "string",
        "id": 0,
        "mine": true,
        "name": "string",
        "requestText": "string",
        "source": "string",
        "user": {
          "platform": "string",
          "username": "string"
        }
      }
    ],
    "song": {
      "albumArt": "string",
      "artist": "string",
      "attributes": [
        {
          "image": "string",
          "name": "string"
        }
      ],
      "capo": "string",
      "comment": "string",
      "duration": 0,
      "hasChords": true,
      "hasLyrics": true,
      "hasTabs": true,
      "isNew": true,
      "lastPlayed": "2024-01-01T00:00:00Z",
      "lastPlayedFrom": "string",
      "timesPlayed": 0,
      "title": "string"
    },
    "songId": 0,
    "streamerId": 0
  },
  "queueDeleted": true
}
400Bad Request

application/problem+json

Schema

ErrorModel

$schemastring

A URL to the JSON Schema for this object.

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[]

Optional list of individual error details

Array items:

ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueunknown

The value at the given location

instancestring

A URI reference that identifies the specific occurrence of the problem.

statusinteger

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring

A URI reference to human-readable documentation for the error.

Example

{
  "$schema": "https://example.com",
  "detail": "string",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com",
  "status": 0,
  "title": "string",
  "type": "about:blank"
}
401Unauthorized

application/problem+json

Schema

ErrorModel

$schemastring

A URL to the JSON Schema for this object.

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[]

Optional list of individual error details

Array items:

ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueunknown

The value at the given location

instancestring

A URI reference that identifies the specific occurrence of the problem.

statusinteger

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring

A URI reference to human-readable documentation for the error.

Example

{
  "$schema": "https://example.com",
  "detail": "string",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com",
  "status": 0,
  "title": "string",
  "type": "about:blank"
}
403Forbidden

application/problem+json

Schema

ErrorModel

$schemastring

A URL to the JSON Schema for this object.

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[]

Optional list of individual error details

Array items:

ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueunknown

The value at the given location

instancestring

A URI reference that identifies the specific occurrence of the problem.

statusinteger

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring

A URI reference to human-readable documentation for the error.

Example

{
  "$schema": "https://example.com",
  "detail": "string",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com",
  "status": 0,
  "title": "string",
  "type": "about:blank"
}
404Not Found

application/problem+json

Schema

ErrorModel

$schemastring

A URL to the JSON Schema for this object.

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[]

Optional list of individual error details

Array items:

ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueunknown

The value at the given location

instancestring

A URI reference that identifies the specific occurrence of the problem.

statusinteger

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring

A URI reference to human-readable documentation for the error.

Example

{
  "$schema": "https://example.com",
  "detail": "string",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com",
  "status": 0,
  "title": "string",
  "type": "about:blank"
}
422Unprocessable Entity

application/problem+json

Schema

ErrorModel

$schemastring

A URL to the JSON Schema for this object.

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[]

Optional list of individual error details

Array items:

ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueunknown

The value at the given location

instancestring

A URI reference that identifies the specific occurrence of the problem.

statusinteger

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring

A URI reference to human-readable documentation for the error.

Example

{
  "$schema": "https://example.com",
  "detail": "string",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com",
  "status": 0,
  "title": "string",
  "type": "about:blank"
}
500Internal Server Error

application/problem+json

Schema

ErrorModel

$schemastring

A URL to the JSON Schema for this object.

detailstring

A human-readable explanation specific to this occurrence of the problem.

errorsErrorDetail[]

Optional list of individual error details

Array items:

ErrorDetail

locationstring

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

messagestring

Error message text

valueunknown

The value at the given location

instancestring

A URI reference that identifies the specific occurrence of the problem.

statusinteger

HTTP status code

titlestring

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

typestring

A URI reference to human-readable documentation for the error.

Example

{
  "$schema": "https://example.com",
  "detail": "string",
  "errors": [
    {
      "location": "string",
      "message": "string",
      "value": null
    }
  ],
  "instance": "https://example.com",
  "status": 0,
  "title": "string",
  "type": "about:blank"
}