diff options
| author |  Vyr Cossont <vyr@noreply.codeberg.org> | 2025-11-11 19:39:09 +0100 |
|---|---|---|
| committer |  tobi <tobi.smethurst@protonmail.com> | 2025-11-17 14:15:04 +0100 |
| commit | 0c7b069c4a09f01a3a6c59bd7b66f096f8dcec40 (patch) | |
| tree | e5306d5ebad1e5a6efe5393bfafde95f5b94b237 | |
| parent | [performance] remove hard reliance on .Cached field to indicate whether media... (diff) | |
| download | gotosocial-0c7b069c4a09f01a3a6c59bd7b66f096f8dcec40.tar.xz | |
[chore] Apply schema for OpenAPI errors (#4511)
Adds an error struct to Swagger covering normal and OAuth errors for client API endpoints. Now clients using Swagger codegen can handle errors.
Specifically, if you _don't_ have typed errors in your Swagger IDL and you're using `go-swagger` to generate your API client, the error message is discarded and you are only told the status code. With this change in place, clients like `slurp` can tell the user that they tried to upload an emoji that was too big or whatever.
Reviewed-on: https://codeberg.org/superseriousbusiness/gotosocial/pulls/4511
Reviewed-by: tobi <kipvandenbos@noreply.codeberg.org>
Co-authored-by: Vyr Cossont <vyr@noreply.codeberg.org>
Co-committed-by: Vyr Cossont <vyr@noreply.codeberg.org>
211 files changed, 4607 insertions, 16 deletions
diff --git a/docs/api/swagger.yaml b/docs/api/swagger.yaml index 3454364a1..8425e46ed 100644 --- a/docs/api/swagger.yaml +++ b/docs/api/swagger.yaml @@ -920,7 +920,8 @@ definitions: x-go-name: RedirectURI redirect_uris: description: Post-authorization redirect URIs for the application (OAuth2). - example: '[https://example.org/callback?some=query]' + example: + - https://example.org/callback?some=query items: type: string type: array @@ -1422,6 +1423,24 @@ definitions: type: object x-go-name: EmojiCategory x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model + error: + properties: + error: + description: |- + Error is usually a human-readable description of the error. + + For OAuth-related errors, it will be one of the codes listed in + <https://datatracker.ietf.org/doc/html/rfc6749#section-5.2>. + type: string + x-go-name: Error + error_description: + description: ErrorDescription is only used for OAuth errors, and is a human-readable description of the error. + type: string + x-go-name: ErrorDescription + title: Error is a generic public-facing API error. + type: object + x-go-name: Error + x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model field: properties: name: @@ -3983,12 +4002,20 @@ paths: $ref: '#/definitions/attachment' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "422": description: unprocessable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:media @@ -4080,14 +4107,24 @@ paths: $ref: '#/definitions/searchResult' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:search @@ -4144,16 +4181,28 @@ paths: $ref: '#/definitions/oauthToken' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "422": description: Unprocessable. Your account creation request cannot be processed because either too many accounts have been created on this instance in the last 24h, or the pending account backlog is full. + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Application: - write:accounts @@ -4178,14 +4227,24 @@ paths: $ref: '#/definitions/account' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -4210,14 +4269,24 @@ paths: $ref: '#/definitions/accountRelationship' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:blocks @@ -4245,14 +4314,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -4297,14 +4376,24 @@ paths: $ref: '#/definitions/accountRelationship' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:follows @@ -4363,14 +4452,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -4429,14 +4528,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -4463,14 +4572,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:lists @@ -4506,16 +4625,28 @@ paths: $ref: '#/definitions/accountRelationship' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden to moved accounts + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:mutes @@ -4547,14 +4678,24 @@ paths: $ref: '#/definitions/accountRelationship' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:accounts @@ -4624,14 +4765,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:statuses @@ -4656,14 +4807,24 @@ paths: $ref: '#/definitions/accountRelationship' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:blocks @@ -4688,14 +4849,24 @@ paths: $ref: '#/definitions/accountRelationship' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:follows @@ -4721,14 +4892,24 @@ paths: $ref: '#/definitions/accountRelationship' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:mutes @@ -4760,16 +4941,28 @@ paths: $ref: '#/definitions/account' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "422": description: Unprocessable. Check the response body for more details. + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:accounts @@ -4792,14 +4985,24 @@ paths: description: The account deletion has been accepted and the account will be deleted. "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:accounts @@ -4824,14 +5027,24 @@ paths: $ref: '#/definitions/account' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -4859,16 +5072,28 @@ paths: description: The account move has been accepted and the account will be moved. "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "422": description: Unprocessable. Check the response body for more details. + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:accounts @@ -4898,14 +5123,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -4960,14 +5195,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -4988,14 +5233,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -5154,14 +5409,24 @@ paths: $ref: '#/definitions/account' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:accounts @@ -5180,14 +5445,24 @@ paths: $ref: '#/definitions/account' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -5302,16 +5577,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read:accounts @@ -5336,16 +5623,28 @@ paths: $ref: '#/definitions/adminAccountInfo' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read:accounts @@ -5379,18 +5678,32 @@ paths: description: OK "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: 'Conflict: There is already an admin action running that conflicts with this action. Check the error message in the response body for more information. This is a temporary error; it should be possible to process this action if you try again in a bit.' + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write:accounts @@ -5415,16 +5728,28 @@ paths: $ref: '#/definitions/adminAccountInfo' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write:accounts @@ -5461,16 +5786,28 @@ paths: $ref: '#/definitions/adminAccountInfo' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write:accounts @@ -5541,16 +5878,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read:custom_emojis @@ -5586,18 +5935,32 @@ paths: $ref: '#/definitions/emoji' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict -- shortcode for this emoji is already in use + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write:custom_emojis @@ -5628,16 +5991,28 @@ paths: $ref: '#/definitions/adminEmoji' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write:custom_emojis @@ -5661,16 +6036,28 @@ paths: $ref: '#/definitions/adminEmoji' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read:custom_emojis @@ -5733,16 +6120,28 @@ paths: $ref: '#/definitions/adminEmoji' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write:custom_emojis @@ -5763,16 +6162,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read:custom_emojis @@ -5798,14 +6209,24 @@ paths: $ref: '#/definitions/debugAPUrlResponse' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -5823,14 +6244,24 @@ paths: description: All good baby! "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -5856,16 +6287,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read:domain_allows @@ -5917,18 +6360,32 @@ paths: $ref: '#/definitions/domainPermission' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: 'Conflict: There is already an admin action running that conflicts with this action. Check the error message in the response body for more information. This is a temporary error; it should be possible to process this action if you try again in a bit.' + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write:domain_allows @@ -5953,18 +6410,32 @@ paths: $ref: '#/definitions/domainPermission' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: 'Conflict: There is already an admin action running that conflicts with this action. Check the error message in the response body for more information. This is a temporary error; it should be possible to process this action if you try again in a bit.' + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write:domain_allows @@ -5988,16 +6459,28 @@ paths: $ref: '#/definitions/domainPermission' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read:domain_allows @@ -6035,16 +6518,28 @@ paths: $ref: '#/definitions/domainPermission' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write:domain_allows @@ -6070,16 +6565,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read:domain_blocks @@ -6131,18 +6638,32 @@ paths: $ref: '#/definitions/domainPermission' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: 'Conflict: There is already an admin action running that conflicts with this action. Check the error message in the response body for more information. This is a temporary error; it should be possible to process this action if you try again in a bit.' + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write:domain_blocks @@ -6167,18 +6688,32 @@ paths: $ref: '#/definitions/domainPermission' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: 'Conflict: There is already an admin action running that conflicts with this action. Check the error message in the response body for more information. This is a temporary error; it should be possible to process this action if you try again in a bit.' + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write:domain_blocks @@ -6202,16 +6737,28 @@ paths: $ref: '#/definitions/domainPermission' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read:domain_blocks @@ -6249,16 +6796,28 @@ paths: $ref: '#/definitions/domainPermission' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write:domain_blocks @@ -6299,18 +6858,32 @@ paths: $ref: '#/definitions/adminActionResponse' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: 'Conflict: There is already an admin action running that conflicts with this action. Check the error message in the response body for more information. This is a temporary error; it should be possible to process this action if you try again in a bit.' + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -6377,16 +6950,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read @@ -6428,16 +7013,28 @@ paths: $ref: '#/definitions/domainPermission' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -6462,14 +7059,24 @@ paths: $ref: '#/definitions/domainPermission' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read @@ -6502,16 +7109,28 @@ paths: $ref: '#/definitions/domainPermission' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -6544,16 +7163,28 @@ paths: $ref: '#/definitions/domainPermission' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -6612,16 +7243,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read @@ -6655,16 +7298,28 @@ paths: $ref: '#/definitions/domainPermission' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -6689,16 +7344,28 @@ paths: $ref: '#/definitions/domainPermission' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -6722,14 +7389,24 @@ paths: $ref: '#/definitions/domainPermission' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read @@ -6788,16 +7465,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read @@ -6868,16 +7557,28 @@ paths: $ref: '#/definitions/domainPermissionSubscription' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -6946,16 +7647,28 @@ paths: $ref: '#/definitions/domainPermissionSubscription' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -6980,14 +7693,24 @@ paths: $ref: '#/definitions/domainPermissionSubscription' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read @@ -7022,16 +7745,28 @@ paths: $ref: '#/definitions/domainPermissionSubscription' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -7062,16 +7797,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -7099,16 +7846,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read @@ -7142,18 +7901,32 @@ paths: description: Test email was sent. "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "422": description: An smtp occurred while the email attempt was in progress. Check the returned json for more information. The smtp error will be included, to help you debug communication with the smtp server. + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -7172,14 +7945,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin @@ -7217,12 +8000,20 @@ paths: $ref: '#/definitions/headerFilter' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -7243,14 +8034,24 @@ paths: description: Accepted "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -7272,14 +8073,24 @@ paths: $ref: '#/definitions/headerFilter' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read @@ -7298,14 +8109,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin @@ -7343,12 +8164,20 @@ paths: $ref: '#/definitions/headerFilter' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -7369,14 +8198,24 @@ paths: description: Accepted "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -7398,14 +8237,24 @@ paths: $ref: '#/definitions/headerFilter' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read @@ -7427,14 +8276,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read @@ -7461,16 +8320,28 @@ paths: $ref: '#/definitions/instanceRule' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -7497,16 +8368,28 @@ paths: $ref: '#/definitions/instanceRule' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -7530,14 +8413,24 @@ paths: $ref: '#/definitions/instanceRule' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read @@ -7570,16 +8463,28 @@ paths: $ref: '#/definitions/instanceRule' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -7610,16 +8515,28 @@ paths: description: Echos the number of days requested. The cleanup is performed asynchronously after the request completes. "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -7644,16 +8561,28 @@ paths: description: Request accepted and will be processed. Check the logs for progress / errors. "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -7720,14 +8649,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read:reports @@ -7752,14 +8691,24 @@ paths: $ref: '#/definitions/adminReport' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read:reports @@ -7794,14 +8743,24 @@ paths: $ref: '#/definitions/adminReport' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write:reports @@ -7824,12 +8783,20 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: [] summary: Get an array of currently active announcements. @@ -7879,14 +8846,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:applications @@ -7946,16 +8923,28 @@ paths: $ref: '#/definitions/application' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' summary: Register a new application on this instance. tags: - apps @@ -7977,14 +8966,24 @@ paths: $ref: '#/definitions/application' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:applications @@ -8008,14 +9007,24 @@ paths: $ref: '#/definitions/application' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:applications @@ -8067,14 +9076,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:blocks @@ -8114,10 +9133,16 @@ paths: type: array "401": description: unauthorized + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:bookmarks @@ -8141,16 +9166,28 @@ paths: $ref: '#/definitions/conversation' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "422": description: unprocessable content + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:conversations @@ -8202,14 +9239,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:statuses @@ -8235,14 +9282,24 @@ paths: description: conversation deleted "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:conversations @@ -8264,10 +9321,16 @@ paths: type: array "401": description: unauthorized + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:custom_emojis @@ -8284,10 +9347,16 @@ paths: description: CSV file of accounts that you block. "401": description: unauthorized + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:blocks @@ -8304,10 +9373,16 @@ paths: description: CSV file of accounts that follow you. "401": description: unauthorized + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -8324,10 +9399,16 @@ paths: description: CSV file of accounts that you follow. "401": description: unauthorized + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:follows @@ -8344,10 +9425,16 @@ paths: description: CSV file of lists. "401": description: unauthorized + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:lists @@ -8364,10 +9451,16 @@ paths: description: CSV file of accounts that you mute. "401": description: unauthorized + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:mutes @@ -8386,10 +9479,16 @@ paths: $ref: '#/definitions/accountExportStats' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -8435,14 +9534,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:favourites @@ -8464,14 +9573,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -8492,14 +9611,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:filters @@ -8574,20 +9703,36 @@ paths: $ref: '#/definitions/filterV1' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden to moved accounts + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict (duplicate keyword) + schema: + $ref: '#/definitions/error' "422": description: unprocessable content + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:filters @@ -8610,14 +9755,24 @@ paths: description: filter deleted "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:filters @@ -8641,14 +9796,24 @@ paths: $ref: '#/definitions/filterV1' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:filters @@ -8728,20 +9893,36 @@ paths: $ref: '#/definitions/filterV1' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden to moved accounts + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict (duplicate keyword) + schema: + $ref: '#/definitions/error' "422": description: unprocessable content + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:filters @@ -8793,14 +9974,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:follows @@ -8826,14 +10017,24 @@ paths: $ref: '#/definitions/accountRelationship' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:follows @@ -8858,14 +10059,24 @@ paths: $ref: '#/definitions/accountRelationship' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:follows @@ -8917,14 +10128,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:follows @@ -8969,14 +10190,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:follows @@ -9020,12 +10251,20 @@ paths: description: Upload accepted. "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write @@ -9044,8 +10283,12 @@ paths: $ref: '#/definitions/instanceV1' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal error + schema: + $ref: '#/definitions/error' summary: View instance information. tags: - instance @@ -9110,16 +10353,28 @@ paths: $ref: '#/definitions/instanceV1' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:write @@ -9141,16 +10396,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: [] summary: List explicitly allowed domains. @@ -9171,16 +10438,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: [] summary: List blocked domains. @@ -9232,16 +10511,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: [] summary: List peer domains. @@ -9262,12 +10553,20 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' summary: View instance rules (public). tags: - instance @@ -9283,10 +10582,16 @@ paths: $ref: '#/definitions/defaultPolicies' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -9425,14 +10730,24 @@ paths: $ref: '#/definitions/defaultPolicies' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "422": description: unprocessable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:accounts @@ -9500,14 +10815,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:notifications @@ -9532,14 +10857,24 @@ paths: $ref: '#/definitions/interactionRequest' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:notifications @@ -9564,14 +10899,24 @@ paths: $ref: '#/definitions/interactionRequest' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:statuses @@ -9596,14 +10941,24 @@ paths: $ref: '#/definitions/interactionRequest' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:statuses @@ -9624,14 +10979,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:lists @@ -9683,16 +11048,28 @@ paths: $ref: '#/definitions/list' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:lists @@ -9715,14 +11092,24 @@ paths: description: list deleted "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:lists @@ -9746,14 +11133,24 @@ paths: $ref: '#/definitions/list' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:lists @@ -9804,16 +11201,28 @@ paths: $ref: '#/definitions/list' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:lists @@ -9848,14 +11257,24 @@ paths: description: list accounts updated "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:lists @@ -9912,14 +11331,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:lists @@ -9953,14 +11382,24 @@ paths: description: list accounts updated "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:lists @@ -9990,10 +11429,16 @@ paths: $ref: '#/definitions/markers' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:statuses @@ -10022,12 +11467,20 @@ paths: $ref: '#/definitions/markers' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "409": description: conflict (when two clients try to update the same timeline at the same time) + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:statuses @@ -10051,14 +11504,24 @@ paths: $ref: '#/definitions/attachment' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:media @@ -10102,14 +11565,24 @@ paths: $ref: '#/definitions/attachment' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:media @@ -10161,14 +11634,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:mutes @@ -10193,14 +11676,24 @@ paths: $ref: '#/definitions/notification' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:notifications @@ -10282,14 +11775,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:notifications @@ -10309,14 +11812,24 @@ paths: type: object "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:notifications @@ -10341,16 +11854,28 @@ paths: $ref: '#/definitions/poll' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:statuses @@ -10382,18 +11907,32 @@ paths: $ref: '#/definitions/poll' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "422": description: unprocessable entity + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:statuses @@ -10427,14 +11966,24 @@ paths: type: object "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -10454,14 +12003,24 @@ paths: $ref: '#/definitions/account' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin @@ -10481,14 +12040,24 @@ paths: $ref: '#/definitions/account' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin @@ -10504,10 +12073,16 @@ paths: description: Push subscription deleted, or did not exist. "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - push @@ -10525,12 +12100,20 @@ paths: $ref: '#/definitions/webPushSubscription' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: This access token doesn't have an associated subscription. + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - push @@ -10645,16 +12228,28 @@ paths: $ref: '#/definitions/webPushSubscription' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - push @@ -10752,16 +12347,28 @@ paths: $ref: '#/definitions/webPushSubscription' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: This access token doesn't have an associated subscription. + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - push @@ -10824,14 +12431,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -10904,14 +12521,24 @@ paths: $ref: '#/definitions/report' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:reports @@ -10936,14 +12563,24 @@ paths: $ref: '#/definitions/report' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -10986,14 +12623,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:statuses @@ -11016,14 +12663,24 @@ paths: description: status canceled "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:statuses @@ -11047,14 +12704,24 @@ paths: $ref: '#/definitions/scheduledStatus' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:statuses @@ -11087,16 +12754,28 @@ paths: $ref: '#/definitions/scheduledStatus' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "422": description: unprocessable content + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:statuses @@ -11281,18 +12960,32 @@ paths: $ref: '#/definitions/status' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "422": description: unprocessable content + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:statuses @@ -11320,16 +13013,28 @@ paths: $ref: '#/definitions/status' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:statuses @@ -11353,16 +13058,28 @@ paths: $ref: '#/definitions/status' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:statuses @@ -11464,16 +13181,28 @@ paths: $ref: '#/definitions/status' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:statuses @@ -11498,16 +13227,28 @@ paths: $ref: '#/definitions/status' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:bookmarks @@ -11533,16 +13274,28 @@ paths: $ref: '#/definitions/threadContext' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:statuses @@ -11567,16 +13320,28 @@ paths: $ref: '#/definitions/status' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:favourites @@ -11603,16 +13368,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -11639,16 +13416,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:statuses @@ -11677,16 +13466,28 @@ paths: $ref: '#/definitions/status' "400": description: bad request; you're not part of the target status thread + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:mutes @@ -11716,16 +13517,28 @@ paths: $ref: '#/definitions/status' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:accounts @@ -11753,16 +13566,28 @@ paths: $ref: '#/definitions/status' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:statuses @@ -11789,12 +13614,20 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -11821,16 +13654,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:statuses @@ -11855,16 +13700,28 @@ paths: $ref: '#/definitions/status' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:bookmarks @@ -11889,16 +13746,28 @@ paths: $ref: '#/definitions/status' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:favourites @@ -11927,16 +13796,28 @@ paths: $ref: '#/definitions/status' "400": description: bad request; you're not part of the target status thread + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:mutes @@ -11961,16 +13842,28 @@ paths: $ref: '#/definitions/status' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:accounts @@ -11995,16 +13888,28 @@ paths: $ref: '#/definitions/status' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:statuses @@ -12107,8 +14012,12 @@ paths: type: object "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' schemes: - wss security: @@ -12133,10 +14042,16 @@ paths: type: array "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read @@ -12162,14 +14077,24 @@ paths: $ref: '#/definitions/tag' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: [] summary: Get details for a hashtag, including whether you currently follow it. @@ -12194,12 +14119,20 @@ paths: $ref: '#/definitions/tag' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:follows @@ -12225,14 +14158,24 @@ paths: $ref: '#/definitions/tag' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: unauthorized + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:follows @@ -12290,8 +14233,12 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:statuses @@ -12349,8 +14296,12 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:lists @@ -12408,8 +14359,12 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:statuses @@ -12469,8 +14424,12 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:statuses @@ -12523,8 +14482,12 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -12549,14 +14512,24 @@ paths: $ref: '#/definitions/tokenInfo' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -12581,14 +14554,24 @@ paths: $ref: '#/definitions/tokenInfo' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:accounts @@ -12611,6 +14594,8 @@ paths: type: array "406": description: not acceptable + schema: + $ref: '#/definitions/error' summary: Links that have been shared more than others. tags: - trends @@ -12630,6 +14615,8 @@ paths: type: array "406": description: not acceptable + schema: + $ref: '#/definitions/error' summary: Statuses that have been interacted with more than others. tags: - trends @@ -12649,6 +14636,8 @@ paths: type: array "406": description: not acceptable + schema: + $ref: '#/definitions/error' summary: View hashtags that are currently being used more frequently than usual. tags: - trends @@ -12664,14 +14653,24 @@ paths: $ref: '#/definitions/user' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -12698,16 +14697,28 @@ paths: description: QR code "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict + schema: + $ref: '#/definitions/error' "422": description: unprocessable entity + schema: + $ref: '#/definitions/error' "500": description: internal error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:accounts @@ -12738,16 +14749,28 @@ paths: description: QR code "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict + schema: + $ref: '#/definitions/error' "422": description: unprocessable entity + schema: + $ref: '#/definitions/error' "500": description: internal error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:accounts @@ -12770,16 +14793,28 @@ paths: description: QR code png "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict + schema: + $ref: '#/definitions/error' "422": description: unprocessable entity + schema: + $ref: '#/definitions/error' "500": description: internal error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -12802,16 +14837,28 @@ paths: description: QR code uri "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict + schema: + $ref: '#/definitions/error' "422": description: unprocessable entity + schema: + $ref: '#/definitions/error' "500": description: internal error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:accounts @@ -12847,16 +14894,28 @@ paths: $ref: '#/definitions/user' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: 'Conflict: desired email address already in use' + schema: + $ref: '#/definitions/error' "500": description: internal error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:accounts @@ -12896,16 +14955,28 @@ paths: description: Change successful "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "422": description: unprocessable request because instance is running with OIDC backend + schema: + $ref: '#/definitions/error' "500": description: internal error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:accounts @@ -12997,16 +15068,28 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - admin:read:accounts @@ -13027,14 +15110,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:filters @@ -13125,20 +15218,36 @@ paths: $ref: '#/definitions/filterV2' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden to moved accounts + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict (duplicate title, keyword, or status) + schema: + $ref: '#/definitions/error' "422": description: unprocessable content + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:filters @@ -13161,14 +15270,24 @@ paths: description: filter deleted "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:filters @@ -13192,14 +15311,24 @@ paths: $ref: '#/definitions/filterV2' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:filters @@ -13297,20 +15426,36 @@ paths: $ref: '#/definitions/filterV2' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden to moved accounts + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict (duplicate title, keyword, or status) + schema: + $ref: '#/definitions/error' "422": description: unprocessable content + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:filters @@ -13337,14 +15482,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:filters @@ -13390,20 +15545,36 @@ paths: $ref: '#/definitions/filterKeyword' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden to moved accounts + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict (duplicate keyword) + schema: + $ref: '#/definitions/error' "422": description: unprocessable content + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:filters @@ -13430,14 +15601,24 @@ paths: type: array "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:filters @@ -13473,20 +15654,36 @@ paths: $ref: '#/definitions/filterStatus' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden to moved accounts + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict (duplicate status) + schema: + $ref: '#/definitions/error' "422": description: unprocessable content + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:filters @@ -13509,14 +15706,24 @@ paths: description: filter keyword deleted "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:filters @@ -13540,14 +15747,24 @@ paths: $ref: '#/definitions/filterKeyword' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:filters @@ -13593,20 +15810,36 @@ paths: $ref: '#/definitions/filterKeyword' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden to moved accounts + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "409": description: conflict (duplicate keyword) + schema: + $ref: '#/definitions/error' "422": description: unprocessable content + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:filters @@ -13629,14 +15862,24 @@ paths: description: filter status deleted "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - write:filters @@ -13660,14 +15903,24 @@ paths: $ref: '#/definitions/filterStatus' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' security: - OAuth2 Bearer: - read:filters @@ -13686,8 +15939,12 @@ paths: $ref: '#/definitions/instanceV2' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal error + schema: + $ref: '#/definitions/error' summary: View instance information. tags: - instance @@ -13757,12 +16014,20 @@ paths: description: OK - If you own the provided token, the API call will provide OK and an empty response `{}`. This operation is idempotent, so calling this API multiple times will still return OK. "400": description: bad request + schema: + $ref: '#/definitions/error' "403": description: forbidden - If you provide a token you do not own, the API call will return a 403 error. + schema: + $ref: '#/definitions/error' "406": description: not acceptable + schema: + $ref: '#/definitions/error' "500": description: internal server error + schema: + $ref: '#/definitions/error' summary: Revoke an access token to make it no longer valid for use. tags: - oauth @@ -13811,12 +16076,20 @@ paths: $ref: '#/definitions/swaggerFeaturedCollection' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' summary: Get the featured collection (pinned posts) for a user. tags: - s2s/federation @@ -13857,12 +16130,20 @@ paths: $ref: '#/definitions/swaggerCollection' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' summary: Get the public outbox collection for an actor. tags: - s2s/federation @@ -13909,12 +16190,20 @@ paths: $ref: '#/definitions/swaggerCollection' "400": description: bad request + schema: + $ref: '#/definitions/error' "401": description: unauthorized + schema: + $ref: '#/definitions/error' "403": description: forbidden + schema: + $ref: '#/definitions/error' "404": description: not found + schema: + $ref: '#/definitions/error' summary: Get the replies collection for a status. tags: - s2s/federation diff --git a/internal/api/activitypub/users/featured.go b/internal/api/activitypub/users/featured.go index 021e5aeb9..8bd261eb7 100644 --- a/internal/api/activitypub/users/featured.go +++ b/internal/api/activitypub/users/featured.go @@ -58,12 +58,20 @@ import ( // schema: // "$ref": "#/definitions/swaggerFeaturedCollection" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found func (m *Module) FeaturedCollectionGETHandler(c *gin.Context) { // usernames on our instance are always lowercase diff --git a/internal/api/activitypub/users/outboxget.go b/internal/api/activitypub/users/outboxget.go index a76834ce0..bbb266dea 100644 --- a/internal/api/activitypub/users/outboxget.go +++ b/internal/api/activitypub/users/outboxget.go @@ -75,12 +75,20 @@ import ( // schema: // "$ref": "#/definitions/swaggerCollection" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found func (m *Module) OutboxGETHandler(c *gin.Context) { // usernames on our instance are always lowercase diff --git a/internal/api/activitypub/users/repliesget.go b/internal/api/activitypub/users/repliesget.go index facbbcc85..f5f27e750 100644 --- a/internal/api/activitypub/users/repliesget.go +++ b/internal/api/activitypub/users/repliesget.go @@ -82,12 +82,20 @@ import ( // schema: // "$ref": "#/definitions/swaggerCollection" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found func (m *Module) StatusRepliesGETHandler(c *gin.Context) { // usernames on our instance are always lowercase diff --git a/internal/api/auth/revoke.go b/internal/api/auth/revoke.go index c5167889c..e0a1de793 100644 --- a/internal/api/auth/revoke.go +++ b/internal/api/auth/revoke.go @@ -66,13 +66,21 @@ import ( // OK - If you own the provided token, the API call will provide OK and an empty response `{}`. // This operation is idempotent, so calling this API multiple times will still return OK. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '403': +// schema: +// "$ref": "#/definitions/error" // description: >- // forbidden - If you provide a token you do not own, the API call will return a 403 error. // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) TokenRevokePOSTHandler(c *gin.Context) { if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { diff --git a/internal/api/client/accounts/accountalias.go b/internal/api/client/accounts/accountalias.go index 51183bff7..ef802b5b1 100644 --- a/internal/api/client/accounts/accountalias.go +++ b/internal/api/client/accounts/accountalias.go @@ -64,16 +64,28 @@ import ( // schema: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: Unprocessable. Check the response body for more details. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountAliasPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/accountcreate.go b/internal/api/client/accounts/accountcreate.go index ef45c7529..d8da4470c 100644 --- a/internal/api/client/accounts/accountcreate.go +++ b/internal/api/client/accounts/accountcreate.go @@ -58,19 +58,31 @@ import ( // schema: // "$ref": "#/definitions/oauthToken" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: >- // Unprocessable. Your account creation request cannot be processed // because either too many accounts have been created on this instance // in the last 24h, or the pending account backlog is full. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountCreatePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/accountdelete.go b/internal/api/client/accounts/accountdelete.go index e7682b2ce..27f0a428d 100644 --- a/internal/api/client/accounts/accountdelete.go +++ b/internal/api/client/accounts/accountdelete.go @@ -56,14 +56,24 @@ import ( // '202': // description: "The account deletion has been accepted and the account will be deleted." // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountDeletePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/accountget.go b/internal/api/client/accounts/accountget.go index c28635a86..158748189 100644 --- a/internal/api/client/accounts/accountget.go +++ b/internal/api/client/accounts/accountget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/accountmove.go b/internal/api/client/accounts/accountmove.go index cdb2cdddb..d95462f07 100644 --- a/internal/api/client/accounts/accountmove.go +++ b/internal/api/client/accounts/accountmove.go @@ -61,16 +61,28 @@ import ( // '202': // description: The account move has been accepted and the account will be moved. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: Unprocessable. Check the response body for more details. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountMovePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/accountupdate.go b/internal/api/client/accounts/accountupdate.go index 58ba0dd2e..2514b2785 100644 --- a/internal/api/client/accounts/accountupdate.go +++ b/internal/api/client/accounts/accountupdate.go @@ -233,14 +233,24 @@ import ( // schema: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountUpdateCredentialsPATCHHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/accountverify.go b/internal/api/client/accounts/accountverify.go index dda3c10c6..d3722326f 100644 --- a/internal/api/client/accounts/accountverify.go +++ b/internal/api/client/accounts/accountverify.go @@ -45,14 +45,24 @@ import ( // schema: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountVerifyGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/block.go b/internal/api/client/accounts/block.go index 066ce0c31..3a625c671 100644 --- a/internal/api/client/accounts/block.go +++ b/internal/api/client/accounts/block.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountBlockPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/featuredtags.go b/internal/api/client/accounts/featuredtags.go index eae3fbdf1..12a91922b 100644 --- a/internal/api/client/accounts/featuredtags.go +++ b/internal/api/client/accounts/featuredtags.go @@ -57,14 +57,24 @@ import ( // items: // type: object // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountFeaturedTagsGETHandler(c *gin.Context) { _, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/follow.go b/internal/api/client/accounts/follow.go index e89cfc40f..886a87c58 100644 --- a/internal/api/client/accounts/follow.go +++ b/internal/api/client/accounts/follow.go @@ -80,14 +80,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountFollowPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/followers.go b/internal/api/client/accounts/followers.go index a813e9f00..4f9d611ff 100644 --- a/internal/api/client/accounts/followers.go +++ b/internal/api/client/accounts/followers.go @@ -108,14 +108,24 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountFollowersGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/following.go b/internal/api/client/accounts/following.go index 694e95ccd..1cb367224 100644 --- a/internal/api/client/accounts/following.go +++ b/internal/api/client/accounts/following.go @@ -108,14 +108,24 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountFollowingGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/lists.go b/internal/api/client/accounts/lists.go index 23a137533..dc918f0bc 100644 --- a/internal/api/client/accounts/lists.go +++ b/internal/api/client/accounts/lists.go @@ -58,14 +58,24 @@ import ( // items: // "$ref": "#/definitions/list" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountListsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/lookup.go b/internal/api/client/accounts/lookup.go index 03657a20a..87fcb762f 100644 --- a/internal/api/client/accounts/lookup.go +++ b/internal/api/client/accounts/lookup.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountLookupGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/mute.go b/internal/api/client/accounts/mute.go index e9884eafd..0a3b65a57 100644 --- a/internal/api/client/accounts/mute.go +++ b/internal/api/client/accounts/mute.go @@ -73,16 +73,28 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountMutePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/note.go b/internal/api/client/accounts/note.go index 2461487e8..f73a39c40 100644 --- a/internal/api/client/accounts/note.go +++ b/internal/api/client/accounts/note.go @@ -64,14 +64,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountNotePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/profile.go b/internal/api/client/accounts/profile.go index 6f9194ba9..17105d656 100644 --- a/internal/api/client/accounts/profile.go +++ b/internal/api/client/accounts/profile.go @@ -50,14 +50,24 @@ import ( // schema: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountAvatarDELETEHandler(c *gin.Context) { m.accountDeleteProfileAttachment(c, m.processor.Media().DeleteAvatar) @@ -85,14 +95,24 @@ func (m *Module) AccountAvatarDELETEHandler(c *gin.Context) { // schema: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountHeaderDELETEHandler(c *gin.Context) { m.accountDeleteProfileAttachment(c, m.processor.Media().DeleteHeader) diff --git a/internal/api/client/accounts/relationships.go b/internal/api/client/accounts/relationships.go index 33a8c20d9..81eda8559 100644 --- a/internal/api/client/accounts/relationships.go +++ b/internal/api/client/accounts/relationships.go @@ -62,14 +62,24 @@ import ( // items: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountRelationshipsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/search.go b/internal/api/client/accounts/search.go index 1c3166c29..4a86374ca 100644 --- a/internal/api/client/accounts/search.go +++ b/internal/api/client/accounts/search.go @@ -96,14 +96,24 @@ import ( // items: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountSearchGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/statuses.go b/internal/api/client/accounts/statuses.go index 9cfb7db85..2d712d554 100644 --- a/internal/api/client/accounts/statuses.go +++ b/internal/api/client/accounts/statuses.go @@ -123,14 +123,24 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountStatusesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/themesget.go b/internal/api/client/accounts/themesget.go index f1204e85e..06dcf9a7b 100644 --- a/internal/api/client/accounts/themesget.go +++ b/internal/api/client/accounts/themesget.go @@ -49,14 +49,24 @@ import ( // items: // "$ref": "#/definitions/theme" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountThemesGETHandler(c *gin.Context) { _, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/unblock.go b/internal/api/client/accounts/unblock.go index 0f725967f..9e111f86b 100644 --- a/internal/api/client/accounts/unblock.go +++ b/internal/api/client/accounts/unblock.go @@ -56,14 +56,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountUnblockPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, true, true, true, true) diff --git a/internal/api/client/accounts/unfollow.go b/internal/api/client/accounts/unfollow.go index 458232b73..f87f8aa9e 100644 --- a/internal/api/client/accounts/unfollow.go +++ b/internal/api/client/accounts/unfollow.go @@ -56,14 +56,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountUnfollowPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/accounts/unmute.go b/internal/api/client/accounts/unmute.go index eaee047f7..539fcfa11 100644 --- a/internal/api/client/accounts/unmute.go +++ b/internal/api/client/accounts/unmute.go @@ -58,14 +58,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountUnmutePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/accountaction.go b/internal/api/client/admin/accountaction.go index 290d80b71..ab68ed3ed 100644 --- a/internal/api/client/admin/accountaction.go +++ b/internal/api/client/admin/accountaction.go @@ -69,21 +69,35 @@ import ( // '200': // description: OK // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: >- // Conflict: There is already an admin action running that conflicts with this action. // Check the error message in the response body for more information. This is a temporary // error; it should be possible to process this action if you try again in a bit. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountActionPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/accountapprove.go b/internal/api/client/admin/accountapprove.go index f5838f9d9..521b247a6 100644 --- a/internal/api/client/admin/accountapprove.go +++ b/internal/api/client/admin/accountapprove.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/adminAccountInfo" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountApprovePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/accountget.go b/internal/api/client/admin/accountget.go index 75659777c..43f53887c 100644 --- a/internal/api/client/admin/accountget.go +++ b/internal/api/client/admin/accountget.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/adminAccountInfo" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/accountreject.go b/internal/api/client/admin/accountreject.go index d9651c792..50d4ef293 100644 --- a/internal/api/client/admin/accountreject.go +++ b/internal/api/client/admin/accountreject.go @@ -77,16 +77,28 @@ import ( // schema: // "$ref": "#/definitions/adminAccountInfo" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AccountRejectPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/accountsgetv1.go b/internal/api/client/admin/accountsgetv1.go index 3b3b5b783..06074db12 100644 --- a/internal/api/client/admin/accountsgetv1.go +++ b/internal/api/client/admin/accountsgetv1.go @@ -161,16 +161,28 @@ // items: // "$ref": "#/definitions/adminAccountInfo" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error package admin diff --git a/internal/api/client/admin/accountsgetv2.go b/internal/api/client/admin/accountsgetv2.go index 971ecf9b4..bc26e6cc8 100644 --- a/internal/api/client/admin/accountsgetv2.go +++ b/internal/api/client/admin/accountsgetv2.go @@ -134,16 +134,28 @@ // items: // "$ref": "#/definitions/adminAccountInfo" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error package admin diff --git a/internal/api/client/admin/debug_off.go b/internal/api/client/admin/debug_off.go index 667cf1be9..e412bfc88 100644 --- a/internal/api/client/admin/debug_off.go +++ b/internal/api/client/admin/debug_off.go @@ -63,14 +63,24 @@ import ( // schema: // "$ref": "#/definitions/debugAPUrlResponse" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DebugAPUrlHandler(c *gin.Context) {} @@ -95,13 +105,23 @@ func (m *Module) DebugAPUrlHandler(c *gin.Context) {} // '200': // description: All good baby! // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DebugClearCachesHandler(c *gin.Context) {} diff --git a/internal/api/client/admin/domainallowcreate.go b/internal/api/client/admin/domainallowcreate.go index d7ccac620..756ded829 100644 --- a/internal/api/client/admin/domainallowcreate.go +++ b/internal/api/client/admin/domainallowcreate.go @@ -103,21 +103,35 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: >- // Conflict: There is already an admin action running that conflicts with this action. // Check the error message in the response body for more information. This is a temporary // error; it should be possible to process this action if you try again in a bit. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainAllowsPOSTHandler(c *gin.Context) { m.createDomainPermissions(c, diff --git a/internal/api/client/admin/domainallowdelete.go b/internal/api/client/admin/domainallowdelete.go index 06e6ea538..498f7e6d1 100644 --- a/internal/api/client/admin/domainallowdelete.go +++ b/internal/api/client/admin/domainallowdelete.go @@ -51,21 +51,35 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: >- // Conflict: There is already an admin action running that conflicts with this action. // Check the error message in the response body for more information. This is a temporary // error; it should be possible to process this action if you try again in a bit. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainAllowDELETEHandler(c *gin.Context) { m.deleteDomainPermission(c, gtsmodel.DomainPermissionAllow) diff --git a/internal/api/client/admin/domainallowget.go b/internal/api/client/admin/domainallowget.go index 61c6dae20..5214ea825 100644 --- a/internal/api/client/admin/domainallowget.go +++ b/internal/api/client/admin/domainallowget.go @@ -51,16 +51,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainAllowGETHandler(c *gin.Context) { m.getDomainPermission(c, gtsmodel.DomainPermissionAllow) diff --git a/internal/api/client/admin/domainallowsget.go b/internal/api/client/admin/domainallowsget.go index d973b9df4..fc5b56b8d 100644 --- a/internal/api/client/admin/domainallowsget.go +++ b/internal/api/client/admin/domainallowsget.go @@ -57,16 +57,28 @@ import ( // items: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainAllowsGETHandler(c *gin.Context) { m.getDomainPermissions(c, gtsmodel.DomainPermissionAllow) diff --git a/internal/api/client/admin/domainallowupdate.go b/internal/api/client/admin/domainallowupdate.go index 9b28d4682..d3c090bff 100644 --- a/internal/api/client/admin/domainallowupdate.go +++ b/internal/api/client/admin/domainallowupdate.go @@ -75,16 +75,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainAllowUpdatePUTHandler(c *gin.Context) { m.updateDomainPermission(c, gtsmodel.DomainPermissionAllow) diff --git a/internal/api/client/admin/domainblockcreate.go b/internal/api/client/admin/domainblockcreate.go index e305d7e5a..421be70b0 100644 --- a/internal/api/client/admin/domainblockcreate.go +++ b/internal/api/client/admin/domainblockcreate.go @@ -103,21 +103,35 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: >- // Conflict: There is already an admin action running that conflicts with this action. // Check the error message in the response body for more information. This is a temporary // error; it should be possible to process this action if you try again in a bit. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainBlocksPOSTHandler(c *gin.Context) { m.createDomainPermissions(c, diff --git a/internal/api/client/admin/domainblockdelete.go b/internal/api/client/admin/domainblockdelete.go index f7bda40b0..b59f1287a 100644 --- a/internal/api/client/admin/domainblockdelete.go +++ b/internal/api/client/admin/domainblockdelete.go @@ -51,21 +51,35 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: >- // Conflict: There is already an admin action running that conflicts with this action. // Check the error message in the response body for more information. This is a temporary // error; it should be possible to process this action if you try again in a bit. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainBlockDELETEHandler(c *gin.Context) { m.deleteDomainPermission(c, gtsmodel.DomainPermissionBlock) diff --git a/internal/api/client/admin/domainblockget.go b/internal/api/client/admin/domainblockget.go index 23d0795f5..21fd01234 100644 --- a/internal/api/client/admin/domainblockget.go +++ b/internal/api/client/admin/domainblockget.go @@ -51,16 +51,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainBlockGETHandler(c *gin.Context) { m.getDomainPermission(c, gtsmodel.DomainPermissionBlock) diff --git a/internal/api/client/admin/domainblocksget.go b/internal/api/client/admin/domainblocksget.go index 1728fbe3d..561c1d8c0 100644 --- a/internal/api/client/admin/domainblocksget.go +++ b/internal/api/client/admin/domainblocksget.go @@ -57,16 +57,28 @@ import ( // items: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainBlocksGETHandler(c *gin.Context) { m.getDomainPermissions(c, gtsmodel.DomainPermissionBlock) diff --git a/internal/api/client/admin/domainblockupdate.go b/internal/api/client/admin/domainblockupdate.go index b3c4408c8..0ce3fb48b 100644 --- a/internal/api/client/admin/domainblockupdate.go +++ b/internal/api/client/admin/domainblockupdate.go @@ -75,16 +75,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainBlockUpdatePUTHandler(c *gin.Context) { m.updateDomainPermission(c, gtsmodel.DomainPermissionBlock) diff --git a/internal/api/client/admin/domainkeysexpire.go b/internal/api/client/admin/domainkeysexpire.go index e18eae126..6f2e1bb6b 100644 --- a/internal/api/client/admin/domainkeysexpire.go +++ b/internal/api/client/admin/domainkeysexpire.go @@ -77,21 +77,35 @@ import ( // schema: // "$ref": "#/definitions/adminActionResponse" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: >- // Conflict: There is already an admin action running that conflicts with this action. // Check the error message in the response body for more information. This is a temporary // error; it should be possible to process this action if you try again in a bit. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainKeysExpirePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissiondraftaccept.go b/internal/api/client/admin/domainpermissiondraftaccept.go index 2514d339c..b501c5bd8 100644 --- a/internal/api/client/admin/domainpermissiondraftaccept.go +++ b/internal/api/client/admin/domainpermissiondraftaccept.go @@ -68,16 +68,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionDraftAcceptPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, true, true, true, true) diff --git a/internal/api/client/admin/domainpermissiondraftcreate.go b/internal/api/client/admin/domainpermissiondraftcreate.go index 71aee0c05..f4932ff5c 100644 --- a/internal/api/client/admin/domainpermissiondraftcreate.go +++ b/internal/api/client/admin/domainpermissiondraftcreate.go @@ -87,16 +87,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionDraftsPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissiondraftget.go b/internal/api/client/admin/domainpermissiondraftget.go index 8f4aa03bf..0f9cfee6b 100644 --- a/internal/api/client/admin/domainpermissiondraftget.go +++ b/internal/api/client/admin/domainpermissiondraftget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionDraftGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissiondraftremove.go b/internal/api/client/admin/domainpermissiondraftremove.go index 6cd476b19..180e63ea9 100644 --- a/internal/api/client/admin/domainpermissiondraftremove.go +++ b/internal/api/client/admin/domainpermissiondraftremove.go @@ -68,16 +68,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionDraftRemovePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissiondraftsget.go b/internal/api/client/admin/domainpermissiondraftsget.go index b54332202..68ac7c962 100644 --- a/internal/api/client/admin/domainpermissiondraftsget.go +++ b/internal/api/client/admin/domainpermissiondraftsget.go @@ -112,16 +112,28 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionDraftsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionexcludecreate.go b/internal/api/client/admin/domainpermissionexcludecreate.go index 1b8dd307b..2f7f07e79 100644 --- a/internal/api/client/admin/domainpermissionexcludecreate.go +++ b/internal/api/client/admin/domainpermissionexcludecreate.go @@ -69,16 +69,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionExcludesPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionexcludeget.go b/internal/api/client/admin/domainpermissionexcludeget.go index 18d3ea56e..3484cc2c5 100644 --- a/internal/api/client/admin/domainpermissionexcludeget.go +++ b/internal/api/client/admin/domainpermissionexcludeget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionExcludeGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionexcluderemove.go b/internal/api/client/admin/domainpermissionexcluderemove.go index c1dc98241..426dbdc2b 100644 --- a/internal/api/client/admin/domainpermissionexcluderemove.go +++ b/internal/api/client/admin/domainpermissionexcluderemove.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermission" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionExcludeDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionexcludesget.go b/internal/api/client/admin/domainpermissionexcludesget.go index d245c1666..71cfbb300 100644 --- a/internal/api/client/admin/domainpermissionexcludesget.go +++ b/internal/api/client/admin/domainpermissionexcludesget.go @@ -100,16 +100,28 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionExcludesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionsubscriptioncreate.go b/internal/api/client/admin/domainpermissionsubscriptioncreate.go index e57b4bc3f..231feb4fa 100644 --- a/internal/api/client/admin/domainpermissionsubscriptioncreate.go +++ b/internal/api/client/admin/domainpermissionsubscriptioncreate.go @@ -141,16 +141,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermissionSubscription" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionSubscriptionPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionsubscriptionget.go b/internal/api/client/admin/domainpermissionsubscriptionget.go index 43bb90623..007718b45 100644 --- a/internal/api/client/admin/domainpermissionsubscriptionget.go +++ b/internal/api/client/admin/domainpermissionsubscriptionget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/domainPermissionSubscription" // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionSubscriptionGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionsubscriptionremove.go b/internal/api/client/admin/domainpermissionsubscriptionremove.go index f44241d1e..286e8e475 100644 --- a/internal/api/client/admin/domainpermissionsubscriptionremove.go +++ b/internal/api/client/admin/domainpermissionsubscriptionremove.go @@ -75,16 +75,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermissionSubscription" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionSubscriptionRemovePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionsubscriptionsget.go b/internal/api/client/admin/domainpermissionsubscriptionsget.go index 55f1a8de0..90d0d8d3c 100644 --- a/internal/api/client/admin/domainpermissionsubscriptionsget.go +++ b/internal/api/client/admin/domainpermissionsubscriptionsget.go @@ -102,16 +102,28 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionSubscriptionsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionsubscriptionspreviewget.go b/internal/api/client/admin/domainpermissionsubscriptionspreviewget.go index 193a2ca24..d424b5853 100644 --- a/internal/api/client/admin/domainpermissionsubscriptionspreviewget.go +++ b/internal/api/client/admin/domainpermissionsubscriptionspreviewget.go @@ -61,16 +61,28 @@ import ( // items: // "$ref": "#/definitions/domainPermissionSubscription" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionSubscriptionsPreviewGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionsubscriptiontest.go b/internal/api/client/admin/domainpermissionsubscriptiontest.go index cb27312c6..30b0d591d 100644 --- a/internal/api/client/admin/domainpermissionsubscriptiontest.go +++ b/internal/api/client/admin/domainpermissionsubscriptiontest.go @@ -63,16 +63,28 @@ import ( // items: // "$ref": "#/definitions/domain" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionSubscriptionTestPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/domainpermissionsubscriptionupdate.go b/internal/api/client/admin/domainpermissionsubscriptionupdate.go index 416f8ec10..752ab244a 100644 --- a/internal/api/client/admin/domainpermissionsubscriptionupdate.go +++ b/internal/api/client/admin/domainpermissionsubscriptionupdate.go @@ -137,16 +137,28 @@ import ( // schema: // "$ref": "#/definitions/domainPermissionSubscription" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) DomainPermissionSubscriptionPATCHHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/emailtest.go b/internal/api/client/admin/emailtest.go index bd5d12dc6..b50c75a29 100644 --- a/internal/api/client/admin/emailtest.go +++ b/internal/api/client/admin/emailtest.go @@ -68,22 +68,36 @@ import ( // '202': // description: Test email was sent. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: >- // An smtp occurred while the email attempt was in progress. // Check the returned json for more information. The smtp error // will be included, to help you debug communication with the // smtp server. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) EmailTestPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/emojicategoriesget.go b/internal/api/client/admin/emojicategoriesget.go index c2a8cbabb..dd00ceec6 100644 --- a/internal/api/client/admin/emojicategoriesget.go +++ b/internal/api/client/admin/emojicategoriesget.go @@ -49,16 +49,28 @@ import ( // items: // "$ref": "#/definitions/emojiCategory" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) EmojiCategoriesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/emojicreate.go b/internal/api/client/admin/emojicreate.go index 04f0602c0..558292a33 100644 --- a/internal/api/client/admin/emojicreate.go +++ b/internal/api/client/admin/emojicreate.go @@ -83,18 +83,32 @@ import ( // schema: // "$ref": "#/definitions/emoji" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict -- shortcode for this emoji is already in use // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) EmojiCreatePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/emojidelete.go b/internal/api/client/admin/emojidelete.go index 83c49a92a..49b16d02b 100644 --- a/internal/api/client/admin/emojidelete.go +++ b/internal/api/client/admin/emojidelete.go @@ -61,16 +61,28 @@ import ( // schema: // "$ref": "#/definitions/adminEmoji" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) EmojiDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/emojiget.go b/internal/api/client/admin/emojiget.go index 1ae7eb9e9..73c1adb1b 100644 --- a/internal/api/client/admin/emojiget.go +++ b/internal/api/client/admin/emojiget.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/adminEmoji" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) EmojiGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/emojisget.go b/internal/api/client/admin/emojisget.go index 4dbbd7f53..945452203 100644 --- a/internal/api/client/admin/emojisget.go +++ b/internal/api/client/admin/emojisget.go @@ -114,16 +114,28 @@ import ( // items: // "$ref": "#/definitions/adminEmoji" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) EmojisGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/emojiupdate.go b/internal/api/client/admin/emojiupdate.go index d1576a15d..cab07eee0 100644 --- a/internal/api/client/admin/emojiupdate.go +++ b/internal/api/client/admin/emojiupdate.go @@ -112,16 +112,28 @@ import ( // schema: // "$ref": "#/definitions/adminEmoji" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) EmojiPATCHHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/headerfilter_create.go b/internal/api/client/admin/headerfilter_create.go index a5b5e5309..683984262 100644 --- a/internal/api/client/admin/headerfilter_create.go +++ b/internal/api/client/admin/headerfilter_create.go @@ -50,12 +50,20 @@ import ( // schema: // "$ref": "#/definitions/headerFilter" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterAllowPOST(c *gin.Context) { m.createHeaderFilter(c, m.processor.Admin().CreateAllowHeaderFilter) @@ -90,12 +98,20 @@ func (m *Module) HeaderFilterAllowPOST(c *gin.Context) { // schema: // "$ref": "#/definitions/headerFilter" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterBlockPOST(c *gin.Context) { m.createHeaderFilter(c, m.processor.Admin().CreateBlockHeaderFilter) diff --git a/internal/api/client/admin/headerfilter_delete.go b/internal/api/client/admin/headerfilter_delete.go index 400c5c4e3..7f2731f1c 100644 --- a/internal/api/client/admin/headerfilter_delete.go +++ b/internal/api/client/admin/headerfilter_delete.go @@ -45,14 +45,24 @@ import ( // '202': // description: Accepted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterAllowDELETE(c *gin.Context) { m.deleteHeaderFilter(c, m.processor.Admin().DeleteAllowHeaderFilter) @@ -82,14 +92,24 @@ func (m *Module) HeaderFilterAllowDELETE(c *gin.Context) { // '202': // description: Accepted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterBlockDELETE(c *gin.Context) { m.deleteHeaderFilter(c, m.processor.Admin().DeleteBlockHeaderFilter) diff --git a/internal/api/client/admin/headerfilter_get.go b/internal/api/client/admin/headerfilter_get.go index cd00fe24c..a475c2700 100644 --- a/internal/api/client/admin/headerfilter_get.go +++ b/internal/api/client/admin/headerfilter_get.go @@ -45,14 +45,24 @@ import "github.com/gin-gonic/gin" // schema: // "$ref": "#/definitions/headerFilter" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterAllowGET(c *gin.Context) { m.getHeaderFilter(c, m.processor.Admin().GetAllowHeaderFilter) @@ -84,14 +94,24 @@ func (m *Module) HeaderFilterAllowGET(c *gin.Context) { // schema: // "$ref": "#/definitions/headerFilter" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterBlockGET(c *gin.Context) { m.getHeaderFilter(c, m.processor.Admin().GetBlockHeaderFilter) @@ -117,14 +137,24 @@ func (m *Module) HeaderFilterBlockGET(c *gin.Context) { // items: // "$ref": "#/definitions/headerFilter" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterAllowsGET(c *gin.Context) { m.getHeaderFilters(c, m.processor.Admin().GetAllowHeaderFilters) @@ -150,14 +180,24 @@ func (m *Module) HeaderFilterAllowsGET(c *gin.Context) { // items: // "$ref": "#/definitions/headerFilter" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) HeaderFilterBlocksGET(c *gin.Context) { m.getHeaderFilters(c, m.processor.Admin().GetBlockHeaderFilters) diff --git a/internal/api/client/admin/mediacleanup.go b/internal/api/client/admin/mediacleanup.go index 56610ce3e..455f252fe 100644 --- a/internal/api/client/admin/mediacleanup.go +++ b/internal/api/client/admin/mediacleanup.go @@ -56,16 +56,28 @@ import ( // Echos the number of days requested. // The cleanup is performed asynchronously after the request completes. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) MediaCleanupPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/mediarefetch.go b/internal/api/client/admin/mediarefetch.go index bf32ad207..0bf69ac01 100644 --- a/internal/api/client/admin/mediarefetch.go +++ b/internal/api/client/admin/mediarefetch.go @@ -58,16 +58,28 @@ import ( // Request accepted and will be processed. // Check the logs for progress / errors. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) MediaRefetchPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/reportget.go b/internal/api/client/admin/reportget.go index 6f870303a..d92f9e5cb 100644 --- a/internal/api/client/admin/reportget.go +++ b/internal/api/client/admin/reportget.go @@ -56,14 +56,24 @@ import ( // schema: // "$ref": "#/definitions/adminReport" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ReportGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/reportresolve.go b/internal/api/client/admin/reportresolve.go index df9e749a6..3b589968c 100644 --- a/internal/api/client/admin/reportresolve.go +++ b/internal/api/client/admin/reportresolve.go @@ -73,14 +73,24 @@ import ( // schema: // "$ref": "#/definitions/adminReport" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ReportResolvePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/reportsget.go b/internal/api/client/admin/reportsget.go index 31c93cbcc..10a31beb0 100644 --- a/internal/api/client/admin/reportsget.go +++ b/internal/api/client/admin/reportsget.go @@ -114,14 +114,24 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ReportsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/rulecreate.go b/internal/api/client/admin/rulecreate.go index ac8febaed..4a4a439c1 100644 --- a/internal/api/client/admin/rulecreate.go +++ b/internal/api/client/admin/rulecreate.go @@ -52,16 +52,28 @@ import ( // schema: // "$ref": "#/definitions/instanceRule" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) RulePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/ruledelete.go b/internal/api/client/admin/ruledelete.go index b6415cf3b..38c67ddb4 100644 --- a/internal/api/client/admin/ruledelete.go +++ b/internal/api/client/admin/ruledelete.go @@ -59,16 +59,28 @@ import ( // schema: // "$ref": "#/definitions/instanceRule" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) RuleDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/ruleget.go b/internal/api/client/admin/ruleget.go index ce21bbb26..af6288716 100644 --- a/internal/api/client/admin/ruleget.go +++ b/internal/api/client/admin/ruleget.go @@ -56,14 +56,24 @@ import ( // schema: // "$ref": "#/definitions/instanceRule" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) RuleGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/rulesget.go b/internal/api/client/admin/rulesget.go index 48cd4b43c..4191dc93d 100644 --- a/internal/api/client/admin/rulesget.go +++ b/internal/api/client/admin/rulesget.go @@ -53,14 +53,24 @@ import ( // items: // "$ref": "#/definitions/instanceRule" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) RulesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/admin/ruleupdate.go b/internal/api/client/admin/ruleupdate.go index 8f2efe845..2b44e76b8 100644 --- a/internal/api/client/admin/ruleupdate.go +++ b/internal/api/client/admin/ruleupdate.go @@ -51,16 +51,28 @@ import ( // schema: // "$ref": "#/definitions/instanceRule" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) RulePATCHHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/announcements/announcementsget.go b/internal/api/client/announcements/announcementsget.go index 90347c177..8d5e7bb09 100644 --- a/internal/api/client/announcements/announcementsget.go +++ b/internal/api/client/announcements/announcementsget.go @@ -49,12 +49,20 @@ import ( // type: object // maxItems: 0 // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AnnouncementsGETHandler(c *gin.Context) { _, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/apps/appcreate.go b/internal/api/client/apps/appcreate.go index 11784bf63..29ffd41b4 100644 --- a/internal/api/client/apps/appcreate.go +++ b/internal/api/client/apps/appcreate.go @@ -66,16 +66,28 @@ const ( // schema: // "$ref": "#/definitions/application" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AppsPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/apps/appdelete.go b/internal/api/client/apps/appdelete.go index db3b31d5c..3ca12a649 100644 --- a/internal/api/client/apps/appdelete.go +++ b/internal/api/client/apps/appdelete.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/application" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AppDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/apps/appget.go b/internal/api/client/apps/appget.go index fc16c5ae1..016cfdc73 100644 --- a/internal/api/client/apps/appget.go +++ b/internal/api/client/apps/appget.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/application" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AppGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/apps/appsget.go b/internal/api/client/apps/appsget.go index 31b2e9337..299c42aa4 100644 --- a/internal/api/client/apps/appsget.go +++ b/internal/api/client/apps/appsget.go @@ -94,14 +94,24 @@ import ( // items: // "$ref": "#/definitions/application" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) AppsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/blocks/blocksget.go b/internal/api/client/blocks/blocksget.go index 45a24cf91..11ce5d07f 100644 --- a/internal/api/client/blocks/blocksget.go +++ b/internal/api/client/blocks/blocksget.go @@ -96,14 +96,24 @@ import ( // items: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) BlocksGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/bookmarks/bookmarksget.go b/internal/api/client/bookmarks/bookmarksget.go index beaec63f3..a8fe9d7a4 100644 --- a/internal/api/client/bookmarks/bookmarksget.go +++ b/internal/api/client/bookmarks/bookmarksget.go @@ -86,10 +86,16 @@ const ( // type: string // description: Links to the next and previous queries. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) BookmarksGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/conversations/conversationdelete.go b/internal/api/client/conversations/conversationdelete.go index 6757ffe1a..8449b3a3c 100644 --- a/internal/api/client/conversations/conversationdelete.go +++ b/internal/api/client/conversations/conversationdelete.go @@ -55,14 +55,24 @@ import ( // '200': // description: conversation deleted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ConversationDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/conversations/conversationread.go b/internal/api/client/conversations/conversationread.go index 0eb907ca4..3bfb31b0a 100644 --- a/internal/api/client/conversations/conversationread.go +++ b/internal/api/client/conversations/conversationread.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/conversation" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ConversationReadPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/conversations/conversationsget.go b/internal/api/client/conversations/conversationsget.go index c9edd0825..dcaff3ec9 100644 --- a/internal/api/client/conversations/conversationsget.go +++ b/internal/api/client/conversations/conversationsget.go @@ -96,14 +96,24 @@ import ( // items: // "$ref": "#/definitions/conversation" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ConversationsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/customemojis/customemojisget.go b/internal/api/client/customemojis/customemojisget.go index 9aa878274..384b6bbae 100644 --- a/internal/api/client/customemojis/customemojisget.go +++ b/internal/api/client/customemojis/customemojisget.go @@ -51,10 +51,16 @@ import ( // items: // "$ref": "#/definitions/emoji" // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) CustomEmojisGETHandler(c *gin.Context) { // If custom emojis are not exposed to unauthed diff --git a/internal/api/client/exports/blocks.go b/internal/api/client/exports/blocks.go index fae8a201b..614073971 100644 --- a/internal/api/client/exports/blocks.go +++ b/internal/api/client/exports/blocks.go @@ -45,10 +45,16 @@ import ( // name: accounts // description: CSV file of accounts that you block. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ExportBlocksGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/exports/followers.go b/internal/api/client/exports/followers.go index 520fbef70..7a5ce075d 100644 --- a/internal/api/client/exports/followers.go +++ b/internal/api/client/exports/followers.go @@ -45,10 +45,16 @@ import ( // name: accounts // description: CSV file of accounts that follow you. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ExportFollowersGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/exports/following.go b/internal/api/client/exports/following.go index 8d6306092..e7fb908fb 100644 --- a/internal/api/client/exports/following.go +++ b/internal/api/client/exports/following.go @@ -45,10 +45,16 @@ import ( // name: accounts // description: CSV file of accounts that you follow. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ExportFollowingGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/exports/lists.go b/internal/api/client/exports/lists.go index cf152bf55..ccd4b9012 100644 --- a/internal/api/client/exports/lists.go +++ b/internal/api/client/exports/lists.go @@ -45,10 +45,16 @@ import ( // name: accounts // description: CSV file of lists. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ExportListsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/exports/mutes.go b/internal/api/client/exports/mutes.go index 0db94db62..66550950e 100644 --- a/internal/api/client/exports/mutes.go +++ b/internal/api/client/exports/mutes.go @@ -45,10 +45,16 @@ import ( // name: accounts // description: CSV file of accounts that you mute. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ExportMutesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/exports/stats.go b/internal/api/client/exports/stats.go index 6b9436065..3eccfb644 100644 --- a/internal/api/client/exports/stats.go +++ b/internal/api/client/exports/stats.go @@ -46,10 +46,16 @@ import ( // schema: // "$ref": "#/definitions/accountExportStats" // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ExportStatsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/favourites/favouritesget.go b/internal/api/client/favourites/favouritesget.go index 8b1f646c4..97112f708 100644 --- a/internal/api/client/favourites/favouritesget.go +++ b/internal/api/client/favourites/favouritesget.go @@ -82,14 +82,24 @@ import ( // items: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FavouritesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/featuredtags/get.go b/internal/api/client/featuredtags/get.go index 7b5c68e40..b570c8dcb 100644 --- a/internal/api/client/featuredtags/get.go +++ b/internal/api/client/featuredtags/get.go @@ -49,14 +49,24 @@ import ( // items: // type: object // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FeaturedTagsGETHandler(c *gin.Context) { _, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v1/filterdelete.go b/internal/api/client/filters/v1/filterdelete.go index 5283240c5..4e171bbaf 100644 --- a/internal/api/client/filters/v1/filterdelete.go +++ b/internal/api/client/filters/v1/filterdelete.go @@ -52,14 +52,24 @@ import ( // '200': // description: filter deleted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v1/filterget.go b/internal/api/client/filters/v1/filterget.go index 704be540a..ffe2a300b 100644 --- a/internal/api/client/filters/v1/filterget.go +++ b/internal/api/client/filters/v1/filterget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/filterV1" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v1/filterpost.go b/internal/api/client/filters/v1/filterpost.go index d61ddbdb8..5840fea44 100644 --- a/internal/api/client/filters/v1/filterpost.go +++ b/internal/api/client/filters/v1/filterpost.go @@ -113,20 +113,36 @@ import ( // schema: // "$ref": "#/definitions/filterV1" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (duplicate keyword) // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v1/filterput.go b/internal/api/client/filters/v1/filterput.go index ab08f0d92..64c1711fe 100644 --- a/internal/api/client/filters/v1/filterput.go +++ b/internal/api/client/filters/v1/filterput.go @@ -119,20 +119,36 @@ import ( // schema: // "$ref": "#/definitions/filterV1" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (duplicate keyword) // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterPUTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v1/filtersget.go b/internal/api/client/filters/v1/filtersget.go index 42a7c3b7e..c5ba0e9cd 100644 --- a/internal/api/client/filters/v1/filtersget.go +++ b/internal/api/client/filters/v1/filtersget.go @@ -49,14 +49,24 @@ import ( // items: // "$ref": "#/definitions/filterV1" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FiltersGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterdelete.go b/internal/api/client/filters/v2/filterdelete.go index 4ede393de..3631f2983 100644 --- a/internal/api/client/filters/v2/filterdelete.go +++ b/internal/api/client/filters/v2/filterdelete.go @@ -52,14 +52,24 @@ import ( // '200': // description: filter deleted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterget.go b/internal/api/client/filters/v2/filterget.go index 21ac6a2ca..df01000cf 100644 --- a/internal/api/client/filters/v2/filterget.go +++ b/internal/api/client/filters/v2/filterget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/filterV2" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterkeyworddelete.go b/internal/api/client/filters/v2/filterkeyworddelete.go index 63c235d16..4ad936907 100644 --- a/internal/api/client/filters/v2/filterkeyworddelete.go +++ b/internal/api/client/filters/v2/filterkeyworddelete.go @@ -52,14 +52,24 @@ import ( // '200': // description: filter keyword deleted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterKeywordDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterkeywordget.go b/internal/api/client/filters/v2/filterkeywordget.go index e8e4dec0c..af3d12466 100644 --- a/internal/api/client/filters/v2/filterkeywordget.go +++ b/internal/api/client/filters/v2/filterkeywordget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/filterKeyword" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterKeywordGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterkeywordpost.go b/internal/api/client/filters/v2/filterkeywordpost.go index 1068f78f8..f3eb31502 100644 --- a/internal/api/client/filters/v2/filterkeywordpost.go +++ b/internal/api/client/filters/v2/filterkeywordpost.go @@ -83,20 +83,36 @@ import ( // schema: // "$ref": "#/definitions/filterKeyword" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (duplicate keyword) // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterKeywordPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterkeywordput.go b/internal/api/client/filters/v2/filterkeywordput.go index dae3a0042..75c904fc7 100644 --- a/internal/api/client/filters/v2/filterkeywordput.go +++ b/internal/api/client/filters/v2/filterkeywordput.go @@ -80,20 +80,36 @@ import ( // schema: // "$ref": "#/definitions/filterKeyword" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (duplicate keyword) // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterKeywordPUTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterkeywordsget.go b/internal/api/client/filters/v2/filterkeywordsget.go index 3bfe81bc6..c2e6ecef2 100644 --- a/internal/api/client/filters/v2/filterkeywordsget.go +++ b/internal/api/client/filters/v2/filterkeywordsget.go @@ -57,14 +57,24 @@ import ( // items: // "$ref": "#/definitions/filterKeyword" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterKeywordsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterpost.go b/internal/api/client/filters/v2/filterpost.go index c2473557a..7cb11da92 100644 --- a/internal/api/client/filters/v2/filterpost.go +++ b/internal/api/client/filters/v2/filterpost.go @@ -133,20 +133,36 @@ import ( // schema: // "$ref": "#/definitions/filterV2" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (duplicate title, keyword, or status) // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterput.go b/internal/api/client/filters/v2/filterput.go index 689c47e5b..4538fa3bf 100644 --- a/internal/api/client/filters/v2/filterput.go +++ b/internal/api/client/filters/v2/filterput.go @@ -141,20 +141,36 @@ import ( // schema: // "$ref": "#/definitions/filterV2" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (duplicate title, keyword, or status) // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterPUTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filtersget.go b/internal/api/client/filters/v2/filtersget.go index 94e1db03b..d6d0856ee 100644 --- a/internal/api/client/filters/v2/filtersget.go +++ b/internal/api/client/filters/v2/filtersget.go @@ -49,14 +49,24 @@ import ( // items: // "$ref": "#/definitions/filterV2" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FiltersGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterstatusdelete.go b/internal/api/client/filters/v2/filterstatusdelete.go index 8522fde06..e4a818e49 100644 --- a/internal/api/client/filters/v2/filterstatusdelete.go +++ b/internal/api/client/filters/v2/filterstatusdelete.go @@ -52,14 +52,24 @@ import ( // '200': // description: filter status deleted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterStatusDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterstatusesget.go b/internal/api/client/filters/v2/filterstatusesget.go index 31616bd36..91ec7f46f 100644 --- a/internal/api/client/filters/v2/filterstatusesget.go +++ b/internal/api/client/filters/v2/filterstatusesget.go @@ -57,14 +57,24 @@ import ( // items: // "$ref": "#/definitions/filterStatus" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterStatusesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterstatusget.go b/internal/api/client/filters/v2/filterstatusget.go index 3add79c26..53410d4e9 100644 --- a/internal/api/client/filters/v2/filterstatusget.go +++ b/internal/api/client/filters/v2/filterstatusget.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/filterStatus" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterStatusGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/filters/v2/filterstatuspost.go b/internal/api/client/filters/v2/filterstatuspost.go index b7b6019ac..22ea8b075 100644 --- a/internal/api/client/filters/v2/filterstatuspost.go +++ b/internal/api/client/filters/v2/filterstatuspost.go @@ -71,20 +71,36 @@ import ( // schema: // "$ref": "#/definitions/filterStatus" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden to moved accounts // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (duplicate status) // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FilterStatusPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/followedtags/get.go b/internal/api/client/followedtags/get.go index 5cd7e91fb..5b9fa82be 100644 --- a/internal/api/client/followedtags/get.go +++ b/internal/api/client/followedtags/get.go @@ -89,14 +89,24 @@ import ( // items: // "$ref": "#/definitions/tag" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FollowedTagsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/followrequests/authorize.go b/internal/api/client/followrequests/authorize.go index bcaad9be6..3fb6d6186 100644 --- a/internal/api/client/followrequests/authorize.go +++ b/internal/api/client/followrequests/authorize.go @@ -58,14 +58,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FollowRequestAuthorizePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/followrequests/get.go b/internal/api/client/followrequests/get.go index a55ea3ab2..95ecae837 100644 --- a/internal/api/client/followrequests/get.go +++ b/internal/api/client/followrequests/get.go @@ -97,14 +97,24 @@ import ( // items: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FollowRequestGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/followrequests/getoutgoing.go b/internal/api/client/followrequests/getoutgoing.go index 4da6dfad8..37043e3b9 100644 --- a/internal/api/client/followrequests/getoutgoing.go +++ b/internal/api/client/followrequests/getoutgoing.go @@ -97,14 +97,24 @@ import ( // items: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) OutgoingFollowRequestGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/followrequests/reject.go b/internal/api/client/followrequests/reject.go index d60a1af08..072e5cd6b 100644 --- a/internal/api/client/followrequests/reject.go +++ b/internal/api/client/followrequests/reject.go @@ -56,14 +56,24 @@ import ( // schema: // "$ref": "#/definitions/accountRelationship" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FollowRequestRejectPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/import/import.go b/internal/api/client/import/import.go index ebd4f64ad..ffdb49566 100644 --- a/internal/api/client/import/import.go +++ b/internal/api/client/import/import.go @@ -118,12 +118,20 @@ func (m *Module) Route(attachHandler func(method string, path string, f ...gin.H // '202': // description: Upload accepted. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ImportPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/instance/domainperms.go b/internal/api/client/instance/domainperms.go index 6503388a5..1076c4d4a 100644 --- a/internal/api/client/instance/domainperms.go +++ b/internal/api/client/instance/domainperms.go @@ -51,16 +51,28 @@ import ( // items: // "$ref": "#/definitions/domain" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InstanceDomainBlocksGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, @@ -123,16 +135,28 @@ func (m *Module) InstanceDomainBlocksGETHandler(c *gin.Context) { // items: // "$ref": "#/definitions/domain" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InstanceDomainAllowsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/instance/instanceget.go b/internal/api/client/instance/instanceget.go index 4740fe1e8..38138cae2 100644 --- a/internal/api/client/instance/instanceget.go +++ b/internal/api/client/instance/instanceget.go @@ -45,8 +45,12 @@ import ( // schema: // "$ref": "#/definitions/instanceV1" // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) InstanceInformationGETHandlerV1(c *gin.Context) { if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { @@ -97,8 +101,12 @@ func (m *Module) InstanceInformationGETHandlerV1(c *gin.Context) { // schema: // "$ref": "#/definitions/instanceV2" // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) InstanceInformationGETHandlerV2(c *gin.Context) { if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { diff --git a/internal/api/client/instance/instancepatch.go b/internal/api/client/instance/instancepatch.go index b81f14298..ced5c624d 100644 --- a/internal/api/client/instance/instancepatch.go +++ b/internal/api/client/instance/instancepatch.go @@ -114,16 +114,28 @@ import ( // schema: // "$ref": "#/definitions/instanceV1" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InstanceUpdatePATCHHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/instance/instancepeersget.go b/internal/api/client/instance/instancepeersget.go index d9f7610b7..e5870eff7 100644 --- a/internal/api/client/instance/instancepeersget.go +++ b/internal/api/client/instance/instancepeersget.go @@ -103,16 +103,28 @@ import ( // items: // "$ref": "#/definitions/domain" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InstancePeersGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/instance/instancerulesget.go b/internal/api/client/instance/instancerulesget.go index 8daedec74..814ff0439 100644 --- a/internal/api/client/instance/instancerulesget.go +++ b/internal/api/client/instance/instancerulesget.go @@ -48,12 +48,20 @@ import ( // items: // "$ref": "#/definitions/instanceRule" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InstanceRulesGETHandler(c *gin.Context) { if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { diff --git a/internal/api/client/interactionpolicies/getdefaults.go b/internal/api/client/interactionpolicies/getdefaults.go index a5890fc8b..1852c3749 100644 --- a/internal/api/client/interactionpolicies/getdefaults.go +++ b/internal/api/client/interactionpolicies/getdefaults.go @@ -46,10 +46,16 @@ import ( // schema: // "$ref": "#/definitions/defaultPolicies" // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PoliciesDefaultsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/interactionpolicies/updatedefaults.go b/internal/api/client/interactionpolicies/updatedefaults.go index 1b3c0bc7a..128b0501a 100644 --- a/internal/api/client/interactionpolicies/updatedefaults.go +++ b/internal/api/client/interactionpolicies/updatedefaults.go @@ -200,14 +200,24 @@ import ( // schema: // "$ref": "#/definitions/defaultPolicies" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PoliciesDefaultsPATCHHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/interactionrequests/authorize.go b/internal/api/client/interactionrequests/authorize.go index 81a612e7a..6b9dfc01b 100644 --- a/internal/api/client/interactionrequests/authorize.go +++ b/internal/api/client/interactionrequests/authorize.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/interactionRequest" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InteractionRequestAuthorizePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/interactionrequests/get.go b/internal/api/client/interactionrequests/get.go index a4f09f490..48b1520f8 100644 --- a/internal/api/client/interactionrequests/get.go +++ b/internal/api/client/interactionrequests/get.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/interactionRequest" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InteractionRequestGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/interactionrequests/getpage.go b/internal/api/client/interactionrequests/getpage.go index d938b220f..eeaa635b7 100644 --- a/internal/api/client/interactionrequests/getpage.go +++ b/internal/api/client/interactionrequests/getpage.go @@ -126,14 +126,24 @@ import ( // items: // "$ref": "#/definitions/interactionRequest" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InteractionRequestsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/interactionrequests/reject.go b/internal/api/client/interactionrequests/reject.go index 2f87643a1..06ac0d839 100644 --- a/internal/api/client/interactionrequests/reject.go +++ b/internal/api/client/interactionrequests/reject.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/interactionRequest" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) InteractionRequestRejectPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listaccounts.go b/internal/api/client/lists/listaccounts.go index ac3f21ef5..b58486f10 100644 --- a/internal/api/client/lists/listaccounts.go +++ b/internal/api/client/lists/listaccounts.go @@ -106,14 +106,24 @@ import ( // items: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListAccountsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listaccountsadd.go b/internal/api/client/lists/listaccountsadd.go index b89b9100b..7eb7c1e8e 100644 --- a/internal/api/client/lists/listaccountsadd.go +++ b/internal/api/client/lists/listaccountsadd.go @@ -71,14 +71,24 @@ import ( // '200': // description: list accounts updated // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListAccountsPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listaccountsremove.go b/internal/api/client/lists/listaccountsremove.go index fc4cb0344..a70733809 100644 --- a/internal/api/client/lists/listaccountsremove.go +++ b/internal/api/client/lists/listaccountsremove.go @@ -71,14 +71,24 @@ import ( // '200': // description: list accounts updated // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListAccountsDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listcreate.go b/internal/api/client/lists/listcreate.go index 75ad48b0c..19a6ffc42 100644 --- a/internal/api/client/lists/listcreate.go +++ b/internal/api/client/lists/listcreate.go @@ -84,16 +84,28 @@ import ( // schema: // "$ref": "#/definitions/list" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListCreatePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listdelete.go b/internal/api/client/lists/listdelete.go index 7e5b58b58..1cd7f5c4f 100644 --- a/internal/api/client/lists/listdelete.go +++ b/internal/api/client/lists/listdelete.go @@ -53,14 +53,24 @@ import ( // '200': // description: list deleted // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listget.go b/internal/api/client/lists/listget.go index e8e2759a8..3a1a5d351 100644 --- a/internal/api/client/lists/listget.go +++ b/internal/api/client/lists/listget.go @@ -56,14 +56,24 @@ import ( // schema: // "$ref": "#/definitions/list" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listsget.go b/internal/api/client/lists/listsget.go index 8d912241b..7790953c8 100644 --- a/internal/api/client/lists/listsget.go +++ b/internal/api/client/lists/listsget.go @@ -49,14 +49,24 @@ import ( // items: // "$ref": "#/definitions/list" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/lists/listupdate.go b/internal/api/client/lists/listupdate.go index e4258b013..5ac26cf60 100644 --- a/internal/api/client/lists/listupdate.go +++ b/internal/api/client/lists/listupdate.go @@ -90,16 +90,28 @@ import ( // schema: // "$ref": "#/definitions/list" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ListUpdatePUTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/markers/markersget.go b/internal/api/client/markers/markersget.go index 5706e74cd..b0b2297a8 100644 --- a/internal/api/client/markers/markersget.go +++ b/internal/api/client/markers/markersget.go @@ -60,10 +60,16 @@ import ( // schema: // "$ref": "#/definitions/markers" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) MarkersGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/markers/markerspost.go b/internal/api/client/markers/markerspost.go index 199d370d3..d96ffa4be 100644 --- a/internal/api/client/markers/markerspost.go +++ b/internal/api/client/markers/markerspost.go @@ -63,12 +63,20 @@ import ( // schema: // "$ref": "#/definitions/markers" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict (when two clients try to update the same timeline at the same time) // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) MarkersPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/media/mediacreate.go b/internal/api/client/media/mediacreate.go index 5b71dd527..21354ce59 100644 --- a/internal/api/client/media/mediacreate.go +++ b/internal/api/client/media/mediacreate.go @@ -84,12 +84,20 @@ import ( // schema: // "$ref": "#/definitions/attachment" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) MediaCreatePOSTHandler(c *gin.Context) { _, errWithCode := apiutil.ParseAPIVersion( diff --git a/internal/api/client/media/mediaget.go b/internal/api/client/media/mediaget.go index e08ef6bfa..eb676abb2 100644 --- a/internal/api/client/media/mediaget.go +++ b/internal/api/client/media/mediaget.go @@ -55,15 +55,25 @@ import ( // schema: // "$ref": "#/definitions/attachment" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': -// description: internal server error +// schema: +// "$ref": "#/definitions/error" +// description: internal server error func (m *Module) MediaGETHandler(c *gin.Context) { if _, errWithCode := apiutil.ParseAPIVersion( c.Param(apiutil.APIVersionKey), diff --git a/internal/api/client/media/mediaupdate.go b/internal/api/client/media/mediaupdate.go index d10fc97b1..86ad30d65 100644 --- a/internal/api/client/media/mediaupdate.go +++ b/internal/api/client/media/mediaupdate.go @@ -87,14 +87,24 @@ import ( // schema: // "$ref": "#/definitions/attachment" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) MediaPUTHandler(c *gin.Context) { if _, errWithCode := apiutil.ParseAPIVersion( diff --git a/internal/api/client/mutes/mutesget.go b/internal/api/client/mutes/mutesget.go index 5aa4f99eb..28f6001f9 100644 --- a/internal/api/client/mutes/mutesget.go +++ b/internal/api/client/mutes/mutesget.go @@ -97,14 +97,24 @@ import ( // items: // "$ref": "#/definitions/mutedAccount" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) MutesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/notifications/notificationget.go b/internal/api/client/notifications/notificationget.go index e9265d1bc..16551b548 100644 --- a/internal/api/client/notifications/notificationget.go +++ b/internal/api/client/notifications/notificationget.go @@ -56,14 +56,24 @@ import ( // schema: // "$ref": "#/definitions/notification" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) NotificationGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/notifications/notificationsclear.go b/internal/api/client/notifications/notificationsclear.go index 58c2c7f70..cff253736 100644 --- a/internal/api/client/notifications/notificationsclear.go +++ b/internal/api/client/notifications/notificationsclear.go @@ -47,14 +47,24 @@ import ( // schema: // type: object // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) NotificationsClearPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/notifications/notificationsget.go b/internal/api/client/notifications/notificationsget.go index 5550ed082..14ef2726f 100644 --- a/internal/api/client/notifications/notificationsget.go +++ b/internal/api/client/notifications/notificationsget.go @@ -132,14 +132,24 @@ import ( // items: // "$ref": "#/definitions/notification" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) NotificationsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/polls/polls_get.go b/internal/api/client/polls/polls_get.go index dd3892abc..939aa7bb8 100644 --- a/internal/api/client/polls/polls_get.go +++ b/internal/api/client/polls/polls_get.go @@ -54,16 +54,28 @@ import ( // schema: // "$ref": "#/definitions/poll" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PollGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/polls/polls_vote.go b/internal/api/client/polls/polls_vote.go index 62352fbb0..882fd9063 100644 --- a/internal/api/client/polls/polls_vote.go +++ b/internal/api/client/polls/polls_vote.go @@ -65,18 +65,32 @@ import ( // schema: // "$ref": "#/definitions/poll" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable entity // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PollVotePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/preferences/preferencesget.go b/internal/api/client/preferences/preferencesget.go index 06485f53a..7e36f592b 100644 --- a/internal/api/client/preferences/preferencesget.go +++ b/internal/api/client/preferences/preferencesget.go @@ -60,14 +60,24 @@ import ( // schema: // type: object // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PreferencesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/push/pushsubscriptiondelete.go b/internal/api/client/push/pushsubscriptiondelete.go index 8cafa3e39..3f959842d 100644 --- a/internal/api/client/push/pushsubscriptiondelete.go +++ b/internal/api/client/push/pushsubscriptiondelete.go @@ -41,10 +41,16 @@ import ( // '200': // description: Push subscription deleted, or did not exist. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PushSubscriptionDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/push/pushsubscriptionget.go b/internal/api/client/push/pushsubscriptionget.go index 2a3e69e3d..1150144de 100644 --- a/internal/api/client/push/pushsubscriptionget.go +++ b/internal/api/client/push/pushsubscriptionget.go @@ -45,12 +45,20 @@ import ( // schema: // "$ref": "#/definitions/webPushSubscription" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: This access token doesn't have an associated subscription. // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PushSubscriptionGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/push/pushsubscriptionpost.go b/internal/api/client/push/pushsubscriptionpost.go index 1929ae714..83ef3ee41 100644 --- a/internal/api/client/push/pushsubscriptionpost.go +++ b/internal/api/client/push/pushsubscriptionpost.go @@ -168,16 +168,28 @@ import ( // schema: // "$ref": "#/definitions/webPushSubscription" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PushSubscriptionPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/push/pushsubscriptionput.go b/internal/api/client/push/pushsubscriptionput.go index 1a2b51cb7..7100199d5 100644 --- a/internal/api/client/push/pushsubscriptionput.go +++ b/internal/api/client/push/pushsubscriptionput.go @@ -144,16 +144,28 @@ import ( // schema: // "$ref": "#/definitions/webPushSubscription" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: This access token doesn't have an associated subscription. // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) PushSubscriptionPUTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/reports/reportcreate.go b/internal/api/client/reports/reportcreate.go index 51e29a1b5..0ed4a00c8 100644 --- a/internal/api/client/reports/reportcreate.go +++ b/internal/api/client/reports/reportcreate.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/report" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ReportPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/reports/reportget.go b/internal/api/client/reports/reportget.go index abb677a31..8a0fa5ae3 100644 --- a/internal/api/client/reports/reportget.go +++ b/internal/api/client/reports/reportget.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/report" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ReportGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/reports/reportsget.go b/internal/api/client/reports/reportsget.go index 7d35fbd03..49a8ab163 100644 --- a/internal/api/client/reports/reportsget.go +++ b/internal/api/client/reports/reportsget.go @@ -108,14 +108,24 @@ import ( // type: string // description: Links to the next and previous queries. // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ReportsGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/scheduledstatuses/scheduledstatusdelete.go b/internal/api/client/scheduledstatuses/scheduledstatusdelete.go index efd645e2a..835eef453 100644 --- a/internal/api/client/scheduledstatuses/scheduledstatusdelete.go +++ b/internal/api/client/scheduledstatuses/scheduledstatusdelete.go @@ -53,14 +53,24 @@ import ( // '200': // description: status canceled // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ScheduledStatusDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/scheduledstatuses/scheduledstatusesget.go b/internal/api/client/scheduledstatuses/scheduledstatusesget.go index 6d08ff18b..ead8f22fb 100644 --- a/internal/api/client/scheduledstatuses/scheduledstatusesget.go +++ b/internal/api/client/scheduledstatuses/scheduledstatusesget.go @@ -84,14 +84,24 @@ import ( // items: // "$ref": "#/definitions/scheduledStatus" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ScheduledStatusesGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/scheduledstatuses/scheduledstatusget.go b/internal/api/client/scheduledstatuses/scheduledstatusget.go index 893c44938..16399f0a5 100644 --- a/internal/api/client/scheduledstatuses/scheduledstatusget.go +++ b/internal/api/client/scheduledstatuses/scheduledstatusget.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/scheduledStatus" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ScheduledStatusGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/scheduledstatuses/scheduledstatusput.go b/internal/api/client/scheduledstatuses/scheduledstatusput.go index 7b458a8d2..2042bd397 100644 --- a/internal/api/client/scheduledstatuses/scheduledstatusput.go +++ b/internal/api/client/scheduledstatuses/scheduledstatusput.go @@ -66,16 +66,28 @@ import ( // schema: // "$ref": "#/definitions/scheduledStatus" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) ScheduledStatusPUTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/search/searchget.go b/internal/api/client/search/searchget.go index a5dc2527f..11dd98e99 100644 --- a/internal/api/client/search/searchget.go +++ b/internal/api/client/search/searchget.go @@ -158,14 +158,24 @@ import ( // schema: // "$ref": "#/definitions/searchResult" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) SearchGETHandler(c *gin.Context) { apiVersion, errWithCode := apiutil.ParseAPIVersion( diff --git a/internal/api/client/statuses/statusbookmark.go b/internal/api/client/statuses/statusbookmark.go index 804044763..e05fbc31d 100644 --- a/internal/api/client/statuses/statusbookmark.go +++ b/internal/api/client/statuses/statusbookmark.go @@ -56,16 +56,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusBookmarkPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusboost.go b/internal/api/client/statuses/statusboost.go index 5e8418dec..559bef95e 100644 --- a/internal/api/client/statuses/statusboost.go +++ b/internal/api/client/statuses/statusboost.go @@ -59,16 +59,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusBoostPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusboostedby.go b/internal/api/client/statuses/statusboostedby.go index 70111afcc..33bfd333e 100644 --- a/internal/api/client/statuses/statusboostedby.go +++ b/internal/api/client/statuses/statusboostedby.go @@ -56,12 +56,20 @@ import ( // items: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found func (m *Module) StatusBoostedByGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statuscontext.go b/internal/api/client/statuses/statuscontext.go index 4a5e8abf3..fe8f0f217 100644 --- a/internal/api/client/statuses/statuscontext.go +++ b/internal/api/client/statuses/statuscontext.go @@ -58,16 +58,28 @@ import ( // schema: // "$ref": "#/definitions/threadContext" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusContextGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statuscreate.go b/internal/api/client/statuses/statuscreate.go index de06d2d8b..8b3c937a0 100644 --- a/internal/api/client/statuses/statuscreate.go +++ b/internal/api/client/statuses/statuscreate.go @@ -247,18 +247,32 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable content // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusCreatePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusdelete.go b/internal/api/client/statuses/statusdelete.go index 006b6e601..5148da370 100644 --- a/internal/api/client/statuses/statusdelete.go +++ b/internal/api/client/statuses/statusdelete.go @@ -58,16 +58,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusDELETEHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusedit.go b/internal/api/client/statuses/statusedit.go index 22d22da71..bf9c36dd7 100644 --- a/internal/api/client/statuses/statusedit.go +++ b/internal/api/client/statuses/statusedit.go @@ -149,16 +149,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusEditPUTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusfave.go b/internal/api/client/statuses/statusfave.go index 592eb86b2..13a44bab7 100644 --- a/internal/api/client/statuses/statusfave.go +++ b/internal/api/client/statuses/statusfave.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusFavePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusfavedby.go b/internal/api/client/statuses/statusfavedby.go index baa1bcf0d..3deb18f91 100644 --- a/internal/api/client/statuses/statusfavedby.go +++ b/internal/api/client/statuses/statusfavedby.go @@ -56,16 +56,28 @@ import ( // items: // "$ref": "#/definitions/account" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusFavedByGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusget.go b/internal/api/client/statuses/statusget.go index ac91f6e44..369d3d3f3 100644 --- a/internal/api/client/statuses/statusget.go +++ b/internal/api/client/statuses/statusget.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statushistory.go b/internal/api/client/statuses/statushistory.go index 2f94d38d1..bca7f5565 100644 --- a/internal/api/client/statuses/statushistory.go +++ b/internal/api/client/statuses/statushistory.go @@ -55,16 +55,28 @@ import ( // items: // "$ref": "#/definitions/statusEdit" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusHistoryGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusmute.go b/internal/api/client/statuses/statusmute.go index a73029f7c..50a925b01 100644 --- a/internal/api/client/statuses/statusmute.go +++ b/internal/api/client/statuses/statusmute.go @@ -59,16 +59,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request; you're not part of the target status thread // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusMutePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statuspin.go b/internal/api/client/statuses/statuspin.go index b12842ef2..1739d4cf5 100644 --- a/internal/api/client/statuses/statuspin.go +++ b/internal/api/client/statuses/statuspin.go @@ -61,16 +61,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusPinPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statussource.go b/internal/api/client/statuses/statussource.go index aed57098f..98cc68adb 100644 --- a/internal/api/client/statuses/statussource.go +++ b/internal/api/client/statuses/statussource.go @@ -55,16 +55,28 @@ import ( // items: // "$ref": "#/definitions/statusSource" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusSourceGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusunbookmark.go b/internal/api/client/statuses/statusunbookmark.go index 695600edf..4780b5146 100644 --- a/internal/api/client/statuses/statusunbookmark.go +++ b/internal/api/client/statuses/statusunbookmark.go @@ -56,16 +56,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusUnbookmarkPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusunboost.go b/internal/api/client/statuses/statusunboost.go index 7863696df..5c08d848a 100644 --- a/internal/api/client/statuses/statusunboost.go +++ b/internal/api/client/statuses/statusunboost.go @@ -56,16 +56,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusUnboostPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusunfave.go b/internal/api/client/statuses/statusunfave.go index a19c56eed..be990fb08 100644 --- a/internal/api/client/statuses/statusunfave.go +++ b/internal/api/client/statuses/statusunfave.go @@ -55,16 +55,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusUnfavePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusunmute.go b/internal/api/client/statuses/statusunmute.go index e1e89da3b..0f9689083 100644 --- a/internal/api/client/statuses/statusunmute.go +++ b/internal/api/client/statuses/statusunmute.go @@ -59,16 +59,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request; you're not part of the target status thread // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusUnmutePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/statuses/statusunpin.go b/internal/api/client/statuses/statusunpin.go index 90d1e7b7f..80d9fe41b 100644 --- a/internal/api/client/statuses/statusunpin.go +++ b/internal/api/client/statuses/statusunpin.go @@ -56,16 +56,28 @@ import ( // schema: // "$ref": "#/definitions/status" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) StatusUnpinPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/streaming/stream.go b/internal/api/client/streaming/stream.go index 5d7f17f94..7af540651 100644 --- a/internal/api/client/streaming/stream.go +++ b/internal/api/client/streaming/stream.go @@ -149,8 +149,12 @@ var pingMsg = []byte("ping!") // type: string // example: "{\"id\":\"01FC3TZ5CFG6H65GCKCJRKA669\",\"created_at\":\"2021-08-02T16:25:52Z\",\"sensitive\":false,\"spoiler_text\":\"\",\"visibility\":\"public\",\"language\":\"en\",\"uri\":\"https://gts.superseriousbusiness.org/users/dumpsterqueer/statuses/01FC3TZ5CFG6H65GCKCJRKA669\",\"url\":\"https://gts.superseriousbusiness.org/@dumpsterqueer/statuses/01FC3TZ5CFG6H65GCKCJRKA669\",\"replies_count\":0,\"reblogs_count\":0,\"favourites_count\":0,\"favourited\":false,\"reblogged\":false,\"muted\":false,\"bookmarked\":fals…//gts.superseriousbusiness.org/fileserver/01JNN207W98SGG3CBJ76R5MVDN/header/original/019036W043D8FXPJKSKCX7G965.png\",\"header_static\":\"https://gts.superseriousbusiness.org/fileserver/01JNN207W98SGG3CBJ76R5MVDN/header/small/019036W043D8FXPJKSKCX7G965.png\",\"followers_count\":33,\"following_count\":28,\"statuses_count\":126,\"last_status_at\":\"2021-08-02T16:25:52Z\",\"emojis\":[],\"fields\":[]},\"media_attachments\":[],\"mentions\":[],\"tags\":[],\"emojis\":[],\"card\":null,\"poll\":null,\"text\":\"a\"}" // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request func (m *Module) StreamGETHandler(c *gin.Context) { var ( diff --git a/internal/api/client/suggestions/suggestions.go b/internal/api/client/suggestions/suggestions.go index 1a63d900e..84e48e4db 100644 --- a/internal/api/client/suggestions/suggestions.go +++ b/internal/api/client/suggestions/suggestions.go @@ -65,10 +65,16 @@ func New(processor *processing.Processor) *Module { // type: object // maxItems: 0 // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable func (m *Module) SuggestionsGETHandler(c *gin.Context) { _, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/tags/follow.go b/internal/api/client/tags/follow.go index f8b81780a..e621378e0 100644 --- a/internal/api/client/tags/follow.go +++ b/internal/api/client/tags/follow.go @@ -55,12 +55,20 @@ import ( // schema: // "$ref": "#/definitions/tag" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) FollowTagPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/tags/get.go b/internal/api/client/tags/get.go index 0a88a418d..20ced1414 100644 --- a/internal/api/client/tags/get.go +++ b/internal/api/client/tags/get.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/tag" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) TagGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/tags/unfollow.go b/internal/api/client/tags/unfollow.go index 1dd0e6a9d..81c09b588 100644 --- a/internal/api/client/tags/unfollow.go +++ b/internal/api/client/tags/unfollow.go @@ -55,14 +55,24 @@ import ( // schema: // "$ref": "#/definitions/tag" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '404': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) UnfollowTagPOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/timelines/home.go b/internal/api/client/timelines/home.go index 9a7276bdd..bfc1c7479 100644 --- a/internal/api/client/timelines/home.go +++ b/internal/api/client/timelines/home.go @@ -103,8 +103,12 @@ import ( // type: string // description: Links to the next and previous queries. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request func (m *Module) HomeTimelineGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/timelines/list.go b/internal/api/client/timelines/list.go index e76107f1d..e2f77ce1d 100644 --- a/internal/api/client/timelines/list.go +++ b/internal/api/client/timelines/list.go @@ -102,8 +102,12 @@ import ( // type: string // description: Links to the next and previous queries. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request func (m *Module) ListTimelineGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/timelines/public.go b/internal/api/client/timelines/public.go index 5fa32ac03..4d8dead7c 100644 --- a/internal/api/client/timelines/public.go +++ b/internal/api/client/timelines/public.go @@ -104,8 +104,12 @@ import ( // type: string // description: Links to the next and previous queries. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request func (m *Module) PublicTimelineGETHandler(c *gin.Context) { var ( diff --git a/internal/api/client/timelines/tag.go b/internal/api/client/timelines/tag.go index daf88f528..8e77dd2fb 100644 --- a/internal/api/client/timelines/tag.go +++ b/internal/api/client/timelines/tag.go @@ -103,8 +103,12 @@ import ( // type: string // description: Links to the next and previous queries. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request func (m *Module) TagTimelineGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/tokens/tokenget.go b/internal/api/client/tokens/tokenget.go index c0ef980a3..6f9774dee 100644 --- a/internal/api/client/tokens/tokenget.go +++ b/internal/api/client/tokens/tokenget.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/tokenInfo" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) TokenInfoGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/tokens/tokeninvalidate.go b/internal/api/client/tokens/tokeninvalidate.go index e705e2635..702b83125 100644 --- a/internal/api/client/tokens/tokeninvalidate.go +++ b/internal/api/client/tokens/tokeninvalidate.go @@ -54,14 +54,24 @@ import ( // schema: // "$ref": "#/definitions/tokenInfo" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '404': +// schema: +// "$ref": "#/definitions/error" // description: not found // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal server error func (m *Module) TokenInvalidatePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/tokens/tokensget.go b/internal/api/client/tokens/tokensget.go index ee85c730f..b04e2deb0 100644 --- a/internal/api/client/tokens/tokensget.go +++ b/internal/api/client/tokens/tokensget.go @@ -98,8 +98,12 @@ import ( // type: string // description: Links to the next and previous queries. // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request func (m *Module) TokensInfoGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/trends/links.go b/internal/api/client/trends/links.go index 72444538e..3a8b77dcb 100644 --- a/internal/api/client/trends/links.go +++ b/internal/api/client/trends/links.go @@ -46,6 +46,8 @@ import ( // type: object // maxItems: 0 // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable func (m *Module) LinksGETHandler(c *gin.Context) { if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { diff --git a/internal/api/client/trends/statuses.go b/internal/api/client/trends/statuses.go index f8282095e..9e79e5072 100644 --- a/internal/api/client/trends/statuses.go +++ b/internal/api/client/trends/statuses.go @@ -46,6 +46,8 @@ import ( // type: object // maxItems: 0 // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable func (m *Module) StatusesGETHandler(c *gin.Context) { if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { diff --git a/internal/api/client/trends/tags.go b/internal/api/client/trends/tags.go index a309082bf..aa2fa81ef 100644 --- a/internal/api/client/trends/tags.go +++ b/internal/api/client/trends/tags.go @@ -46,6 +46,8 @@ import ( // type: object // maxItems: 0 // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable func (m *Module) TagsGETHandler(c *gin.Context) { if _, err := apiutil.NegotiateAccept(c, apiutil.JSONAcceptHeaders...); err != nil { diff --git a/internal/api/client/user/emailchange.go b/internal/api/client/user/emailchange.go index d0238824d..96895af10 100644 --- a/internal/api/client/user/emailchange.go +++ b/internal/api/client/user/emailchange.go @@ -53,16 +53,28 @@ import ( // schema: // "$ref": "#/definitions/user" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: "Conflict: desired email address already in use" // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) EmailChangePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/user/passwordchange.go b/internal/api/client/user/passwordchange.go index caa90583f..dc2443b73 100644 --- a/internal/api/client/user/passwordchange.go +++ b/internal/api/client/user/passwordchange.go @@ -57,16 +57,28 @@ const OIDCPasswordHelp = "password change request cannot be processed by GoToSoc // '200': // description: Change successful // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable request because instance is running with OIDC backend // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) PasswordChangePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/user/twofactor.go b/internal/api/client/user/twofactor.go index a359607e4..e97aaeea1 100644 --- a/internal/api/client/user/twofactor.go +++ b/internal/api/client/user/twofactor.go @@ -55,16 +55,28 @@ const OIDCTwoFactorHelp = "two factor authentication request cannot be processed // '200': // description: QR code png // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable entity // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) TwoFactorQRCodePngGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, @@ -134,16 +146,28 @@ func (m *Module) TwoFactorQRCodePngGETHandler(c *gin.Context) { // '200': // description: QR code uri // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable entity // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) TwoFactorQRCodeURIGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, @@ -216,16 +240,28 @@ func (m *Module) TwoFactorQRCodeURIGETHandler(c *gin.Context) { // '200': // description: QR code // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable entity // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) TwoFactorEnablePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, @@ -300,16 +336,28 @@ func (m *Module) TwoFactorEnablePOSTHandler(c *gin.Context) { // '200': // description: QR code // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '409': +// schema: +// "$ref": "#/definitions/error" // description: conflict // '422': +// schema: +// "$ref": "#/definitions/error" // description: unprocessable entity // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) TwoFactorDisablePOSTHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/client/user/userget.go b/internal/api/client/user/userget.go index ff92815b6..ec9a13450 100644 --- a/internal/api/client/user/userget.go +++ b/internal/api/client/user/userget.go @@ -46,14 +46,24 @@ import ( // schema: // "$ref": "#/definitions/user" // '400': +// schema: +// "$ref": "#/definitions/error" // description: bad request // '401': +// schema: +// "$ref": "#/definitions/error" // description: unauthorized // '403': +// schema: +// "$ref": "#/definitions/error" // description: forbidden // '406': +// schema: +// "$ref": "#/definitions/error" // description: not acceptable // '500': +// schema: +// "$ref": "#/definitions/error" // description: internal error func (m *Module) UserGETHandler(c *gin.Context) { authed, errWithCode := apiutil.TokenAuth(c, diff --git a/internal/api/model/application.go b/internal/api/model/application.go index 3f974683f..e43c2edb3 100644 --- a/internal/api/model/application.go +++ b/internal/api/model/application.go @@ -37,7 +37,7 @@ type Application struct { // example: https://example.org/callback?some=query RedirectURI string `json:"redirect_uri,omitempty"` // Post-authorization redirect URIs for the application (OAuth2). - // example: [https://example.org/callback?some=query] + // example: ["https://example.org/callback?some=query"] RedirectURIs []string `json:"redirect_uris,omitempty"` // Client ID associated with this application. ClientID string `json:"client_id,omitempty"` diff --git a/internal/api/model/error.go b/internal/api/model/error.go new file mode 100644 index 000000000..6ec073790 --- /dev/null +++ b/internal/api/model/error.go @@ -0,0 +1,32 @@ +// GoToSocial +// Copyright (C) GoToSocial Authors admin@gotosocial.org +// SPDX-License-Identifier: AGPL-3.0-or-later +// +// This program is free software: you can redistribute it and/or modify +// it under the terms of the GNU Affero General Public License as published by +// the Free Software Foundation, either version 3 of the License, or +// (at your option) any later version. +// +// This program is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +// GNU Affero General Public License for more details. +// +// You should have received a copy of the GNU Affero General Public License +// along with this program. If not, see <http://www.gnu.org/licenses/>. + +package model + +// Error is a generic public-facing API error. +// +// swagger:model error +type Error struct { + // Error is usually a human-readable description of the error. + // + // For OAuth-related errors, it will be one of the codes listed in + // <https://datatracker.ietf.org/doc/html/rfc6749#section-5.2>. + Error string `json:"error"` + + // ErrorDescription is only used for OAuth errors, and is a human-readable description of the error. + ErrorDescription string `json:"error_description,omitempty"` +} diff --git a/internal/api/util/errorhandling.go b/internal/api/util/errorhandling.go index 7ffbbbf88..f2f4d94a7 100644 --- a/internal/api/util/errorhandling.go +++ b/internal/api/util/errorhandling.go @@ -43,7 +43,7 @@ import ( // If an error is returned by InstanceGet, the function will panic. func NotFoundHandler(c *gin.Context, instanceGet func(ctx context.Context) (*apimodel.InstanceV1, gtserror.WithCode), accept string, errWithCode gtserror.WithCode) { switch accept { - case string(TextHTML): + case TextHTML: ctx := c.Request.Context() instance, err := instanceGet(ctx) if err != nil { @@ -55,8 +55,8 @@ func NotFoundHandler(c *gin.Context, instanceGet func(ctx context.Context) (*api gtscontext.RequestID(ctx), ) default: - JSON(c, http.StatusNotFound, map[string]string{ - "error": errWithCode.Safe(), + JSON(c, http.StatusNotFound, apimodel.Error{ + Error: errWithCode.Safe(), }) } } @@ -66,7 +66,7 @@ func NotFoundHandler(c *gin.Context, instanceGet func(ctx context.Context) (*api // or just some error json if the caller prefers (or has no preference). func genericErrorHandler(c *gin.Context, instanceGet func(ctx context.Context) (*apimodel.InstanceV1, gtserror.WithCode), accept string, errWithCode gtserror.WithCode) { switch accept { - case string(TextHTML): + case TextHTML: ctx := c.Request.Context() instance, err := instanceGet(ctx) if err != nil { @@ -80,8 +80,8 @@ func genericErrorHandler(c *gin.Context, instanceGet func(ctx context.Context) ( gtscontext.RequestID(ctx), ) default: - JSON(c, errWithCode.Code(), map[string]string{ - "error": errWithCode.Safe(), + JSON(c, errWithCode.Code(), apimodel.Error{ + Error: errWithCode.Safe(), }) } } @@ -179,9 +179,9 @@ func OAuthErrorHandler(c *gin.Context, errWithCode gtserror.WithCode) { l.Debug("handling OAuth error") } - JSON(c, statusCode, map[string]string{ - "error": errWithCode.Error(), - "error_description": errWithCode.Safe(), + JSON(c, statusCode, apimodel.Error{ + Error: errWithCode.Error(), + ErrorDescription: errWithCode.Safe(), }) } @@ -189,8 +189,8 @@ func OAuthErrorHandler(c *gin.Context, errWithCode gtserror.WithCode) { // Specifically used for accounts trying to access endpoints they cannot use while moving. func NotFoundAfterMove(c *gin.Context) { const errMsg = "your account has Moved or is currently Moving; you cannot use this endpoint" - JSON(c, http.StatusForbidden, map[string]string{ - "error": errMsg, + JSON(c, http.StatusForbidden, apimodel.Error{ + Error: errMsg, }) } @@ -198,7 +198,7 @@ func NotFoundAfterMove(c *gin.Context) { // Specifically used for accounts trying to take actions on endpoints they cannot do while moving. func ForbiddenAfterMove(c *gin.Context) { const errMsg = "your account has Moved or is currently Moving; you cannot take create or update type actions" - JSON(c, http.StatusForbidden, map[string]string{ - "error": errMsg, + JSON(c, http.StatusForbidden, apimodel.Error{ + Error: errMsg, }) } |