Document CAS on POST /state

This commit is contained in:
Reid 'arrdem' McKenzie 2021-08-14 11:05:44 -06:00
parent 98a944cac2
commit f3e4a0c69d

View file

@ -94,10 +94,12 @@ $ curl -X GET $JOBQ/api/v0/job/1 | jq .
``` ```
### POST /api/v0/job/<job_id>/state ### POST /api/v0/job/<job_id>/state
Alter the state of a given job, appending a state change event to the log and returning the entire updated job. POST the 'current' state, and a proposed new state, attempting to update the state of the job using CAS.
If the state of the job updates successfully, a new event will be appended to the job's log and the resulting job will be returned.
Otherwise a conflict will be signaled.
``` shell ``` shell
$ curl -X POST $JOBQ/api/v0/job/1/state --data '["ASSIGNED"]' | jq . $ curl -X POST $JOBQ/api/v0/job/1/state --data '{"new": ["ASSIGNED"], "old": ["CREATED"]}' | jq .
{ {
"id": 1, "id": 1,
"payload": { "payload": {