2020-01-01 22:37:59 +01:00
|
|
|
---
|
|
|
|
title: Relationship
|
2020-01-12 14:11:56 +01:00
|
|
|
description: Represents the relationship between accounts, such as following / blocking / muting / etc.
|
2020-01-01 22:37:59 +01:00
|
|
|
menu:
|
|
|
|
docs:
|
|
|
|
parent: entities
|
|
|
|
---
|
|
|
|
|
|
|
|
## Example
|
|
|
|
|
|
|
|
```javascript
|
|
|
|
{
|
|
|
|
"id": "1",
|
|
|
|
"following": true,
|
|
|
|
"showing_reblogs": true,
|
2020-12-27 07:03:55 +01:00
|
|
|
"notifying": false,
|
2020-01-01 22:37:59 +01:00
|
|
|
"followed_by": true,
|
|
|
|
"blocking": false,
|
|
|
|
"blocked_by": false,
|
|
|
|
"muting": false,
|
|
|
|
"muting_notifications": false,
|
|
|
|
"requested": false,
|
|
|
|
"domain_blocking": false,
|
2020-07-10 12:28:00 +02:00
|
|
|
"endorsed": false,
|
|
|
|
"note": ""
|
2020-01-01 22:37:59 +01:00
|
|
|
}
|
|
|
|
```
|
|
|
|
|
2020-07-10 12:28:00 +02:00
|
|
|
## Required attributes
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-07-10 12:28:00 +02:00
|
|
|
### `id`
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
**Description:** The account id.\
|
|
|
|
**Type:** String \(cast from an integer, but not guaranteed to be a number\)\
|
2020-07-10 12:28:00 +02:00
|
|
|
**Version history:**\
|
|
|
|
0.6.0 - added
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-07-10 12:28:00 +02:00
|
|
|
### `following`
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
**Description:** Are you following this user?\
|
|
|
|
**Type:** Boolean\
|
2020-07-10 12:28:00 +02:00
|
|
|
**Version history:**\
|
|
|
|
0.6.0 - added
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-07-10 12:28:00 +02:00
|
|
|
### `requested`
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
**Description:** Do you have a pending follow request for this user?\
|
|
|
|
**Type:** Boolean\
|
2020-07-10 12:28:00 +02:00
|
|
|
**Version history:**\
|
|
|
|
0.9.9 - added
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-07-10 12:28:00 +02:00
|
|
|
### `endorsed`
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
**Description:** Are you featuring this user on your profile?\
|
|
|
|
**Type:** Boolean\
|
2020-07-10 12:28:00 +02:00
|
|
|
**Version history:**\
|
|
|
|
2.5.0 - added
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
### `followed_by` {#followed_by}
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
**Description:** Are you followed by this user?\
|
|
|
|
**Type:** Boolean\
|
2020-07-10 12:28:00 +02:00
|
|
|
**Version history:**\
|
|
|
|
0.6.0 - added
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-07-10 12:28:00 +02:00
|
|
|
### `muting`
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
**Description:** Are you muting this user?\
|
|
|
|
**Type:** Boolean\
|
2020-01-01 22:37:59 +01:00
|
|
|
**Version history:** Added in 1.1.0
|
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
### `muting_notifications` {#muting_notifications}
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
**Description:** Are you muting notifications from this user?\
|
|
|
|
**Type:** Boolean\
|
2020-07-10 12:28:00 +02:00
|
|
|
**Version history:**\
|
|
|
|
2.1.0 - added
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
### `showing_reblogs` {#showing_reblogs}
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
**Description:** Are you receiving this user's boosts in your home timeline?\
|
|
|
|
**Type:** Boolean\
|
2020-07-10 12:28:00 +02:00
|
|
|
**Version history:**\
|
|
|
|
2.1.0 - added
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-12-27 07:03:55 +01:00
|
|
|
### `notifying` {#notifying}
|
|
|
|
|
|
|
|
**Description:** Have you enabled notifications for this user?\
|
|
|
|
**Type:** Boolean\
|
|
|
|
**Version history:**\
|
|
|
|
3.3.0 - added
|
|
|
|
|
2020-07-10 12:28:00 +02:00
|
|
|
### `blocking`
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
**Description:** Are you blocking this user?\
|
|
|
|
**Type:** Boolean\
|
2020-07-10 12:28:00 +02:00
|
|
|
**Version history:**\
|
|
|
|
0.6.0 - added
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
### `domain_blocking` {#domain_blocking}
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
**Description:** Are you blocking this user's domain?\
|
|
|
|
**Type:** Boolean\
|
2020-07-10 12:28:00 +02:00
|
|
|
**Version history:**\
|
|
|
|
1.4.0 - added
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
### `blocked_by` {#blocked_by}
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
**Description:** Is this user blocking you?\
|
|
|
|
**Type:** Boolean\
|
2020-07-10 12:28:00 +02:00
|
|
|
**Version history:**\
|
|
|
|
2.8.0 - added
|
|
|
|
|
|
|
|
### `note`
|
|
|
|
|
2021-09-20 02:05:03 +02:00
|
|
|
**Description:** This user's profile bio\
|
2020-07-10 12:28:00 +02:00
|
|
|
**Type:** String\
|
|
|
|
**Version history:**\
|
|
|
|
3.2.0 - added
|
2020-01-01 22:37:59 +01:00
|
|
|
|
|
|
|
## See also
|
|
|
|
|
2020-08-11 02:14:13 +02:00
|
|
|
* [GET /api/v1/accounts/relationships]({{< relref "../methods/accounts.md#check-relationships-to-other-accounts" >}})
|
2020-01-01 22:37:59 +01:00
|
|
|
|
|
|
|
{{< caption-link url="https://github.com/tootsuite/mastodon/blob/master/app/serializers/rest/relationship_serializer.rb" caption="app/serializers/rest/relationship\_serializer.rb" >}}
|