| title | Profile | ||||
|---|---|---|---|---|---|
| description | Represents the current user's profile, with source values for all the editable fields. | ||||
| menu |
|
||||
| aliases |
|
Example
{
"id": "116222600881276277",
"display_name": "Documentation user",
"note": "I'm only here as an example for documentation",
"fields": [
{
"name": "pronouns",
"value": "it/its",
"verified_at": null
}
],
"avatar": null,
"avatar_static": null,
"avatar_description": "",
"header": null,
"header_static": null,
"header_description": "",
"locked": false,
"bot": false,
"hide_collections": null,
"discoverable": true,
"indexable": true,
"show_media": true,
"show_media_replies": true,
"show_featured": true,
"attribution_domains": [
"articles.example.com"
],
"featured_tags": [
{
"id": "1",
"name": "foo",
"url": "https://example.com/@darrel_metz0/tagged/foo",
"statuses_count": "0",
"last_status_at": null
}
]
}Attributes
id {#id}
Description: The account id.
Type: String (cast from an integer, but not guaranteed to be a number)
Version history:
4.6.0 - added
display_name {#display_name}
Description: The profile's display name.
Type: String
Version history:
4.6.0 - added
note {#note}
Description: The profile's bio or description. Unlike for [Account]({{< relref "entities/Account">}}), this is the raw unprocessed text, not the rendered HTML.
Type: String (raw text)
Version history:
4.6.0 - added
fields {#fields}
Description: Metadata about the account. Those contain the raw unprocessed names and values.
Type: Array of Field
Version history:
4.6.0 - added
avatar {#avatar}
Description: An image icon that is shown next to statuses and in the profile. Unlike for [Account]({{< relref "entities/Account">}}), this is nullable and will be null if the avatar is unset.
Type: {{}} String (URL)
Version history:
4.6.0 - added
avatar_static {#avatar_static}
Description: A static version of the avatar. Unlike for [Account]({{< relref "entities/Account">}}), this is nullable and will be null if the avatar is unset.
Type: {{}} String (URL)
Version history:
4.6.0 - added
avatar_description {#avatar_description}
Description: A textual description of the avatar, to be used for the visually impaired or when avatars do not load.
Type: String
Version history:
4.6.0 - added
header {#header}
Description: An image banner that is shown above the profile and in profile cards. Unlike for [Account]({{< relref "entities/Account">}}), this is nullable and will be null if the header is unset.
Type: {{}} String (URL)
Version history:
4.6.0 - added
header_static {#header_static}
Description: A static version of the header. Unlike for [Account]({{< relref "entities/Account">}}), this is nullable and will be null if the header is unset.
Type: {{}} String (URL)
Version history:
4.6.0 - added
header_description {#header_description}
Description: A textual description of the profile header, to be used for the visually impaired or when avatars do not load.
Type: String
Version history:
4.6.0 - added
locked {#locked}
Description: Whether the account manually approves follow requests.
Type: Boolean
Version history:
4.6.0 - added
bot {#bot}
Description: Indicates that the account may perform automated actions, may not be monitored, or identifies as a robot. This is determined by the account's actor_type being set to 'Application' or 'Service'.
Type: Boolean
Version history:
4.6.0 - added
hide_collections {#hide_collections}
Description: Whether the user hides the contents of their follows and followers collections.
Type: {{}} Boolean
Version history:
4.6.0 - added
discoverable {#discoverable}
Description: Whether the account has opted into discovery features such as the profile directory.
Type: {{}} Boolean
Version history:
4.6.0 - added
indexable {#indexable}
Description: Whether the account allows indexing by search engines.
Type: Boolean
Version history:
4.6.0 - added
show_media {#show_media}
Description: Whether the account wishes to have a “Media” tab with media attachments on their profile.
Type: Boolean
Version history:
4.6.0 - added
show_media_replies {#show_media_replies}
Description: Whether the account wishes to have replies in the “Media” tab on their profile.
Type: Boolean
Version history:
4.6.0 - added
show_featured {#show_featured}
Description: Whether the account wishes to have a “Featured” tab on their profile.
Type: Boolean
Version history:
4.6.0 - added
attribution_domains {#attribution_domains}
Description: Domains of websites allowed to credit the account.
Type: Array of String
Version history:
4.6.0 - added
Field entity attributes {#Field}
name {#name}
Description: The key of a given field's key-value pair. This is the raw string before processing, not HTML.
Type: String
Version history:
4.6.0 - added
value {#value}
Description: The value associated with the name key. This is the raw string before processing, not HTML.
Type: String
Version history:
4.6.0 - added
verified_at {#verified_at}
Description: Timestamp of when the server verified a URL value for a rel="me" link.
Type: {{}} String (Datetime) if value is a verified URL. Otherwise, null.
Version history:
4.6.0 - added
See also
{{< page-relref ref="methods/profile#extended_description" caption="GET /api/v1/profile" >}}
{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/profile_serializer.rb" caption="app/serializers/rest/profile_serializer.rb" >}}