previous

🟡 Incomplete

This API's output may have additions in the future.

Set the current Song to the previous in the queue.

If threshold is not specified, the previous_threshold config option will be used.

Inputs

FieldTypeDescription
thresholdoptional (maybe-null) unsigned integerIf the current Song runtime (seconds) has passed this number, this method will reset the current Song instead of skipping backwards. Setting this to 0 will make this method always go to the previous Song.

Outputs

null if everything went ok.

Example Request

festival-cli previous --threshold 0

curl http://localhost:18425 -d '{"jsonrpc":"2.0","id":0,"method":"previous","params":{"threshold":0}}'

Example Response

{
  "jsonrpc": "2.0",
  "result": null, // <--- everything went ok.
  "id": 0
}