Retrieve all users:
index GET /users 200 - Returns all users
[301 - ?!?!]
Create a new user:
create POST /users 201 - User created, should return location header to new user
400 - Bad request
Update an existing user:
update PUT /users/:id 200 - User updated
301 - Moved permanently (new id)
404 - User not found
409 - Conflict
404 - User not found
410 - User not found (permanently!)
Delete an (existing) user:
delete DELETE /users/:id 200 - User deleted
204 - User deleted - No content
Show or retrieve an existing user:
show GET /users/:id 200 - User returned
301 - Moved permanently
404 - User not found
410 - User not found (permanently!)
Overall:
401 - Authorization Required
500 - Internal server error (limited use)
| Type | Idempotent | Safe |
|---|---|---|
| GET | Yes | Yes |
| PATCH | Yes | No |
| PUT | Yes | No |
| DELETE | Yes | No |
| POST | No | No |