post_api_v1_conversations_id_read

{
  "description": "Represents a conversation with \"direct message\" visibility.",
  "required": [
    "accounts",
    "id",
    "unread"
  ],
  "properties": {
    "accounts": {
      "type": "array",
      "description": "Participants in the conversation.",
      "items": {
        "type": "object",
        "description": "Represents a user of Mastodon and their associated profile.",
        "properties": {
          "acct": {
            "type": "string",
            "description": "The Webfinger account URI. Equal to `username` for local users, or `username@domain` for"
          },
          "avatar": {
            "type": "string",
            "description": "An image icon that is shown next to statuses and in the profile. The format is URL."
          },
          "avatar_static": {
            "type": "string",
            "description": "A static version of the avatar. Equal to `avatar` if its value is a static image; different if `avatar` is an animated GIF. The format is URL."
          },
          "bot": {
            "type": "boolean",
            "description": "A presentational flag. Indicates that the account may perform automated actions, may not be monitored, or identifies as a robot."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the account was created."
          },
          "discoverable": {
            "type": "boolean",
            "description": "Whether the account has opted into discovery features such as the profile directory."
          },
          "display_name": {
            "type": "string",
            "description": "The profile's display name."
          },
          "emojis": {
            "type": "array",
            "description": "Custom emoji entities to be used when rendering the profile. If none, an empty array will be returned.",
            "items": {
              "type": "object",
              "description": "Represents a custom emoji.",
              "required": [
                "shortcode",
                "url",
                "static_url",
                "visible_in_picker"
              ],
              "properties": {
                "category": {
                  "type": "string",
                  "description": "Used for sorting custom emoji in the picker."
                },
                "shortcode": {
                  "type": "string",
                  "description": "The name of the custom emoji."
                },
                "static_url": {
                  "type": "string",
                  "description": "A link to a static copy of the custom emoji. The format is URL."
                },
                "url": {
                  "type": "string",
                  "description": "A link to the custom emoji. The format is URL."
                },
                "visible_in_picker": {
                  "type": "boolean",
                  "description": "Whether this Emoji should be visible in the picker or unlisted."
                }
              }
            }
          },
          "fields": {
            "type": "array",
            "description": "Additional metadata attached to a profile as name-value pairs.",
            "items": {
              "type": "object",
              "description": "Represents a profile field as a name-value pair with optional verification.",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "The key of a given field's key-value pair."
                },
                "value": {
                  "type": "string",
                  "description": "The value associated with the `name` key."
                },
                "verified_at": {
                  "type": "string",
                  "format": "date-time",
                  "description": "Timestamp of when the server verified a URL value for a rel=\"me” link. If `value` is a verified URL. Otherwise, null"
                }
              }
            }
          },
          "followers_count": {
            "type": "integer",
            "description": "The reported followers of this profile."
          },
          "following_count": {
            "type": "integer",
            "description": "The reported follows of this profile."
          },
          "header": {
            "type": "string",
            "description": "An image banner that is shown above the profile and in profile cards. The format is URL."
          },
          "header_static": {
            "type": "string",
            "description": "A static version of the header. Equal to `header` if its value is a static image; different if `header` is an animated GIF. The format is URL."
          },
          "id": {
            "type": "string",
            "description": "The account id `header`."
          },
          "last_status_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the most recent status was posted."
          },
          "locked": {
            "type": "boolean",
            "description": "Whether the account manually approves follow requests."
          },
          "moved": {
            "type": "object",
            "additionalProperties": true
          },
          "mute_expires_at": {
            "type": "string",
            "format": "date-time",
            "description": "When a timed mute will expire, if applicable. ISO 8601 Datetime."
          },
          "note": {
            "type": "string",
            "description": "The profile's bio / description."
          },
          "source": {
            "type": "object",
            "description": "Represents display or publishing preferences of user's own account. Returned as an additional entity when verifying and updated credentials, as an attribute of Account.",
            "properties": {
              "fields": {
                "type": "array",
                "description": "Metadata about the account.",
                "items": {
                  "type": "object",
                  "description": "Represents a profile field as a name-value pair with optional verification.",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "The key of a given field's key-value pair."
                    },
                    "value": {
                      "type": "string",
                      "description": "The value associated with the `name` key."
                    },
                    "verified_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Timestamp of when the server verified a URL value for a rel=\"me” link. If `value` is a verified URL. Otherwise, null"
                    }
                  }
                }
              },
              "follow_requests_count": {
                "type": "integer",
                "description": "The number of pending follow requests"
              },
              "language": {
                "type": "string",
                "description": "The default posting language for new statuses, ISO 639-1 language two-letter code."
              },
              "note": {
                "type": "string",
                "description": "Profile bio"
              },
              "privacy": {
                "type": "string",
                "description": "The default post privacy to be used for new statuses.",
                "enum": [
                  "public",
                  "unlisted",
                  "private",
                  "direct"
                ]
              },
              "sensitive": {
                "type": "boolean",
                "description": "Whether new statuses should be marked sensitive by default."
              }
            }
          },
          "statuses_count": {
            "type": "integer",
            "description": "How many statuses are attached to this account."
          },
          "suspended": {
            "type": "boolean",
            "description": "An extra entity returned when an account is suspended."
          },
          "url": {
            "type": "string",
            "description": "The location of the user's profile page. (HTTPS URL)"
          },
          "username": {
            "type": "string",
            "description": "The username of the account, not including domain."
          }
        }
      }
    },
    "id": {
      "type": "string",
      "description": "Local database ID of the conversation. Cast from an integer, but not guaranteed to be a number"
    },
    "last_status": {
      "type": "object",
      "description": "Represents a status posted by an account.",
      "properties": {
        "account": {
          "type": "object",
          "additionalProperties": true
        },
        "application": {
          "description": "Represents an application that interfaces with the REST API to access accounts or post statuses.",
          "required": [
            "name"
          ],
          "properties": {
            "client_id": {
              "type": "string",
              "description": "Client ID key, to be used for obtaining OAuth tokens"
            },
            "client_secret": {
              "type": "string",
              "description": "Client secret key, to be used for obtaining OAuth tokens"
            },
            "name": {
              "type": "string",
              "description": "The name of your application."
            },
            "vapid_key": {
              "type": "string",
              "description": "Used for Push Streaming API. Returned with [POST /api/v1/apps](https://docs.joinmastodon.org/methods/apps/#create-an-application). Equivalent to [PushSubscription#server_key](https://docs.joinmastodon.org/entities/pushsubscription/#server_key)"
            },
            "website": {
              "type": "string",
              "description": "The website associated with your application. Must be URL."
            }
          }
        },
        "bookmarked": {
          "type": "boolean",
          "description": "Have you bookmarked this status?"
        },
        "card": {
          "description": "Represents a rich preview card that is generated using OpenGraph tags from a URL.",
          "required": [
            "description",
            "title",
            "type",
            "url"
          ],
          "properties": {
            "author_name": {
              "type": "string",
              "description": "The author of the original resource."
            },
            "author_url": {
              "type": "string",
              "description": "A link to the author of the original resource."
            },
            "blurhash": {
              "type": "string",
              "description": "A hash computed by the [BlurHash algorithm](https://github.com/woltapp/blurhash), for generating colorful preview thumbnails when media has not been downloaded yet."
            },
            "description": {
              "type": "string",
              "description": "Description of preview."
            },
            "height": {
              "type": "integer",
              "description": "Height of preview, in pixels."
            },
            "html": {
              "type": "string",
              "description": "HTML to be used for generating the preview card."
            },
            "image": {
              "type": "string",
              "description": "Preview thumbnail (URL)."
            },
            "provider_name": {
              "type": "string",
              "description": "The provider of the original resource."
            },
            "provider_url": {
              "type": "string",
              "description": "A link to the provider of the original resource."
            },
            "title": {
              "type": "string",
              "description": "Title of linked resource."
            },
            "type": {
              "type": "string",
              "description": "The type of the preview card. String (Enumerable, oneOf).",
              "enum": [
                "link",
                "photo",
                "video",
                "rich"
              ]
            },
            "url": {
              "type": "string",
              "description": "Location of linked resource."
            },
            "width": {
              "type": "integer",
              "description": "Width of preview, in pixels."
            }
          }
        },
        "content": {
          "type": "string",
          "description": "HTML-encoded status content."
        },
        "created_at": {
          "type": "string",
          "format": "date-time",
          "description": "The date when this status was created."
        },
        "emojis": {
          "type": "array",
          "description": "Custom emoji to be used when rendering status content.",
          "items": {
            "type": "object",
            "description": "Represents a custom emoji.",
            "required": [
              "shortcode",
              "url",
              "static_url",
              "visible_in_picker"
            ],
            "properties": {
              "category": {
                "type": "string",
                "description": "Used for sorting custom emoji in the picker."
              },
              "shortcode": {
                "type": "string",
                "description": "The name of the custom emoji."
              },
              "static_url": {
                "type": "string",
                "description": "A link to a static copy of the custom emoji. The format is URL."
              },
              "url": {
                "type": "string",
                "description": "A link to the custom emoji. The format is URL."
              },
              "visible_in_picker": {
                "type": "boolean",
                "description": "Whether this Emoji should be visible in the picker or unlisted."
              }
            }
          }
        },
        "favourited": {
          "type": "boolean",
          "description": "Have you favourited this status?"
        },
        "favourites_count": {
          "type": "integer",
          "description": "How many favourites this status has received."
        },
        "id": {
          "type": "string",
          "description": "ID of the status in the database. Cast from an integer but not guaranteed to be a number."
        },
        "in_reply_to_account_id": {
          "type": "string",
          "description": "ID of the account being replied to."
        },
        "in_reply_to_id": {
          "type": "string",
          "description": "ID of the status being replied. Cast from an integer but not guaranteed to be a number."
        },
        "language": {
          "type": "string",
          "description": "Primary language of this status. ISO 639 Part 1 two-letter language code."
        },
        "media_attachments": {
          "type": "array",
          "description": "Media that is attached to this status.",
          "items": {
            "description": "Represents a file or media attachment that can be added to a status.",
            "required": [
              "id",
              "type",
              "url",
              "preview_url"
            ],
            "properties": {
              "blurhash": {
                "type": "string",
                "description": "A hash computed by the [BlurHash algorithm](https://github.com/woltapp/blurhash), for generating colorful preview thumbnails when media has not been downloaded yet."
              },
              "description": {
                "type": "string",
                "description": "Alternate text that describes what is in the media attachment, to be used for the visually impaired or when media attachments do not load."
              },
              "id": {
                "type": "string",
                "description": "The ID of the attachment in the database. Cast from an integer but not guaranteed to be a number"
              },
              "meta": {
                "type": "object",
                "description": "Metadata returned by Paperclip."
              },
              "preview_url": {
                "type": "string",
                "description": "The location of a scaled-down preview of the attachment."
              },
              "remote_url": {
                "type": "string",
                "description": "The location of the full-size original attachment on the remote website. String or null if the attachment is local."
              },
              "text_url": {
                "type": "string",
                "description": "A shorter URL for the attachment."
              },
              "type": {
                "type": "string",
                "description": "The type of the attachment.",
                "enum": [
                  "unknown",
                  "image",
                  "gifv",
                  "video",
                  "audio"
                ]
              },
              "url": {
                "type": "string",
                "description": "The location of the original full-size attachment."
              }
            }
          }
        },
        "mentions": {
          "type": "array",
          "description": "Mentions of users within the status content.",
          "items": {
            "description": "Represents a mention of a user within the content of a status.",
            "required": [
              "id",
              "username",
              "acct",
              "url"
            ],
            "properties": {
              "acct": {
                "type": "string",
                "description": "The webfinger acct URI of the mentioned user. Equivalent to `username` for local users, or `username@domain` for remote users."
              },
              "id": {
                "type": "string",
                "description": "The account id of the mentioned user. Cast from an integer, but not guaranteed to be a number"
              },
              "url": {
                "type": "string",
                "description": "The location of the mentioned user's profile."
              },
              "username": {
                "type": "string",
                "description": "The username of the mentioned user."
              }
            }
          }
        },
        "muted": {
          "type": "boolean",
          "description": "Have you muted notifications for this status's conversation?"
        },
        "pinned": {
          "type": "boolean",
          "description": "Have you pinned this status? Only appears if the status is pinnable."
        },
        "poll": {
          "description": "Represents a poll attached to a status.",
          "properties": {
            "emojis": {
              "type": "array",
              "description": "Custom emoji to be used for rendering poll options.",
              "items": {
                "type": "object",
                "description": "Represents a custom emoji.",
                "required": [
                  "shortcode",
                  "url",
                  "static_url",
                  "visible_in_picker"
                ],
                "properties": {
                  "category": {
                    "type": "string",
                    "description": "Used for sorting custom emoji in the picker."
                  },
                  "shortcode": {
                    "type": "string",
                    "description": "The name of the custom emoji."
                  },
                  "static_url": {
                    "type": "string",
                    "description": "A link to a static copy of the custom emoji. The format is URL."
                  },
                  "url": {
                    "type": "string",
                    "description": "A link to the custom emoji. The format is URL."
                  },
                  "visible_in_picker": {
                    "type": "boolean",
                    "description": "Whether this Emoji should be visible in the picker or unlisted."
                  }
                }
              }
            },
            "expired": {
              "type": "boolean",
              "description": "Is the poll currently expired?"
            },
            "expires_at": {
              "type": "string",
              "format": "date-time",
              "description": "When the poll ends. ISO 8601 Datetime, or null if the poll does not end."
            },
            "id": {
              "type": "string",
              "description": "The ID of the poll in the database. Cast from an integer, but not guaranteed to be a number."
            },
            "multiple": {
              "type": "boolean",
              "description": "Does the poll allow multiple-choice answers?"
            },
            "options": {
              "type": "array",
              "description": "Possible answers for the poll.",
              "items": {
                "type": "object"
              }
            },
            "own_votes": {
              "type": "array",
              "description": "When called with a user token, which options has the authorized user chosen? Contains an array of index values for `options`. Array of Number, or null if no current user",
              "items": {
                "type": "integer"
              }
            },
            "voted": {
              "type": "boolean",
              "description": "When called with a user token, has the authorized user voted? Boolean, or null if no current user"
            },
            "voters_count": {
              "type": "integer",
              "description": "How many unique accounts have voted on a multiple-choice poll. Number, or null if `multiple` is false."
            },
            "votes_count": {
              "type": "integer",
              "description": "How many votes have been received."
            }
          }
        },
        "reblog": {
          "type": "object",
          "additionalProperties": true
        },
        "reblogged": {
          "type": "boolean",
          "description": "Have you boosted this status?"
        },
        "reblogs_count": {
          "type": "integer",
          "description": "How many boosts this status has received."
        },
        "replies_count": {
          "type": "integer",
          "description": "How many replies this status has received."
        },
        "sensitive": {
          "type": "boolean",
          "description": "Is this status marked as sensitive content?"
        },
        "spoiler_text": {
          "type": "string",
          "description": "Subject or summary line, below which status content is collapsed until expanded."
        },
        "tags": {
          "type": "array",
          "description": "Hashtags used within the status content.",
          "items": {
            "description": "Represents a hashtag used within the content of a status.",
            "required": [
              "name",
              "url"
            ],
            "properties": {
              "history": {
                "type": "array",
                "description": "Usage statistics for given days.",
                "items": {
                  "description": "Represents daily usage history of a hashtag.",
                  "required": [
                    "day",
                    "uses",
                    "accounts"
                  ],
                  "properties": {
                    "accounts": {
                      "type": "string",
                      "description": "the total of accounts using the tag within that day. Cast from an integer."
                    },
                    "day": {
                      "type": "string",
                      "description": "UNIX timestamp on midnight of the given day."
                    },
                    "uses": {
                      "type": "string",
                      "description": "the counted usage of the tag within that day. Cast from an integer."
                    }
                  }
                }
              },
              "name": {
                "type": "string",
                "description": "The value of the hashtag after the `#` sign."
              },
              "url": {
                "type": "string",
                "description": "A link to the hashtag on the instance."
              }
            }
          }
        },
        "text": {
          "type": "string",
          "description": "Plain-text source of a status. Returned instead of `content` when status is deleted, so the user may redraft from the source text without the client having to reverse-engineer the original text from the HTML content."
        },
        "uri": {
          "type": "string",
          "description": "URI of the status used for federation."
        },
        "url": {
          "type": "string",
          "description": "A link to the status's HTML representation."
        },
        "visibility": {
          "type": "string",
          "description": "Visibility of this status.",
          "enum": [
            "public",
            "unlisted",
            "private",
            "direct"
          ]
        }
      }
    },
    "unread": {
      "type": "boolean",
      "description": "Is the conversation currently marked as unread?"
    }
  }
}