Skip to content

Commit e8e6665

Browse files
authored
fix(AIP-136): allow complex GET as POST (#1623)
1 parent 9ec1e25 commit e8e6665

1 file changed

Lines changed: 3 additions & 0 deletions

File tree

aip/general/0136.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,8 @@ services. The bullets below apply in all three cases.
5151
considered), a custom `CreateBookLongRunning` method could be introduced.
5252
- The HTTP method **must** be `GET` or `POST`:
5353
- `GET` **must** be used for methods retrieving data or resource state.
54+
- `POST` **may** be used for data retieval methods if the request payload could
55+
exceed URL size limitations, thus requiring a `body`.
5456
- `POST` **must** be used if the method has side effects or mutates resources
5557
or data.
5658
- The HTTP URI **must** use a `:` character followed by the custom verb
@@ -188,6 +190,7 @@ languages.
188190

189191
## Changelog
190192

193+
- **2026-06-09:** Allow complex GET to be POST if necessary.
191194
- **2025-05-12:** Extend disallowing prepositions rationale.
192195
- **2025-01-09:** Add original rationale for disallowing prepositions in names.
193196
- **2023-11-16:** Included link to AIP-127 "HTTP and gRPC Transcoding" for guidance on body definition.

0 commit comments

Comments
 (0)