User Mutes

Get muted users

get

/v1/mutes

Returns a paginated list of users muted by the authenticated user. Supports filtering by a single address or multiple addresses.

Authorizations

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Query parameters

limitinteger · min: 1 · max: 100Optional

Number of results per page Values above the maximum are reduced to it.

Default: 10

offsetinteger · max: 100000Optional

Number of results to skip Values above the maximum are capped rather than rejected, so paging past it returns the last page again.

Default: 0

addressstringOptional

Filter by a single muted address

addressesstring[]Optional

Filter by multiple muted addresses (e.g. ?addresses=0x1&addresses=0x2)

Responses

200

List of muted users

application/json

400

Missing authentication

application/json

500

Internal server error

application/json

get/v1/mutes

GET /v1/mutes HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": {
    "results": [
      {
        "address": "text",
        "muted_at": "2026-01-01T00:00:00.000Z"
      }
    ],
    "total": 1,
    "limit": 1,
    "offset": 1,
    "page": 1,
    "pages": 1
  }
}

Mute a user

post

/v1/mutes

Mutes a user by adding a mute record. The muter is identified via Signed Fetch authentication. Muting yourself returns a 400 error. Muting an already-muted user is idempotent (returns 204).

Authorizations

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Body

muted_addressstringRequired

Ethereum address of the user to mute

Example: 0x0000000000000000000000000000000000000001

Responses

204

User muted successfully

No content

400

Invalid request (invalid address, self-mute, or missing authentication)

application/json

500

Internal server error

application/json

post/v1/mutes

POST /v1/mutes HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 62

{
  "muted_address": "0x0000000000000000000000000000000000000001"
}

No content

Unmute a user

delete

/v1/mutes

Removes a mute record for a user. The muter is identified via Signed Fetch authentication. Unmuting a user that is not muted is a no-op (returns 204).

Authorizations

AuthorizationstringRequired

Signed Fetch authentication. See ADR-44 for more details about the authentication mechanism.

Body

muted_addressstringRequired

Ethereum address of the user to unmute

Example: 0x0000000000000000000000000000000000000001

Responses

204

User unmuted successfully

No content

400

Invalid request (invalid address or missing authentication)

application/json

500

Internal server error

application/json

delete/v1/mutes

DELETE /v1/mutes HTTP/1.1
Host: social-api.decentraland.org
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 62

{
  "muted_address": "0x0000000000000000000000000000000000000001"
}

No content