endorsements.md 920 Bytes
Newer Older
Eugen Rochko's avatar
Eugen Rochko committed
1
---
2
title: Endorsements
Eugen Rochko's avatar
Eugen Rochko committed
3 4
menu:
  docs:
5
    parent: rest-api
Eugen Rochko's avatar
Eugen Rochko committed
6 7
    weight: 10
---
8 9 10

## GET /api/v1/endorsements

Eugen Rochko's avatar
Eugen Rochko committed
11 12
Accounts the user chose to endorse.

13 14 15 16
Returns array of [Account]({{< relref "entities.md#account" >}})

### Resource information

17
{{< api_method_info auth="Yes" user="Yes" scope="read read:account" version="2.5.0" >}}
18 19 20 21

### Pagination

{{< api_pagination >}}
22 23 24 25 26 27 28 29 30

## POST /api/v1/accounts/:id/pin

Endorse an account, i.e. choose to feature the account on the user's public profile.

Returns [Relationship]({{< relref "entities.md#relationship" >}})

### Resource information

31
{{< api_method_info auth="Yes" user="Yes" scope="write write:accounts" version="2.5.0" >}}
32 33 34 35 36 37 38 39 40

## POST /api/v1/accounts/:id/unpin

Undo endorse of an account.

Returns [Relationship]({{< relref "entities.md#relationship" >}})

### Resource information

41
{{< api_method_info auth="Yes" user="Yes" scope="write write:accounts" version="2.5.0" >}}