parameter_unknown
The request carries a parameter the endpoint does not accept: a filter outside its allowlist, a `sort` field that is not sortable, the offset-style `page` — v1 paginates by cursor — or a header that has been retired from v1.
| Code | Type | HTTP | Category |
|---|---|---|---|
parameter_unknown | invalid_request_error | 400 | Request |
Cause
The request carries a parameter the endpoint does not accept: a filter outside its allowlist, a sort field that is not sortable, the offset-style page — v1 paginates by cursor — or a header that has been retired from v1.
What to do
Read error.param and error.subcode: the first names the parameter or header that is not accepted, the second tells the causes apart; remove whatever it names. To page through a collection use limit together with starting_after or ending_before.
Related
All Request error codes
Causes and actions for errors in this category.
Error codes by category
Find an error by the category that emits it.
Full reference table
All codes, HTTP statuses, types and descriptions in one reference.
Error model
Interpret the error envelope and handle errors by code.