Fetch a share

GET /accounts/{account_id}/alerts/{alert_id}/shares/{share_id}

Parameters

  • account_id (string) - Id of the account
  • alert_id (number) - Id of the alert
  • share_id (number) - Id of the share object

Page content

Minimal curl example

curl -ig 'https://api.mention.net/api/accounts/{account_id}/alerts/{alert_id}/shares/{share_id}' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
    -H 'Accept-Version: 1.19'

Request example

  • Headers
Authorization: Bearer YOUR_ACCESS_TOKEN
Accept-Version: 1.19
  • Body

None

Response example

  • Body
{
    "id": "12345_69gjjsg4itgkcco040okwsck700o4w8gsco0k4kco0s4scw8o0",
    "account": {...},
    "blocked": false,
    "permissions": {
        "edit": true,
        "delete": true
    },
    "created_at": "2016-01-19T12:43:46.0+00:00",
    "weight": 50
}

Account

account

It is a subset of the account data of the account with whom the alert is being shared. It is very similar to the data you might get by fetching the account.

Blocked

blocked

Boolean indicating if the share was blocked for this user.

Permissions

permissions

Permissions associated to the role of the user.

Weight

weight

The weight of the alert on this user's front end.