/courses/{course}/contacts

Collection/Resource/Sub-Collection

GET

Returns the entire collection

Returns all the contacts of the given course

POST

Create a new course contact resource for the given course and returns the newly inserted ID.

PUT

• Uncommon to use with a collection.

• It is implied that this would replace the entire contacts collection.

Use with extreme care.

PATCH

• Very uncommon and limited in viable use cases.

• This would imply updating a subset of data (e.g ::firstOrCreate).

• Scenarios which would use PATCH are more varied than PUT/POST.

For example, reordering a large dataset (faster than looping PUT requests).

Use with extreme care, consider more readable alternative routing expressions.

DELETE

Deletes the entire collection.

Deletes all contacts belonging to a given course.

Use with extreme care.