From 1aa7f706609acf7c0be894559fda36651a35733c Mon Sep 17 00:00:00 2001 From: Daenney Date: Mon, 23 Dec 2024 16:43:50 +0100 Subject: [chore] Stub /api/v1/announcements implementation (#3630) * [chore] Stub /api/v1/announcements implementation This implements the /api/v1/announcements endpoint by simply returning an empty array. This indicates there are no instance announcements. Some clients retrieve this endpoint and get surprised by a 404. It tends to be harmless, but results in some unnecessary logging when trying to debug other things. * [fix] Forgot some swagger * [fix] Fix swagger some more --- docs/api/swagger.yaml | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) (limited to 'docs/api') diff --git a/docs/api/swagger.yaml b/docs/api/swagger.yaml index d10aa5daa..81b32bb72 100644 --- a/docs/api/swagger.yaml +++ b/docs/api/swagger.yaml @@ -6745,6 +6745,34 @@ paths: summary: View instance rule with the given id. tags: - admin + /api/v1/announcements: + get: + description: 'THIS ENDPOINT IS CURRENTLY NOT FULLY IMPLEMENTED: it will always return an empty array.' + operationId: announcementsGet + produces: + - application/json + responses: + "200": + description: "" + schema: + items: + type: object + maxItems: 0 + type: array + "400": + description: bad request + "401": + description: unauthorized + "406": + description: not acceptable + "500": + description: internal server error + security: + - OAuth2 Bearer: + - read:announcements + summary: Get an array of currently active announcements. + tags: + - announcements /api/v1/apps: post: consumes: -- cgit v1.2.3