Model the resource, not the action name.

Section: Route shape examples

Prefer nouns over verbs

text
text
Prefer:  POST /invoices
Avoid:   POST /createInvoice
Explanation

REST routes are usually clearer when they describe resources and let the HTTP method express the action.

Learn the surrounding workflow

Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.

Related commands

Same sheet · prioritizing Route shape examples
Use plural collection names
Keep collection naming consistent.
OpenIn sheettextsame section
Use stable path identifiers
Put stable IDs in the path.
OpenIn sheettextsame section
Represent actions carefully when needed
Use an action subresource only for non-CRUD workflows.
OpenIn sheettextsame section
List a collection
Fetch a list of users.
OpenIn sheethttp1 tag match
Create a resource
Create a new user in the collection.
OpenIn sheethttp1 tag match
Fetch a single resource
Read one user by identifier.
OpenIn sheethttp1 tag match