Muting

• Mute a User
• Unmute a User
• List muted Users
• Retrieve muted User IDs for multiple Users

Mute a User

Hide all posts for a User in all streams. If you still explicitly request this User’s stream or a Post from this User, it will not be hidden.

This endpoint responds to general User parameters.

Endpoint

Method	URL	Token	Scope
POST	https://alpha-api.app.net/stream/0/users/{user_id}/mute	User	follow

URL Parameters

Name	Description
user_id	The id of the User to mute. You can also specify @username as a user_id.

Example

curl -X POST -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://alpha-api.app.net/stream/0/users/1558/mute"

{
  "data": {
    "avatar_image": {
      "height": 200,
      "is_default": false,
      "url": "https://d2rfichhc2fb9n.cloudfront.net/image/5/aoveeP73f33UcFhyhqzn7VhwgS17InMiOiJzMyIsImIiOiJhZG4tdXNlci1hc3NldHMiLCJrIjoiYXNzZXRzL3VzZXIvOTkvYTYvNDAvOTlhNjQwMDAwMDAwMDAwMC5wbmciLCJvIjoiIn0",
      "width": 200
    },
    "canonical_url": "https://alpha.app.net/adnapi",
    "counts": {
      "followers": 1549,
      "following": 12,
      "posts": 115,
      "stars": 4
    },
    "cover_image": {
      "height": 260,
      "is_default": true,
      "url": "https://d2rfichhc2fb9n.cloudfront.net/image/5/kZ-JRmTbmd3WVPswTJ8Nwxzkf917InMiOiJzMyIsImIiOiJ0YXBwLWFzc2V0cyIsImsiOiJpL1UvaS9ZL1VpWW5xRFNvTUtyTEhLNXA0OHN2NkxmTmRVMC5qcGciLCJvIjoiIn0",
      "width": 960
    },
    "created_at": "2012-08-10T22:40:12Z",
    "description": {
      "entities": {
        "hashtags": [

        ],
        "links": [
          {
            "len": 7,
            "pos": 31,
            "text": "App.net",
            "url": "http://App.net"
          }
        ],
        "mentions": [

        ]
      },
      "html": "<span itemscope=\"https://app.net/schemas/Post\">Updating you on changes to the <a href=\"http://App.net\">App.net</a> API</span>",
      "text": "Updating you on changes to the App.net API"
    },
    "id": "1558",
    "locale": "en_US",
    "name": "ADN API",
    "timezone": "America/Los_Angeles",
    "type": "human",
    "username": "adnapi",
    "verified_domain": "developers.app.net",
    "follows_you": false,
    "you_blocked": false,
    "you_follow": false,
    "you_muted": true,
    "you_can_subscribe": true,
    "you_can_follow": true
  },
  "meta": {
    "code": 200
  }
}

Unmute a User

Stop hiding all posts for a given user.

This endpoint responds to general User parameters.

Remember, access tokens can not be passed in a HTTP body for DELETE requests. Please refer to the authentication documentation.

Endpoint

Method	URL	Token	Scope
DELETE	https://alpha-api.app.net/stream/0/users/{user_id}/mute	User	follow

URL Parameters

Name	Description
user_id	The id of the User to mute. You can also specify @username as a user_id.

Example

curl -X DELETE -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://alpha-api.app.net/stream/0/users/1558/mute"

{
  "data": {
    "avatar_image": {
      "height": 200,
      "is_default": false,
      "url": "https://d2rfichhc2fb9n.cloudfront.net/image/5/aoveeP73f33UcFhyhqzn7VhwgS17InMiOiJzMyIsImIiOiJhZG4tdXNlci1hc3NldHMiLCJrIjoiYXNzZXRzL3VzZXIvOTkvYTYvNDAvOTlhNjQwMDAwMDAwMDAwMC5wbmciLCJvIjoiIn0",
      "width": 200
    },
    "canonical_url": "https://alpha.app.net/adnapi",
    "counts": {
      "followers": 1549,
      "following": 12,
      "posts": 115,
      "stars": 4
    },
    "cover_image": {
      "height": 260,
      "is_default": true,
      "url": "https://d2rfichhc2fb9n.cloudfront.net/image/5/kZ-JRmTbmd3WVPswTJ8Nwxzkf917InMiOiJzMyIsImIiOiJ0YXBwLWFzc2V0cyIsImsiOiJpL1UvaS9ZL1VpWW5xRFNvTUtyTEhLNXA0OHN2NkxmTmRVMC5qcGciLCJvIjoiIn0",
      "width": 960
    },
    "created_at": "2012-08-10T22:40:12Z",
    "description": {
      "entities": {
        "hashtags": [

        ],
        "links": [
          {
            "len": 7,
            "pos": 31,
            "text": "App.net",
            "url": "http://App.net"
          }
        ],
        "mentions": [

        ]
      },
      "html": "<span itemscope=\"https://app.net/schemas/Post\">Updating you on changes to the <a href=\"http://App.net\">App.net</a> API</span>",
      "text": "Updating you on changes to the App.net API"
    },
    "id": "1558",
    "locale": "en_US",
    "name": "ADN API",
    "timezone": "America/Los_Angeles",
    "type": "human",
    "username": "adnapi",
    "verified_domain": "developers.app.net",
    "follows_you": false,
    "you_blocked": false,
    "you_follow": false,
    "you_muted": false,
    "you_can_subscribe": true,
    "you_can_follow": true
  },
  "meta": {
    "code": 200
  }
}

