Avoid deeply nested routes

text

Avoid: /orgs/{orgId}/teams/{teamId}/projects/{projectId}/tickets/{ticketId}/comments

Explanation

Very deep routes make identity, authorization, and caching rules harder to reason about.

Learn the surrounding workflow

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

Same sheet · prioritizing Anti-patterns

Avoid route names that duplicate the HTTP method.

Open In sheettextsame section

Use HTTP status codes meaningfully.

Open In sheettextsame section

Keep API models stable and intentional.

Open In sheettextsame section

Version or phase in incompatible changes.

Open In sheettextsame section

Use the same top-level response structure across endpoints.

Open In sheettext1 tag match

Make support and debugging easier.

Open In sheethttp1 tag match