summaryrefslogtreecommitdiff
path: root/docs/api
diff options
context:
space:
mode:
Diffstat (limited to 'docs/api')
-rw-r--r--docs/api/swagger.yaml39
1 files changed, 39 insertions, 0 deletions
diff --git a/docs/api/swagger.yaml b/docs/api/swagger.yaml
index eb9ec82ee..db1d136b8 100644
--- a/docs/api/swagger.yaml
+++ b/docs/api/swagger.yaml
@@ -2944,6 +2944,45 @@ paths:
summary: See all lists of yours that contain requested account.
tags:
- accounts
+ /api/v1/accounts/{id}/note:
+ post:
+ consumes:
+ - multipart/form-data
+ operationId: accountNote
+ parameters:
+ - description: The id of the account for which to set a note.
+ in: path
+ name: id
+ required: true
+ type: string
+ - default: ""
+ description: The text of the note. Omit this parameter or send an empty string to clear the note.
+ in: formData
+ name: comment
+ type: string
+ produces:
+ - application/json
+ responses:
+ "200":
+ description: Your relationship to the account.
+ schema:
+ $ref: '#/definitions/accountRelationship'
+ "400":
+ description: bad request
+ "401":
+ description: unauthorized
+ "404":
+ description: not found
+ "406":
+ description: not acceptable
+ "500":
+ description: internal server error
+ security:
+ - OAuth2 Bearer:
+ - write:accounts
+ summary: Set a private note for an account with the given id.
+ tags:
+ - accounts
/api/v1/accounts/{id}/statuses:
get:
description: The statuses will be returned in descending chronological order (newest first), with sequential IDs (bigger = newer).