List muted Users

Retrieve a list of muted users.

This endpoint responds to general User parameters.

Endpoint

Method	URL	Token
GET	https://alpha-api.app.net/stream/0/users/{user_id}/muted	Any

URL Parameters

Name	Description
user_id	The id of the user to retrieve a list of muted users for. If requested with a user token you can request muted users for the current user by using me as the user id. If requested with an app token you can request muted users for any user that has authorized your app.

Example

curl -H "Authorization: Bearer <YOUR ACCESS TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://alpha-api.app.net/stream/0/users/me/muted"

{
  "data": [
    {
      "avatar_image": {
        "height": 200,
        "is_default": false,
        "url": "https://d2rfichhc2fb9n.cloudfront.net/image/5/aoveeP73f33UcFhyhqzn7VhwgS17InMiOiJzMyIsImIiOiJhZG4tdXNlci1hc3NldHMiLCJrIjoiYXNzZXRzL3VzZXIvOTkvYTYvNDAvOTlhNjQwMDAwMDAwMDAwMC5wbmciLCJvIjoiIn0",
        "width": 200
      },
      "canonical_url": "https://alpha.app.net/adnapi",
      "counts": {
        "followers": 1549,
        "following": 12,
        "posts": 115,
        "stars": 4
      },
      "cover_image": {
        "height": 260,
        "is_default": true,
        "url": "https://d2rfichhc2fb9n.cloudfront.net/image/5/kZ-JRmTbmd3WVPswTJ8Nwxzkf917InMiOiJzMyIsImIiOiJ0YXBwLWFzc2V0cyIsImsiOiJpL1UvaS9ZL1VpWW5xRFNvTUtyTEhLNXA0OHN2NkxmTmRVMC5qcGciLCJvIjoiIn0",
        "width": 960
      },
      "created_at": "2012-08-10T22:40:12Z",
      "description": {
        "entities": {
          "hashtags": [

          ],
          "links": [
            {
              "len": 7,
              "pos": 31,
              "text": "App.net",
              "url": "http://App.net"
            }
          ],
          "mentions": [

          ]
        },
        "html": "<span itemscope=\"https://app.net/schemas/Post\">Updating you on changes to the <a href=\"http://App.net\">App.net</a> API</span>",
        "text": "Updating you on changes to the App.net API"
      },
      "id": "1558",
      "locale": "en_US",
      "name": "ADN API",
      "timezone": "America/Los_Angeles",
      "type": "human",
      "username": "adnapi",
      "verified_domain": "developers.app.net",
      "follows_you": false,
      "you_blocked": false,
      "you_follow": false,
      "you_muted": true,
      "you_can_subscribe": true,
      "you_can_follow": true
    }
  ],
  "meta": {
    "code": 200
  }
}

Retrieve muted User IDs for multiple Users

Returns a list of muted User ids for each User id requested. At most 200 User ids can be requested.

Endpoint

Method	URL	Token
GET	https://alpha-api.app.net/stream/0/users/muted/ids	App

Query String Parameters

Name	Description
ids	A comma separated list of User ids to retrieve muted User ids for.

Example

curl -H "Authorization: Bearer <YOUR APP TOKEN>" -H "X-ADN-Pretty-JSON: 1" \
    "https://alpha-api.app.net/stream/0/users/muted/ids?ids=1,2"

{
  "data": {
    "1": [
      "3",
      "29"
    ],
    "2": [

    ]
  },
  "meta": {
    "code": 200
  }
}