Invalid query parameter
For the complete documentation index, see llms.txt. For a full content snapshot, see llms-full.txt. Append .md to any kestra.io/docs/* URL for plain Markdown.

A query parameter the route requires is missing.

  • HTTP status — 400 Bad Request
  • type — https://kestra.io/docs/api-reference/problems/invalid-query-parameter

When you get it

  • A required query parameter is not sent.

A parameter that is present but carries a value the route cannot convert to its declared type is reported as invalid-argument instead: the conversion failure is raised before the parameter is judged missing.

Example response

A response reporting this problem:

{
  "type": "https://kestra.io/docs/api-reference/problems/invalid-query-parameter",
  "title": "Invalid query parameter",
  "status": 400,
  "detail": "Required query parameter 'namespace' is missing.",
  "instance": "/api/v1/main/flows/search"
}

How to handle it

Add or correct the parameter. The parameters each endpoint accepts, and their types, are in the OpenAPI schema.

For the members every problem document carries, see Problem Details.

Was this page helpful?