Endpoints

Destinations

Performing a GET operation on /destinations will give you a list of valid MIDI devices on your system to use. Curl example, assuming you're running goseq with defaults:

curl localhost:4000/destinations

This returns ["IAC Bus 2","Bus 1"] on my Macbook.

Control

Performing POST operations on /control or /control/<sequence ID will start/stop the master clock or the given sequence. Examples:

curl -X POST -d "start" localhost:4000/control #starts the master clock

curl -X POST -d "destroy" localhost:4000/control/3 #stops and deletes the sequence with ID 3

curl -X POST -d "stop" localhost:4000/control/mySequence #stops only the sequence with ID "mySequence"

Seq

Performing POST operations on /seq/<sequence ID will create or replace sequences. You must supply a sequence ID as goseq performs no ID generation. I decided to leave out ID generation so that UI designers/implementers could pursue whatever scheme they'd like (e.g. intstrument1-seq1 if you wanted a column oriented UI somewhat like Ableton Live). Example:

curl -X POST -d @sample_json/simple-seq.json localhost:4000/seq/my-sequence