summaryrefslogtreecommitdiff
path: root/docs/api
diff options
context:
space:
mode:
authorLibravatar tobi <31960611+tsmethurst@users.noreply.github.com>2022-10-13 16:37:55 +0200
committerLibravatar GitHub <noreply@github.com>2022-10-13 16:37:55 +0200
commit6a95f5fa67ad27937198e0c9e25e3d8fe1f2bd2c (patch)
treee5abbdc2cdc2d4662ac3d22ebbf8503f1ad61b7f /docs/api
parent[feature] Refetch emojis when they change on remote instances (#905) (diff)
downloadgotosocial-6a95f5fa67ad27937198e0c9e25e3d8fe1f2bd2c.tar.xz
[feature] Add `/api/v1/admin/custom_emojis/{id}` endpoint for single emoji GET (#910)
* fix error in prev swagger docs * add GET for single admin emoji
Diffstat (limited to 'docs/api')
-rw-r--r--docs/api/swagger.yaml35
1 files changed, 33 insertions, 2 deletions
diff --git a/docs/api/swagger.yaml b/docs/api/swagger.yaml
index 5330d080f..bef064102 100644
--- a/docs/api/swagger.yaml
+++ b/docs/api/swagger.yaml
@@ -2773,8 +2773,8 @@ paths:
in: query
name: filter
type: string
- - default: 30
- description: Number of emojis to return. If below 1, will be set to 1, if greater than 50, will be set to 50.
+ - default: 50
+ description: Number of emojis to return. Less than 1, or not set, means unlimited (all emojis).
in: query
name: limit
type: integer
@@ -2861,6 +2861,37 @@ paths:
summary: Upload and create a new instance emoji.
tags:
- admin
+ /api/v1/admin/custom_emojis/{id}:
+ get:
+ operationId: emojiGet
+ parameters:
+ - description: The id of the emoji.
+ in: path
+ name: id
+ required: true
+ type: string
+ produces:
+ - application/json
+ responses:
+ "200":
+ description: A single emoji.
+ schema:
+ $ref: '#/definitions/adminEmoji'
+ "400":
+ description: bad request
+ "401":
+ description: unauthorized
+ "403":
+ description: forbidden
+ "404":
+ description: not found
+ "406":
+ description: not acceptable
+ "500":
+ description: internal server error
+ summary: Get the admin view of a single emoji.
+ tags:
+ - admin
/api/v1/admin/domain_blocks:
get:
operationId: domainBlocksGet