Moves List and Lists around (#509)
* Moves List and Lists around to keep methods and entities sorted alphabetically. * Updates Lists descriptions
This commit is contained in:
parent
e0d81f251c
commit
ab91b5b072
|
@ -14,6 +14,7 @@ API overview
|
||||||
- [Follow Requests](#follow-requests)
|
- [Follow Requests](#follow-requests)
|
||||||
- [Follows](#follows)
|
- [Follows](#follows)
|
||||||
- [Instances](#instances)
|
- [Instances](#instances)
|
||||||
|
- [Lists](#lists)
|
||||||
- [Media](#media)
|
- [Media](#media)
|
||||||
- [Mutes](#mutes)
|
- [Mutes](#mutes)
|
||||||
- [Notifications](#notifications)
|
- [Notifications](#notifications)
|
||||||
|
@ -21,7 +22,6 @@ API overview
|
||||||
- [Search](#search)
|
- [Search](#search)
|
||||||
- [Statuses](#statuses)
|
- [Statuses](#statuses)
|
||||||
- [Timelines](#timelines)
|
- [Timelines](#timelines)
|
||||||
- [Lists](#lists)
|
|
||||||
- [Entities](#entities)
|
- [Entities](#entities)
|
||||||
- [Account](#account)
|
- [Account](#account)
|
||||||
- [Application](#application)
|
- [Application](#application)
|
||||||
|
@ -31,13 +31,13 @@ API overview
|
||||||
- [Emoji](#emoji)
|
- [Emoji](#emoji)
|
||||||
- [Error](#error)
|
- [Error](#error)
|
||||||
- [Instance](#instance)
|
- [Instance](#instance)
|
||||||
|
- [List](#list)
|
||||||
- [Mention](#mention)
|
- [Mention](#mention)
|
||||||
- [Notification](#notification)
|
- [Notification](#notification)
|
||||||
- [Relationship](#relationship)
|
- [Relationship](#relationship)
|
||||||
- [Results](#results)
|
- [Results](#results)
|
||||||
- [Status](#status)
|
- [Status](#status)
|
||||||
- [Tag](#tag)
|
- [Tag](#tag)
|
||||||
- [List](#list)
|
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
|
@ -369,6 +369,66 @@ Returns a list of [Emoji](#emoji)
|
||||||
|
|
||||||
Does not require authentication.
|
Does not require authentication.
|
||||||
|
|
||||||
|
### Lists
|
||||||
|
|
||||||
|
#### Retrieving lists
|
||||||
|
|
||||||
|
GET /api/v1/lists
|
||||||
|
|
||||||
|
Returns at most 50 [Lists](#list) without pagination.
|
||||||
|
|
||||||
|
#### Retrieving lists by membership
|
||||||
|
|
||||||
|
GET /api/v1/accounts/:id/lists
|
||||||
|
|
||||||
|
Returns at most 50 [Lists](#list) without pagination.
|
||||||
|
|
||||||
|
#### Retrieving accounts in a list
|
||||||
|
|
||||||
|
GET /api/v1/lists/:id/accounts
|
||||||
|
|
||||||
|
Returns [Accounts](#account) in the list. If you specify `limit=0` in the query, all accounts will be returned without pagination. Otherwise, standard account pagination rules apply.
|
||||||
|
|
||||||
|
#### Retrieving a list
|
||||||
|
|
||||||
|
GET /api/v1/lists/:id
|
||||||
|
|
||||||
|
Returns a [Lists](#list).
|
||||||
|
|
||||||
|
#### Creating and updating a list
|
||||||
|
|
||||||
|
POST /api/v1/lists
|
||||||
|
PUT /api/v1/lists/:id
|
||||||
|
|
||||||
|
Form data:
|
||||||
|
|
||||||
|
| Field | Description | Optional |
|
||||||
|
| ---------------- | --------------------- | --------- |
|
||||||
|
| `title` | The title of the list | no |
|
||||||
|
|
||||||
|
Returns a [Lists](#list).
|
||||||
|
|
||||||
|
#### Deleting a list
|
||||||
|
|
||||||
|
DELETE /api/v1/lists/:id
|
||||||
|
|
||||||
|
Returns an empty object.
|
||||||
|
|
||||||
|
#### Adding/removing accounts to/from a list
|
||||||
|
|
||||||
|
POST /api/v1/lists/:id/accounts
|
||||||
|
DELETE /api/v1/lists/:id/accounts
|
||||||
|
|
||||||
|
Form data:
|
||||||
|
|
||||||
|
| Field | Description | Optional |
|
||||||
|
| ---------------- | ----------------------------------------- | --------- |
|
||||||
|
| `account_ids` | [Array](#parameter-types) of account IDs | no |
|
||||||
|
|
||||||
|
> **Note:** Only accounts already followed by the authenticated user can be added to a list.
|
||||||
|
|
||||||
|
Returns an empty object.
|
||||||
|
|
||||||
### Media
|
### Media
|
||||||
|
|
||||||
#### Uploading a media attachment:
|
#### Uploading a media attachment:
|
||||||
|
@ -610,54 +670,6 @@ Returns an array of [Statuses](#status), most recent ones first.
|
||||||
|
|
||||||
Public and tag timelines do not require authentication.
|
Public and tag timelines do not require authentication.
|
||||||
|
|
||||||
### Lists
|
|
||||||
|
|
||||||
#### Retrieving lists
|
|
||||||
|
|
||||||
GET /api/v1/lists
|
|
||||||
|
|
||||||
Returns at most 50 [Lists](#list) without pagination.
|
|
||||||
|
|
||||||
#### Retrieving lists by membership
|
|
||||||
|
|
||||||
GET /api/v1/accounts/:id/lists
|
|
||||||
|
|
||||||
Returns at most 50 [Lists](#list) without pagination.
|
|
||||||
|
|
||||||
#### Retrieving accounts in a list
|
|
||||||
|
|
||||||
GET /api/v1/lists/:id/accounts
|
|
||||||
|
|
||||||
Returns [Accounts](#account) in the list. If you specify `limit=0` in the query, all accounts will be returned without pagination. Otherwise, standard account pagination rules apply.
|
|
||||||
|
|
||||||
#### Retrieving, creating, updating, deleting a list
|
|
||||||
|
|
||||||
GET /api/v1/lists/:id
|
|
||||||
POST /api/v1/lists
|
|
||||||
PUT /api/v1/lists/:id
|
|
||||||
DELETE /api/v1/lists/:id
|
|
||||||
|
|
||||||
Form data:
|
|
||||||
|
|
||||||
| Field | Description | Optional |
|
|
||||||
| ---------------- | --------------------- | --------- |
|
|
||||||
| `title` | The title of the list | no |
|
|
||||||
|
|
||||||
> **Note:** There is a limit of 50 lists.
|
|
||||||
|
|
||||||
#### Adding/removing accounts to/from a list
|
|
||||||
|
|
||||||
POST /api/v1/lists/:id/accounts
|
|
||||||
DELETE /api/v1/lists/:id/accounts
|
|
||||||
|
|
||||||
Form data:
|
|
||||||
|
|
||||||
| Field | Description | Optional |
|
|
||||||
| ---------------- | ----------------------------------------- | --------- |
|
|
||||||
| `account_ids` | [Array](#parameter-types) of account IDs | no |
|
|
||||||
|
|
||||||
> **Note:** Only accounts already followed by the authenticated user can be added to a list.
|
|
||||||
|
|
||||||
___
|
___
|
||||||
|
|
||||||
## Entities
|
## Entities
|
||||||
|
@ -758,6 +770,13 @@ The most important part of an error response is the HTTP status code. Standard s
|
||||||
| `version` | The Mastodon version used by instance. | no |
|
| `version` | The Mastodon version used by instance. | no |
|
||||||
| `urls` | `streaming_api` | no |
|
| `urls` | `streaming_api` | no |
|
||||||
|
|
||||||
|
### List
|
||||||
|
|
||||||
|
| Attribute | Description | Nullable |
|
||||||
|
|-----------|-------------------|----------|
|
||||||
|
| `id` | ID of the list | no |
|
||||||
|
| `title` | Title of the list | no |
|
||||||
|
|
||||||
### Mention
|
### Mention
|
||||||
|
|
||||||
| Attribute | Description | Nullable |
|
| Attribute | Description | Nullable |
|
||||||
|
@ -842,10 +861,3 @@ The most important part of an error response is the HTTP status code. Standard s
|
||||||
| ------------------------ | -------------------------------------------- | -------- |
|
| ------------------------ | -------------------------------------------- | -------- |
|
||||||
| `name` | The hashtag, not including the preceding `#` | no |
|
| `name` | The hashtag, not including the preceding `#` | no |
|
||||||
| `url` | The URL of the hashtag | no |
|
| `url` | The URL of the hashtag | no |
|
||||||
|
|
||||||
### List
|
|
||||||
|
|
||||||
| Attribute | Description | Nullable |
|
|
||||||
|-----------|-------------------|----------|
|
|
||||||
| `id` | ID of the list | no |
|
|
||||||
| `title` | Title of the list | no |
|
|
||||||
|
|
Loading…
Reference in New Issue