title: mutes API methods description: View your mutes. See also accounts/:id/{mute,unmute} menu: docs:
weight: 30
name: mutes
parent: methods-accounts
identifier: methods-mutes
aliases: [ "/methods/mutes", "/api/methods/mutes", "/methods/accounts/mutes",
GET /api/v1/mutes HTTP/1.1
Accounts the user has muted.
Returns: Array of Account\
OAuth: User token + read:mutes
or follow
\
Version history:\
0.0.0 - added\
3.3.0 - added mute_expires_at
. both min_id
and max_id
can be used at the same time now
Authorization
: {{}} Provide this header with Bearer <user token>
to gain authorized access to this API method.
max_id
: Internal parameter. Use HTTP Link
header for pagination.
since_id
: Internal parameter. Use HTTP Link
header for pagination.
limit : Integer. Maximum number of results to return. Defaults to 40 accounts. Max 80 accounts.
Sample response with limit=2.
[
{
"id": "963076",
"username": "Simia91",
"acct": "Simia91",
"display_name": "",
// ...
},
{
"id": "1001524",
"username": "hakogamae",
"acct": "hakogamae",
"display_name": "Hakogamae 🔞",
// ...
}
]
Because Mute IDs are generally not exposed via any API responses, you will have to parse the HTTP Link
header to load older or newer results. See Paginating through API responses for more information.
Link: <https://mastodon.example/api/v1/mutes?limit=2&max_id=317646>; rel="next", <https://mastodon.example/api/v1/mutes?limit=2&since_id=317647>; rel="prev"
Invalid or missing Authorization header.
{
"error": "The access token is invalid"
}
{{< page-relref ref="methods/accounts#mute" caption="POST /api/v1/accounts/:id/mute" >}}
{{< page-relref ref="methods/accounts#unmute" caption="POST /api/v1/accounts/:id/unmute" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/controllers/api/v1/mutes_controller.rb" caption="app/controllers/api/v1/mutes_controller.rb" >}}