From 0dae4f273e2dd96fdda77de4e251013868aaca45 Mon Sep 17 00:00:00 2001 From: lrcarrera Date: Fri, 25 Sep 2026 15:27:37 +0200 Subject: [PATCH] Document 400 for unsupported flags[] values on GET /{version}/tours Companion to getyourguide/public-partner-api#2097, which rejects flags[] values outside the Flags enum with a 400 instead of ignoring them (or returning 503 when they were the only filter). Co-Authored-By: Claude Fable 5.1 --- spec/components/commons/query.yaml | 2 +- spec/paths/tours.yaml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/spec/components/commons/query.yaml b/spec/components/commons/query.yaml index 4b78ca3..f538d15 100644 --- a/spec/components/commons/query.yaml +++ b/spec/components/commons/query.yaml @@ -156,7 +156,7 @@ components: type: array flags: allowReserved: true - description: Various flags about properties of the tour (multiple selection allowed). + description: Various flags about properties of the tour (multiple selection allowed). Only the values listed in the Flags schema are accepted, matched exactly (case-sensitive). Requests containing any other value are rejected with a 400 response. examples: oneFlag: summary: Filter for private tours only. diff --git a/spec/paths/tours.yaml b/spec/paths/tours.yaml index c870002..ef6b200 100644 --- a/spec/paths/tours.yaml +++ b/spec/paths/tours.yaml @@ -45,7 +45,7 @@ paths: items: $ref: "../components/schema/tour.yaml#/components/schemas/Tour" 400: - description: Missing or invalid parameters, e.g. a 'q' value that contains no letters or numbers or exceeds 150 characters. + description: Missing or invalid parameters, e.g. a 'q' value that contains no letters or numbers or exceeds 150 characters, or a 'flags[]' value that is not one of the supported flags. 500: description: Server error