Last.fm is disabling API Keys for non-paid accounts December 1st.Learn More
Requeue Bulk Plays
POST
/api/components/{id}/plays/queue
const url = 'https://example.com/api/components/example/plays/queue';const options = { method: 'POST', headers: { cookie: 'ms.session_token=<ms.session_token>', 'Content-Type': 'application/json' }, body: '{"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}}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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 } }'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”id
required
string
Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
context
Queue Context
object
transform
boolean
dupeCheck
boolean
useCache
boolean
reason
string
isRetry
boolean
filters
required
object
state
Array<string>
stateNot
Array<string>
seenAt
One of:
Date Comparison
object
type
required
string
date
required
ISO8601 timestamp
string format: date-time
Date Range
object
type
required
string
range
required
array
inclusive
Include the range boundaries, defaults to true
boolean | string
playedAt
One of:
Date Comparison
object
type
required
string
date
required
ISO8601 timestamp
string format: date-time
Date Range
object
type
required
string
range
required
array
inclusive
Include the range boundaries, defaults to true
boolean | string
queues
Array<object>
object
queueName
required
string
queueStatus
required
Any of:
string
Array<string>
retries
Only match queue states with retries less than or equal to this
integer
uid
Array<string>
text
Match text in track title, artists or album name
Array<string>
sort
string
order
string
with
Array<string>
limit
integer
offset
integer
Responses
Section titled “Responses”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
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"}