summaryrefslogtreecommitdiff
path: root/docs/api
diff options
context:
space:
mode:
Diffstat (limited to 'docs/api')
-rw-r--r--docs/api/swagger.yaml49
1 files changed, 49 insertions, 0 deletions
diff --git a/docs/api/swagger.yaml b/docs/api/swagger.yaml
index 1d5b80ed1..9c21a0a31 100644
--- a/docs/api/swagger.yaml
+++ b/docs/api/swagger.yaml
@@ -7128,6 +7128,55 @@ paths:
summary: Get an array of all hashtags that you currently follow.
tags:
- tags
+ /api/v1/import:
+ post:
+ consumes:
+ - multipart/form-data
+ description: |-
+ This can be used to migrate data from a Mastodon-compatible CSV file to a GoToSocial account.
+
+ Uploaded data will be processed asynchronously, and not all entries may be processed depending
+ on domain blocks, user-level blocks, network availability of referenced accounts and statuses, etc.
+ operationId: importData
+ parameters:
+ - description: The CSV data file to upload.
+ in: formData
+ name: data
+ required: true
+ type: file
+ - description: |-
+ Type of entries contained in the data file:
+ - `following` - accounts to follow. - `blocks` - accounts to block.
+ in: formData
+ name: type
+ required: true
+ type: string
+ - default: merge
+ description: |-
+ Mode to use when creating entries from the data file:
+ - `merge` to merge entries in file with existing entries. - `overwrite` to replace existing entries with entries in file.
+ in: formData
+ name: mode
+ type: string
+ produces:
+ - application/json
+ responses:
+ "202":
+ description: Upload accepted.
+ "400":
+ description: bad request
+ "401":
+ description: unauthorized
+ "406":
+ description: not acceptable
+ "500":
+ description: internal server error
+ security:
+ - OAuth2 Bearer:
+ - write:accounts
+ summary: Upload some CSV-formatted data to your account.
+ tags:
+ - import-export
/api/v1/instance:
get:
operationId: instanceGetV1