diff --git a/docs/api/swagger.yaml b/docs/api/swagger.yaml index 0d75a6a12..42cd0ee59 100644 --- a/docs/api/swagger.yaml +++ b/docs/api/swagger.yaml @@ -3128,6 +3128,30 @@ paths: summary: Get an array of accounts that requesting account has blocked. tags: - blocks + /api/v1/custom_emojis: + get: + operationId: customEmojisGet + produces: + - application/json + responses: + "200": + description: Array of custom emojis. + schema: + items: + $ref: '#/definitions/emoji' + type: array + "401": + description: unauthorized + "406": + description: not acceptable + "500": + description: internal server error + security: + - OAuth2 Bearer: + - read:custom_emojis + summary: Get an array of custom emojis available on the instance. + tags: + - custom_emojis /api/v1/follow_requests: get: description: |- @@ -4451,6 +4475,7 @@ securityDefinitions: read: grants read access to everything read:accounts: grants read access to accounts read:blocks: grant read access to blocks + read:custom_emojis: grant read access to custom_emojis read:media: grant read access to media read:notifications: grants read access to notifications read:search: grant read access to searches diff --git a/docs/swagger.go b/docs/swagger.go index ccf86a4cc..b4d497b71 100644 --- a/docs/swagger.go +++ b/docs/swagger.go @@ -36,6 +36,7 @@ // read: grants read access to everything // read:accounts: grants read access to accounts // read:blocks: grant read access to blocks +// read:custom_emojis: grant read access to custom_emojis // read:media: grant read access to media // read:search: grant read access to searches // read:statuses: grants read access to statuses diff --git a/internal/api/client/emoji/emojisget.go b/internal/api/client/emoji/emojisget.go index 488aad78b..c5a2ced63 100644 --- a/internal/api/client/emoji/emojisget.go +++ b/internal/api/client/emoji/emojisget.go @@ -9,7 +9,34 @@ "github.com/superseriousbusiness/gotosocial/internal/oauth" ) -// EmojisGETHandler returns a list of custom emojis enabled on the instance +// EmojisGETHandler swagger:operation GET /api/v1/custom_emojis customEmojisGet +// +// Get an array of custom emojis available on the instance. +// +// --- +// tags: +// - custom_emojis +// +// produces: +// - application/json +// +// security: +// - OAuth2 Bearer: +// - read:custom_emojis +// +// responses: +// '200': +// description: Array of custom emojis. +// schema: +// type: array +// items: +// "$ref": "#/definitions/emoji" +// '401': +// description: unauthorized +// '406': +// description: not acceptable +// '500': +// description: internal server error func (m *Module) EmojisGETHandler(c *gin.Context) { if _, err := oauth.Authed(c, true, true, true, true); err != nil { api.ErrorHandler(c, gtserror.NewErrorUnauthorized(err, err.Error()), m.processor.InstanceGet)