> For the complete documentation index, see [llms.txt](https://relationlabs.gitbook.io/relation-one-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://relationlabs.gitbook.io/relation-one-api/api/follows/follow.md).

# Follow

## <mark style="color:green;">POST</mark> /api/v1/follow

* Note: It is for following a user. A successful request would add the target user to the caller's list of following. Meanwhile, the caller would be added to the target user's list of followers as well.
* Header

| Field         | Type   | Remarks                                                                                           |
| ------------- | ------ | ------------------------------------------------------------------------------------------------- |
| ApiKey        | String | [ApiKey](/relation-one-api/guide/glossary.md#apikey) acquired from the admin                      |
| Authorization | String | Bearer ${unifiedAuthToken} , in which the unifiedAuthToken is the result returned by /api/v1/auth |

* Request Parameters

| Field   | Type   | Remarks                                |
| ------- | ------ | -------------------------------------- |
| address | String | The target user's relationId / address |

* Request Example

```shell
curl POST 'https://api.relationlabs.ai/api/v1/follow' \
--header 'ApiKey: <ApiKey>' \
--header 'Authorization: Bearer eyJhbGciOiJFUzI1NiJ9.eyJqdGkiOiJiOTE5N1Y1OGJmYTY0NDRlYmU2ODA1OTc2MmViNzdlZSIsImlzcyI6InJlbGF0aW9ubGFicy5haSIsImlhdCI6MTY2MDgyNDM0MSwic3ViIjoiYmFmMzQta2lhYWEtYWFhYWstYWNnamEtY2FpIiwiZXhwIjoxNjYxNDI5MTQxfQ.Y_1NR0N3NgQCzaR1owS6Ga4AbOIfvH7ucZJJ9-HUK_FrXBtG_WjTa3XNDfmHZIwCFDOzAjSHNcRdDaR0NZGUIw' \
--header 'Content-Type: application/json' \
--data-raw '{
    "address":"baf34-kiaaa-aaaak-acgja-cai1"
}'
```

* Response Parameters

| Field | Type   | Remarks            |
| ----- | ------ | ------------------ |
| code  | String | the Return Code    |
| desc  | String | the Return Message |
| data  | Object | the Data           |

* Response Body

```json
{
    "code": "0",
    "desc": "success",
    "data": null
}
```

* Return Code

| code  | desc    | Remarks                                             |
| ----- | ------- | --------------------------------------------------- |
| 0     | success | the flag for a successful request                   |
| 11601 |         | Users cannot follow themselves.                     |
| 11602 |         | The address is not supported by the current version |