Skip to content
Last.fm is disabling API Keys for non-paid accounts December 1st.Learn More

Requeue Bulk Plays

POST
/api/components/{id}/plays/queue
curl --request POST \
--url https://example.com/api/components/example/plays/queue \
--header 'Content-Type: application/json' \
--cookie ms.session_token=<ms.session_token> \
--data '{ "context": { "transform": true, "dupeCheck": true, "useCache": true, "reason": "example", "isRetry": true }, "filters": { "state": [ "queued" ], "stateNot": [ "queued" ], "seenAt": { "type": "eq", "date": "2026-11-13T14:05:00.000Z" }, "playedAt": { "type": "eq", "date": "2026-11-13T14:05:00.000Z" }, "queues": [ { "queueName": "ingress", "queueStatus": "completed", "retries": 1 } ], "uid": [ "example" ], "text": [ "example" ], "sort": "seenAt", "order": "asc", "with": [ "input" ], "limit": 1, "offset": 1 } }'
id
required
string
Media typeapplication/json
object
context
Queue Context
object
transform
boolean
dupeCheck
boolean
useCache
boolean
reason
string
isRetry
boolean
filters
required
object
state
Array<string>
Allowed values: queued discarded failed duped scrobbled discovered
stateNot
Array<string>
Allowed values: queued discarded failed duped scrobbled discovered
seenAt
One of:
Date Comparison
object
type
required
string
Allowed values: eq ne gt gte lt lte
date
required

ISO8601 timestamp

string format: date-time
/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d))|(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?)$/
playedAt
One of:
Date Comparison
object
type
required
string
Allowed values: eq ne gt gte lt lte
date
required

ISO8601 timestamp

string format: date-time
/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d))|(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?)$/
queues
Array<object>
object
queueName
required
string
Allowed values: ingress dead
queueStatus
required
Any of:
string
Allowed values: completed failed queued
retries

Only match queue states with retries less than or equal to this

integer
>= -9007199254740991 <= 9007199254740991
uid
Array<string>
text

Match text in track title, artists or album name

Array<string>
sort
string
Allowed values: seenAt playedAt
order
string
Allowed values: asc desc
with
Array<string>
Allowed values: input parent parent-input queues events children
limit
integer
>= -9007199254740991 <= 9007199254740991
offset
integer
>= -9007199254740991 <= 9007199254740991

Success

The request failed validation

Media typeapplication/json

The request’s body, query or params didn’t match the route’s schema

object
error
required
string
Allowed value: Validation failed
details
required

What was wrong, one entry per problem

Array<object>
object
message
required
string
path

Where the problem is, e.g. [“amount”] or [“items”, 0, “id”]

Array

Example

{
"error": "Validation failed"
}