2020-01-01 22:37:59 +01:00
|
|
|
---
|
|
|
|
title: Mention
|
|
|
|
description: Represents a mention of a user within the content of a status.
|
|
|
|
menu:
|
|
|
|
docs:
|
|
|
|
parent: entities
|
|
|
|
---
|
|
|
|
|
|
|
|
## Example
|
|
|
|
|
|
|
|
{{< code title="excerpt from GET status:" >}}
|
|
|
|
```javascript
|
|
|
|
{
|
|
|
|
"mentions": [
|
|
|
|
{
|
|
|
|
"id": "952529",
|
|
|
|
"username": "alayna",
|
|
|
|
"url": "https://desvox.es/users/alayna",
|
|
|
|
"acct": "alayna@desvox.es"
|
|
|
|
},
|
|
|
|
{
|
|
|
|
"id": "14715",
|
|
|
|
"username": "trwnh",
|
|
|
|
"url": "https://mastodon.social/@trwnh",
|
|
|
|
"acct": "trwnh"
|
|
|
|
}
|
|
|
|
]
|
|
|
|
}
|
|
|
|
```
|
|
|
|
{{< /code >}}
|
|
|
|
|
|
|
|
## Required attributes
|
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
### `id` {#id}
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
**Description:** The account id of the mentioned user.\
|
|
|
|
**Type:** String \(cast from an integer, but not guaranteed to be a number\)\
|
2020-01-01 22:37:59 +01:00
|
|
|
**Version history:** Added in 0.6.0
|
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
### `username` {#username}
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
**Description:** The username of the mentioned user.\
|
|
|
|
**Type:** String\
|
2020-01-01 22:37:59 +01:00
|
|
|
**Version history:** Added in 0.6.0
|
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
### `acct` {#acct}
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
**Description:** The webfinger acct: URI of the mentioned user. Equivalent to `username` for local users, or `username@domain` for remote users.\
|
|
|
|
**Type:** String\
|
2020-01-01 22:37:59 +01:00
|
|
|
**Version history:** Added in 0.6.0
|
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
### `url` {#url}
|
2020-01-01 22:37:59 +01:00
|
|
|
|
2020-01-12 14:11:56 +01:00
|
|
|
**Description:** The location of the mentioned user's profile.\
|
|
|
|
**Type:** String \(URL\)\
|
2020-01-01 22:37:59 +01:00
|
|
|
**Version history:** Added in 0.6.0
|
|
|
|
|
|
|
|
## See also
|
|
|
|
|
2020-08-10 23:01:50 +02:00
|
|
|
* [GET /api/v1/statuses/:id]({{< relref "../methods/statuses/#view-specific-status" >}})
|
|
|
|
* [Status\#mentions]({{< relref "status.md#mentions" >}})
|
2020-01-01 22:37:59 +01:00
|
|
|
|
|
|
|
{{< page-ref page="status.md" >}}
|
|
|
|
|
|
|
|
|
|
|
|
|