diff options
| author |  tobi <31960611+tsmethurst@users.noreply.github.com> | 2022-12-10 22:43:11 +0100 |
|---|---|---|
| committer |  GitHub <noreply@github.com> | 2022-12-10 21:43:11 +0000 |
| commit | 5e060d0bcb9af77e7b6d11acba99db6219d4f68e (patch) | |
| tree | 8dee821f5577ed38be754d73370ed2b74c8f0d2b /docs/api | |
| parent | [chore] make single pull request template (#1239) (diff) | |
| download | gotosocial-5e060d0bcb9af77e7b6d11acba99db6219d4f68e.tar.xz | |
[feature] Start implementing refetch of lost media files via `/api/v1/admin/media_refetch` (#1221)
* [chore] Move ShortcodeDomain to its own little util func
* [feature] Add RefetchEmojis function to media manager
* [feature] Expose admin media refresh via admin API
* update following review feedback
- change/fix log levels
- make sure not to try to refetch local emojis
- small style refactoring + comments
* log on emoji refetch start
Signed-off-by: kim <grufwub@gmail.com>
Co-authored-by: kim <grufwub@gmail.com>
Diffstat (limited to 'docs/api')
| -rw-r--r-- | docs/api/swagger.yaml | 34 |
1 files changed, 34 insertions, 0 deletions
diff --git a/docs/api/swagger.yaml b/docs/api/swagger.yaml index ac2b1f303..fe0890fb5 100644 --- a/docs/api/swagger.yaml +++ b/docs/api/swagger.yaml @@ -3209,6 +3209,40 @@ paths: summary: Clean up remote media older than the specified number of days. tags: - admin + /api/v1/admin/media_refetch: + post: + description: |- + Currently, this only includes remote emojis. + This endpoint is useful when data loss has occurred, and you want to try to recover to a working state. + operationId: mediaRefetch + parameters: + - description: Domain to refetch media from. If empty, all domains will be refetched. + in: query + name: domain + type: string + produces: + - application/json + responses: + "202": + description: Request accepted and will be processed. Check the logs for progress / errors. + "400": + description: bad request + "401": + description: unauthorized + "403": + description: forbidden + "404": + description: not found + "406": + description: not acceptable + "500": + description: internal server error + security: + - OAuth2 Bearer: + - admin + summary: Refetch media specified in the database but missing from storage. + tags: + - admin /api/v1/apps: post: consumes: |