60 lines
1.3 KiB
Markdown
60 lines
1.3 KiB
Markdown
---
|
|
title: List
|
|
description: Represents a list of some users that the authenticated user follows.
|
|
menu:
|
|
docs:
|
|
parent: entities
|
|
aliases: [
|
|
"/entities/list",
|
|
"/entities/List",
|
|
"/api/entities/list",
|
|
"/api/entities/List",
|
|
]
|
|
---
|
|
|
|
## Example
|
|
|
|
```json
|
|
{
|
|
"id": "12249",
|
|
"title": "Friends"
|
|
}
|
|
```
|
|
|
|
## Required attributes
|
|
|
|
### `id` {#id}
|
|
|
|
**Description:** The internal database ID of the list.\
|
|
**Type:** String (cast from an integer, but not guaranteed to be a number)\
|
|
**Version history:**\
|
|
2.1.0 - added
|
|
|
|
### `title` {#title}
|
|
|
|
**Description:** The user-defined title of the list.\
|
|
**Type:** String\
|
|
**Version history:**\
|
|
2.1.0 - added
|
|
|
|
### `replies_policy` {#replies_policy}
|
|
|
|
**Description:** Which replies should be shown in the list.\
|
|
**Type:** String (Enumerable oneOf)\
|
|
`followed` = Show replies to any followed user\
|
|
`list` = Show replies to members of the list\
|
|
`none` = Show replies to no one\
|
|
**Version history:**\
|
|
3.3.0 - added
|
|
|
|
## See also
|
|
|
|
{{< page-relref ref="methods/accounts#lists" caption="GET /api/v1/accounts/:id/lists" >}}
|
|
|
|
{{< page-relref ref="methods/lists" caption="lists API methods" >}}
|
|
|
|
{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/list_serializer.rb" caption="app/serializers/rest/list_serializer.rb" >}}
|
|
|
|
|
|
|