GoToSocial/docs/api/swagger.yaml

basePath: /
definitions:
    EmojiUpdateType:
        title: EmojiUpdateType models an admin update action to take on a custom emoji.
        type: string
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    InstanceConfigurationEmojis:
        properties:
            emoji_size_limit:
                description: Max allowed emoji image size in bytes.
                example: 51200
                format: int64
                type: integer
                x-go-name: EmojiSizeLimit
        title: InstanceConfigurationEmojis models instance emoji config parameters.
        type: object
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    Link:
        description: See https://webfinger.net/ and https://www.rfc-editor.org/rfc/rfc6415.html#section-3.1
        properties:
            href:
                type: string
                x-go-name: Href
            rel:
                type: string
                x-go-name: Rel
            template:
                type: string
                x-go-name: Template
            type:
                type: string
                x-go-name: Type
        title: Link represents one 'link' in a slice of links returned from a lookup request.
        type: object
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    Mention:
        properties:
            acct:
                description: |-
                    The account URI as discovered via webfinger.
                    Equal to username for local users, or username@domain for remote users.
                example: some_user@example.org
                type: string
                x-go-name: Acct
            id:
                description: The ID of the mentioned account.
                example: 01FBYJHQWQZAVWFRK9PDYTKGMB
                type: string
                x-go-name: ID
            url:
                description: The web URL of the mentioned account's profile.
                example: https://example.org/@some_user
                type: string
                x-go-name: URL
            username:
                description: The username of the mentioned account.
                example: some_user
                type: string
                x-go-name: Username
        title: Mention represents a mention of another account.
        type: object
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    NodeInfoServices:
        properties:
            inbound:
                items:
                    type: string
                type: array
                x-go-name: Inbound
            outbound:
                items:
                    type: string
                type: array
                x-go-name: Outbound
        title: NodeInfoServices represents inbound and outbound services that this node offers connections to.
        type: object
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    NodeInfoSoftware:
        properties:
            name:
                example: gotosocial
                type: string
                x-go-name: Name
            version:
                example: 0.1.2 1234567
                type: string
                x-go-name: Version
        title: NodeInfoSoftware represents the name and version number of the software of this node.
        type: object
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    NodeInfoUsage:
        properties:
            localPosts:
                format: int64
                type: integer
                x-go-name: LocalPosts
            users:
                $ref: '#/definitions/NodeInfoUsers'
        title: NodeInfoUsage represents usage information about this server, such as number of users.
        type: object
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    NodeInfoUsers:
        properties:
            total:
                format: int64
                type: integer
                x-go-name: Total
        title: NodeInfoUsers represents aggregate information about the users on the server.
        type: object
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    Source:
        description: Returned as an additional entity when verifying and updated credentials, as an attribute of Account.
        properties:
            also_known_as_uris:
                description: |-
                    This account is aliased to / also known as accounts at the
                    given ActivityPub URIs. To set this, use `/api/v1/accounts/alias`.

                    Omitted from json if empty / not set.
                items:
                    type: string
                type: array
                x-go-name: AlsoKnownAsURIs
            fields:
                description: Metadata about the account.
                items:
                    $ref: '#/definitions/field'
                type: array
                x-go-name: Fields
            follow_requests_count:
                description: The number of pending follow requests.
                format: int64
                type: integer
                x-go-name: FollowRequestsCount
            language:
                description: The default posting language for new statuses.
                type: string
                x-go-name: Language
            note:
                description: Profile bio.
                type: string
                x-go-name: Note
            privacy:
                description: |-
                    The default post privacy to be used for new statuses.
                    public = Public post
                    unlisted = Unlisted post
                    private = Followers-only post
                    direct = Direct post
                type: string
                x-go-name: Privacy
            sensitive:
                description: Whether new statuses should be marked sensitive by default.
                type: boolean
                x-go-name: Sensitive
            status_content_type:
                description: The default posting content type for new statuses.
                type: string
                x-go-name: StatusContentType
        title: Source represents display or publishing preferences of user's own account.
        type: object
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    account:
        description: The modelled account can be either a remote account, or one on this instance.
        properties:
            acct:
                description: |-
                    The account URI as discovered via webfinger.
                    Equal to username for local users, or username@domain for remote users.
                example: some_user@example.org
                type: string
                x-go-name: Acct
            avatar:
                description: Web location of the account's avatar.
                example: https://example.org/media/some_user/avatar/original/avatar.jpeg
                type: string
                x-go-name: Avatar
            avatar_static:
                description: |-
                    Web location of a static version of the account's avatar.
                    Only relevant when the account's main avatar is a video or a gif.
                example: https://example.org/media/some_user/avatar/static/avatar.png
                type: string
                x-go-name: AvatarStatic
            bot:
                description: Account identifies as a bot.
                type: boolean
                x-go-name: Bot
            created_at:
                description: When the account was created (ISO 8601 Datetime).
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            custom_css:
                description: CustomCSS to include when rendering this account's profile or statuses.
                type: string
                x-go-name: CustomCSS
            discoverable:
                description: Account has opted into discovery features.
                type: boolean
                x-go-name: Discoverable
            display_name:
                description: The account's display name.
                example: big jeff (he/him)
                type: string
                x-go-name: DisplayName
            emojis:
                description: Array of custom emojis used in this account's note or display name.
                items:
                    $ref: '#/definitions/emoji'
                type: array
                x-go-name: Emojis
            enable_rss:
                description: Account has enabled RSS feed.
                type: boolean
                x-go-name: EnableRSS
            fields:
                description: Additional metadata attached to this account's profile.
                items:
                    $ref: '#/definitions/field'
                type: array
                x-go-name: Fields
            followers_count:
                description: Number of accounts following this account, according to our instance.
                format: int64
                type: integer
                x-go-name: FollowersCount
            following_count:
                description: Number of account's followed by this account, according to our instance.
                format: int64
                type: integer
                x-go-name: FollowingCount
            header:
                description: Web location of the account's header image.
                example: https://example.org/media/some_user/header/original/header.jpeg
                type: string
                x-go-name: Header
            header_static:
                description: |-
                    Web location of a static version of the account's header.
                    Only relevant when the account's main header is a video or a gif.
                example: https://example.org/media/some_user/header/static/header.png
                type: string
                x-go-name: HeaderStatic
            id:
                description: The account id.
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: ID
            last_status_at:
                description: When the account's most recent status was posted (ISO 8601 Datetime).
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: LastStatusAt
            locked:
                description: Account manually approves follow requests.
                type: boolean
                x-go-name: Locked
            moved:
                $ref: '#/definitions/account'
            mute_expires_at:
                description: If this account has been muted, when will the mute expire (ISO 8601 Datetime).
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: MuteExpiresAt
            note:
                description: Bio/description of this account.
                type: string
                x-go-name: Note
            role:
                $ref: '#/definitions/accountRole'
            source:
                $ref: '#/definitions/Source'
            statuses_count:
                description: Number of statuses posted by this account, according to our instance.
                format: int64
                type: integer
                x-go-name: StatusesCount
            suspended:
                description: Account has been suspended by our instance.
                type: boolean
                x-go-name: Suspended
            url:
                description: Web location of the account's profile page.
                example: https://example.org/@some_user
                type: string
                x-go-name: URL
            username:
                description: The username of the account, not including domain.
                example: some_user
                type: string
                x-go-name: Username
        title: Account models a fediverse account.
        type: object
        x-go-name: Account
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    accountRelationship:
        properties:
            blocked_by:
                description: This account is blocking you.
                type: boolean
                x-go-name: BlockedBy
            blocking:
                description: You are blocking this account.
                type: boolean
                x-go-name: Blocking
            domain_blocking:
                description: You are blocking this account's domain.
                type: boolean
                x-go-name: DomainBlocking
            endorsed:
                description: You are featuring this account on your profile.
                type: boolean
                x-go-name: Endorsed
            followed_by:
                description: This account follows you.
                type: boolean
                x-go-name: FollowedBy
            following:
                description: You are following this account.
                type: boolean
                x-go-name: Following
            id:
                description: The account id.
                example: 01FBW9XGEP7G6K88VY4S9MPE1R
                type: string
                x-go-name: ID
            muting:
                description: You are muting this account.
                type: boolean
                x-go-name: Muting
            muting_notifications:
                description: You are muting notifications from this account.
                type: boolean
                x-go-name: MutingNotifications
            note:
                description: Your note on this account.
                type: string
                x-go-name: Note
            notifying:
                description: You are seeing notifications when this account posts.
                type: boolean
                x-go-name: Notifying
            requested:
                description: You have requested to follow this account, and the request is pending.
                type: boolean
                x-go-name: Requested
            showing_reblogs:
                description: You are seeing reblogs/boosts from this account in your home timeline.
                type: boolean
                x-go-name: ShowingReblogs
        title: Relationship represents a relationship between accounts.
        type: object
        x-go-name: Relationship
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    accountRole:
        properties:
            name:
                type: string
                x-go-name: Name
        title: AccountRole models the role of an account.
        type: object
        x-go-name: AccountRole
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    adminAccountInfo:
        properties:
            account:
                $ref: '#/definitions/account'
            approved:
                description: Whether the account is currently approved.
                type: boolean
                x-go-name: Approved
            confirmed:
                description: Whether the account has confirmed their email address.
                type: boolean
                x-go-name: Confirmed
            created_at:
                description: When the account was first discovered. (ISO 8601 Datetime)
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            created_by_application_id:
                description: The ID of the application that created this account.
                type: string
                x-go-name: CreatedByApplicationID
            disabled:
                description: Whether the account is currently disabled.
                type: boolean
                x-go-name: Disabled
            domain:
                description: |-
                    The domain of the account.
                    Null for local accounts.
                example: example.org
                type: string
                x-go-name: Domain
            email:
                description: |-
                    The email address associated with the account.
                    Empty string for remote accounts or accounts with
                    no known email address.
                example: someone@somewhere.com
                type: string
                x-go-name: Email
            id:
                description: The ID of the account in the database.
                example: 01GQ4PHNT622DQ9X95XQX4KKNR
                type: string
                x-go-name: ID
            invite_request:
                description: |-
                    The reason given when requesting an invite.
                    Null if not known / remote account.
                example: Pleaaaaaaaaaaaaaaase!!
                type: string
                x-go-name: InviteRequest
            invited_by_account_id:
                description: The ID of the account that invited this user
                type: string
                x-go-name: InvitedByAccountID
            ip:
                description: |-
                    The IP address last used to login to this account.
                    Null if not known.
                example: 192.0.2.1
                type: string
                x-go-name: IP
            ips:
                description: |-
                    All known IP addresses associated with this account.
                    NOT IMPLEMENTED (will always be empty array).
                example: []
                items: {}
                type: array
                x-go-name: IPs
            locale:
                description: The locale of the account. (ISO 639 Part 1 two-letter language code)
                example: en
                type: string
                x-go-name: Locale
            role:
                $ref: '#/definitions/accountRole'
            silenced:
                description: Whether the account is currently silenced
                type: boolean
                x-go-name: Silenced
            suspended:
                description: Whether the account is currently suspended.
                type: boolean
                x-go-name: Suspended
            username:
                description: The username of the account.
                example: dril
                type: string
                x-go-name: Username
        title: AdminAccountInfo models the admin view of an account's details.
        type: object
        x-go-name: AdminAccountInfo
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    adminActionResponse:
        description: |-
            AdminActionResponse models the server
            response to an admin action.
        properties:
            action_id:
                description: Internal ID of the action.
                example: 01H9QG6TZ9W5P0402VFRVM17TH
                type: string
                x-go-name: ActionID
        type: object
        x-go-name: AdminActionResponse
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    adminEmoji:
        properties:
            category:
                description: Used for sorting custom emoji in the picker.
                example: blobcats
                type: string
                x-go-name: Category
            content_type:
                description: The MIME content type of the emoji.
                example: image/png
                type: string
                x-go-name: ContentType
            disabled:
                description: True if this emoji has been disabled by an admin action.
                example: false
                type: boolean
                x-go-name: Disabled
            domain:
                description: The domain from which the emoji originated. Only defined for remote domains, otherwise key will not be set.
                example: example.org
                type: string
                x-go-name: Domain
            id:
                description: The ID of the emoji.
                example: 01GEM7SFDZ7GZNRXFVZ3X4E4N1
                type: string
                x-go-name: ID
            shortcode:
                description: The name of the custom emoji.
                example: blobcat_uwu
                type: string
                x-go-name: Shortcode
            static_url:
                description: A link to a static copy of the custom emoji.
                example: https://example.org/fileserver/emojis/blogcat_uwu.png
                type: string
                x-go-name: StaticURL
            total_file_size:
                description: The total file size taken up by the emoji in bytes, including static and animated versions.
                example: 69420
                format: int64
                type: integer
                x-go-name: TotalFileSize
            updated_at:
                description: Time when the emoji image was last updated.
                example: "2022-10-05T09:21:26.419Z"
                type: string
                x-go-name: UpdatedAt
            uri:
                description: The ActivityPub URI of the emoji.
                example: https://example.org/emojis/016T5Q3SQKBT337DAKVSKNXXW1
                type: string
                x-go-name: URI
            url:
                description: Web URL of the custom emoji.
                example: https://example.org/fileserver/emojis/blogcat_uwu.gif
                type: string
                x-go-name: URL
            visible_in_picker:
                description: Emoji is visible in the emoji picker of the instance.
                example: true
                type: boolean
                x-go-name: VisibleInPicker
        title: AdminEmoji models the admin view of a custom emoji.
        type: object
        x-go-name: AdminEmoji
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    adminReport:
        properties:
            account:
                $ref: '#/definitions/adminAccountInfo'
            action_taken:
                description: Whether an action has been taken by an admin in response to this report.
                example: false
                type: boolean
                x-go-name: ActionTaken
            action_taken_at:
                description: |-
                    If an action was taken, at what time was this done? (ISO 8601 Datetime)
                    Will be null if not set / no action yet taken.
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: ActionTakenAt
            action_taken_by_account:
                $ref: '#/definitions/adminAccountInfo'
            action_taken_comment:
                description: |-
                    If an action was taken, what comment was made by the admin on the taken action?
                    Will be null if not set / no action yet taken.
                example: Account was suspended.
                type: string
                x-go-name: ActionTakenComment
            assigned_account:
                $ref: '#/definitions/adminAccountInfo'
            category:
                description: Under what category was this report created?
                example: spam
                type: string
                x-go-name: Category
            comment:
                description: |-
                    Comment submitted when the report was created.
                    Will be empty if no comment was submitted.
                example: This person has been harassing me.
                type: string
                x-go-name: Comment
            created_at:
                description: The date when this report was created (ISO 8601 Datetime).
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            forwarded:
                description: Bool to indicate that report should be federated to remote instance.
                example: true
                type: boolean
                x-go-name: Forwarded
            id:
                description: ID of the report.
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: ID
            rules:
                description: |-
                    Array of rules that were broken according to this report.
                    Will be empty if no rule IDs were submitted with the report.
                items:
                    $ref: '#/definitions/instanceRule'
                type: array
                x-go-name: Rules
            statuses:
                description: |-
                    Array of  statuses that were submitted along with this report.
                    Will be empty if no status IDs were submitted with the report.
                items:
                    $ref: '#/definitions/status'
                type: array
                x-go-name: Statuses
            target_account:
                $ref: '#/definitions/adminAccountInfo'
            updated_at:
                description: Time of last action on this report (ISO 8601 Datetime).
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: UpdatedAt
        title: AdminReport models the admin view of a report.
        type: object
        x-go-name: AdminReport
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    advancedVisibilityFlagsForm:
        description: |-
            AdvancedVisibilityFlagsForm allows a few more advanced flags to be set on new statuses, in addition
            to the standard mastodon-compatible ones.
        properties:
            boostable:
                description: This status can be boosted/reblogged.
                type: boolean
                x-go-name: Boostable
            federated:
                description: This status will be federated beyond the local timeline(s).
                type: boolean
                x-go-name: Federated
            likeable:
                description: This status can be liked/faved.
                type: boolean
                x-go-name: Likeable
            replyable:
                description: This status can be replied to.
                type: boolean
                x-go-name: Replyable
        type: object
        x-go-name: AdvancedVisibilityFlagsForm
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    announcement:
        properties:
            all_day:
                description: Announcement doesn't have begin time and end time, but begin day and end day.
                type: boolean
                x-go-name: AllDay
            content:
                description: |-
                    The body of the announcement.
                    Should be HTML formatted.
                example: <p>This is an announcement. No malarky.</p>
                type: string
                x-go-name: Content
            emoji:
                description: Emojis used in this announcement.
                items:
                    $ref: '#/definitions/emoji'
                type: array
                x-go-name: Emojis
            ends_at:
                description: |-
                    When the announcement should stop being displayed (ISO 8601 Datetime).
                    If the announcement has no end time, this will be omitted or empty.
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: EndsAt
            id:
                description: The ID of the announcement.
                example: 01FC30T7X4TNCZK0TH90QYF3M4
                type: string
                x-go-name: ID
            mentions:
                description: Mentions this announcement contains.
                items:
                    $ref: '#/definitions/Mention'
                type: array
                x-go-name: Mentions
            published:
                description: |-
                    Announcement is 'published', ie., visible to users.
                    Announcements that are not published should be shown only to admins.
                type: boolean
                x-go-name: Published
            published_at:
                description: When the announcement was first published (ISO 8601 Datetime).
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: PublishedAt
            reactions:
                description: Reactions to this announcement.
                items:
                    $ref: '#/definitions/announcementReaction'
                type: array
                x-go-name: Reactions
            read:
                description: Requesting account has seen this announcement.
                type: boolean
                x-go-name: Read
            starts_at:
                description: |-
                    When the announcement should begin to be displayed (ISO 8601 Datetime).
                    If the announcement has no start time, this will be omitted or empty.
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: StartsAt
            statuses:
                description: Statuses contained in this announcement.
                items:
                    $ref: '#/definitions/status'
                type: array
                x-go-name: Statuses
            tags:
                description: Tags used in this announcement.
                items:
                    $ref: '#/definitions/tag'
                type: array
                x-go-name: Tags
            updated_at:
                description: When the announcement was last updated (ISO 8601 Datetime).
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: UpdatedAt
        title: Announcement models an admin announcement for the instance.
        type: object
        x-go-name: Announcement
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    announcementReaction:
        properties:
            count:
                description: The total number of users who have added this reaction.
                example: 5
                format: int64
                type: integer
                x-go-name: Count
            me:
                description: This reaction belongs to the account viewing it.
                type: boolean
                x-go-name: Me
            name:
                description: The emoji used for the reaction. Either a unicode emoji, or a custom emoji's shortcode.
                example: blobcat_uwu
                type: string
                x-go-name: Name
            static_url:
                description: |-
                    Web link to a non-animated image of the custom emoji.
                    Empty for unicode emojis.
                example: https://example.org/custom_emojis/statuc/blobcat_uwu.png
                type: string
                x-go-name: StaticURL
            url:
                description: |-
                    Web link to the image of the custom emoji.
                    Empty for unicode emojis.
                example: https://example.org/custom_emojis/original/blobcat_uwu.png
                type: string
                x-go-name: URL
        title: AnnouncementReaction models a user reaction to an announcement.
        type: object
        x-go-name: AnnouncementReaction
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    application:
        properties:
            client_id:
                description: Client ID associated with this application.
                type: string
                x-go-name: ClientID
            client_secret:
                description: Client secret associated with this application.
                type: string
                x-go-name: ClientSecret
            id:
                description: The ID of the application.
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: ID
            name:
                description: The name of the application.
                example: Tusky
                type: string
                x-go-name: Name
            redirect_uri:
                description: Post-authorization redirect URI for the application (OAuth2).
                example: https://example.org/callback?some=query
                type: string
                x-go-name: RedirectURI
            vapid_key:
                description: Push API key for this application.
                type: string
                x-go-name: VapidKey
            website:
                description: The website associated with the application (url)
                example: https://tusky.app
                type: string
                x-go-name: Website
        title: Application models an api application.
        type: object
        x-go-name: Application
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    attachment:
        properties:
            blurhash:
                description: |-
                    A hash computed by the BlurHash algorithm, for generating colorful preview thumbnails when media has not been downloaded yet.
                    See https://github.com/woltapp/blurhash
                type: string
                x-go-name: Blurhash
            description:
                description: Alt text that describes what is in the media attachment.
                example: This is a picture of a kitten.
                type: string
                x-go-name: Description
            id:
                description: The ID of the attachment.
                example: 01FC31DZT1AYWDZ8XTCRWRBYRK
                type: string
                x-go-name: ID
            meta:
                $ref: '#/definitions/mediaMeta'
            preview_remote_url:
                description: |-
                    The location of a scaled-down preview of the attachment on the remote server.
                    Only defined for instances other than our own.
                example: https://some-other-server.org/attachments/small/ahhhhh.jpeg
                type: string
                x-go-name: PreviewRemoteURL
            preview_url:
                description: The location of a scaled-down preview of the attachment.
                example: https://example.org/fileserver/some_id/attachments/some_id/small/attachment.jpeg
                type: string
                x-go-name: PreviewURL
            remote_url:
                description: |-
                    The location of the full-size original attachment on the remote server.
                    Only defined for instances other than our own.
                example: https://some-other-server.org/attachments/original/ahhhhh.jpeg
                type: string
                x-go-name: RemoteURL
            text_url:
                description: |-
                    A shorter URL for the attachment.
                    In our case, we just give the URL again since we don't create smaller URLs.
                type: string
                x-go-name: TextURL
            type:
                description: The type of the attachment.
                example: image
                type: string
                x-go-name: Type
            url:
                description: The location of the original full-size attachment.
                example: https://example.org/fileserver/some_id/attachments/some_id/original/attachment.jpeg
                type: string
                x-go-name: URL
        title: Attachment models a media attachment.
        type: object
        x-go-name: Attachment
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    card:
        properties:
            author_name:
                description: The author of the original resource.
                example: weewee@buzzfeed.com
                type: string
                x-go-name: AuthorName
            author_url:
                description: A link to the author of the original resource.
                example: https://buzzfeed.com/authors/weewee
                type: string
                x-go-name: AuthorURL
            blurhash:
                description: A hash computed by the BlurHash algorithm, for generating colorful preview thumbnails when media has not been downloaded yet.
                type: string
                x-go-name: Blurhash
            description:
                description: Description of preview.
                example: Is water wet? We're not sure. In this article, we ask an expert...
                type: string
                x-go-name: Description
            embed_url:
                description: Used for photo embeds, instead of custom html.
                type: string
                x-go-name: EmbedURL
            height:
                description: Height of preview, in pixels.
                format: int64
                type: integer
                x-go-name: Height
            html:
                description: HTML to be used for generating the preview card.
                type: string
                x-go-name: HTML
            image:
                description: Preview thumbnail.
                example: https://example.org/fileserver/preview/thumb.jpg
                type: string
                x-go-name: Image
            provider_name:
                description: The provider of the original resource.
                example: Buzzfeed
                type: string
                x-go-name: ProviderName
            provider_url:
                description: A link to the provider of the original resource.
                example: https://buzzfeed.com
                type: string
                x-go-name: ProviderURL
            title:
                description: Title of linked resource.
                example: Buzzfeed - Is Water Wet?
                type: string
                x-go-name: Title
            type:
                description: The type of the preview card.
                example: link
                type: string
                x-go-name: Type
            url:
                description: Location of linked resource.
                example: https://buzzfeed.com/some/fuckin/buzzfeed/article
                type: string
                x-go-name: URL
            width:
                description: Width of preview, in pixels.
                format: int64
                type: integer
                x-go-name: Width
        title: Card represents a rich preview card that is generated using OpenGraph tags from a URL.
        type: object
        x-go-name: Card
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    debugAPUrlResponse:
        description: |-
            DebugAPUrlResponse provides detailed debug
            information for an AP URL dereference request.
        properties:
            request_headers:
                additionalProperties:
                    items:
                        type: string
                    type: array
                description: HTTP headers used in the outgoing request.
                type: object
                x-go-name: RequestHeaders
            request_url:
                description: Remote AP URL that was requested.
                type: string
                x-go-name: RequestURL
            response_body:
                description: |-
                    Body returned from the remote instance.
                    Will be stringified bytes; may be JSON,
                    may be an error, may be both!
                type: string
                x-go-name: ResponseBody
            response_code:
                description: HTTP response code returned from the remote instance.
                format: int64
                type: integer
                x-go-name: ResponseCode
            response_headers:
                additionalProperties:
                    items:
                        type: string
                    type: array
                description: HTTP headers returned from the remote instance.
                type: object
                x-go-name: ResponseHeaders
        type: object
        x-go-name: DebugAPUrlResponse
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    domain:
        description: Domain represents a remote domain
        properties:
            domain:
                description: The hostname of the domain.
                example: example.org
                type: string
                x-go-name: Domain
            public_comment:
                description: If the domain is blocked, what's the publicly-stated reason for the block.
                example: they smell
                type: string
                x-go-name: PublicComment
            silenced_at:
                description: Time at which this domain was silenced. Key will not be present on open domains.
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: SilencedAt
            suspended_at:
                description: Time at which this domain was suspended. Key will not be present on open domains.
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: SuspendedAt
        type: object
        x-go-name: Domain
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    domainKeysExpireRequest:
        properties:
            domain:
                description: hostname/domain to expire keys for.
                type: string
                x-go-name: Domain
        title: DomainBlockCreateRequest is the form submitted as a POST to /api/v1/admin/domain_keys_expire to expire a domain's public keys.
        type: object
        x-go-name: DomainKeysExpireRequest
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    domainPermission:
        properties:
            created_at:
                description: Time at which the permission entry was created (ISO 8601 Datetime).
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            created_by:
                description: ID of the account that created this domain permission entry.
                example: 01FBW2758ZB6PBR200YPDDJK4C
                type: string
                x-go-name: CreatedBy
            domain:
                description: The hostname of the domain.
                example: example.org
                type: string
                x-go-name: Domain
            id:
                description: The ID of the domain permission entry.
                example: 01FBW21XJA09XYX51KV5JVBW0F
                readOnly: true
                type: string
                x-go-name: ID
            obfuscate:
                description: Obfuscate the domain name when serving this domain permission entry publicly.
                example: false
                type: boolean
                x-go-name: Obfuscate
            private_comment:
                description: Private comment for this permission entry, visible to this instance's admins only.
                example: they are poopoo
                type: string
                x-go-name: PrivateComment
            public_comment:
                description: If the domain is blocked, what's the publicly-stated reason for the block.
                example: they smell
                type: string
                x-go-name: PublicComment
            silenced_at:
                description: Time at which this domain was silenced. Key will not be present on open domains.
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: SilencedAt
            subscription_id:
                description: If applicable, the ID of the subscription that caused this domain permission entry to be created.
                example: 01FBW25TF5J67JW3HFHZCSD23K
                type: string
                x-go-name: SubscriptionID
            suspended_at:
                description: Time at which this domain was suspended. Key will not be present on open domains.
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: SuspendedAt
        title: DomainPermission represents a permission applied to one domain (explicit block/allow).
        type: object
        x-go-name: DomainPermission
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    domainPermissionCreateRequest:
        properties:
            domain:
                description: |-
                    A single domain for which this permission request should apply.
                    Only used if import=true is NOT specified or if import=false.
                example: example.org
                type: string
                x-go-name: Domain
            domains:
                description: |-
                    A list of domains for which this permission request should apply.
                    Only used if import=true is specified.
                x-go-name: Domains
            obfuscate:
                description: |-
                    Obfuscate the domain name when displaying this permission entry publicly.
                    Ie., instead of 'example.org' show something like 'e**mpl*.or*'.
                example: false
                type: boolean
                x-go-name: Obfuscate
            private_comment:
                description: Private comment for other admins on why this permission entry was created.
                example: don't like 'em!!!!
                type: string
                x-go-name: PrivateComment
            public_comment:
                description: |-
                    Public comment on why this permission entry was created.
                    Will be visible to requesters at /api/v1/instance/peers if this endpoint is exposed.
                example: "foss dorks \U0001F62B"
                type: string
                x-go-name: PublicComment
        title: DomainPermissionRequest is the form submitted as a POST to create a new domain permission entry (allow/block).
        type: object
        x-go-name: DomainPermissionRequest
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    emoji:
        properties:
            category:
                description: Used for sorting custom emoji in the picker.
                example: blobcats
                type: string
                x-go-name: Category
            shortcode:
                description: The name of the custom emoji.
                example: blobcat_uwu
                type: string
                x-go-name: Shortcode
            static_url:
                description: A link to a static copy of the custom emoji.
                example: https://example.org/fileserver/emojis/blogcat_uwu.png
                type: string
                x-go-name: StaticURL
            url:
                description: Web URL of the custom emoji.
                example: https://example.org/fileserver/emojis/blogcat_uwu.gif
                type: string
                x-go-name: URL
            visible_in_picker:
                description: Emoji is visible in the emoji picker of the instance.
                example: true
                type: boolean
                x-go-name: VisibleInPicker
        title: Emoji represents a custom emoji.
        type: object
        x-go-name: Emoji
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    emojiCategory:
        properties:
            id:
                description: The ID of the custom emoji category.
                type: string
                x-go-name: ID
            name:
                description: The name of the custom emoji category.
                type: string
                x-go-name: Name
        title: EmojiCategory represents a custom emoji category.
        type: object
        x-go-name: EmojiCategory
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    emojiCreateRequest:
        properties:
            CategoryName:
                description: |-
                    Category in which to place the new emoji. Will be uncategorized by default.
                    CategoryName length should not exceed 64 characters.
                type: string
            Image:
                description: Image file to use for the emoji. Must be png or gif and no larger than 50kb.
            Shortcode:
                description: Desired shortcode for the emoji, without surrounding colons. This must be unique for the domain.
                example: blobcat_uwu
                type: string
        title: EmojiCreateRequest represents a request to create a custom emoji made through the admin API.
        type: object
        x-go-name: EmojiCreateRequest
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    emojiUpdateRequest:
        properties:
            CategoryName:
                description: Category in which to place the emoji.
                type: string
            Image:
                description: |-
                    Image file to use for the emoji.
                    Must be png or gif and no larger than 50kb.
            Shortcode:
                description: Desired shortcode for the emoji, without surrounding colons. This must be unique for the domain.
                example: blobcat_uwu
                type: string
            type:
                $ref: '#/definitions/EmojiUpdateType'
        title: EmojiUpdateRequest represents a request to update a custom emoji, made through the admin API.
        type: object
        x-go-name: EmojiUpdateRequest
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    field:
        properties:
            name:
                description: The key/name of this field.
                example: pronouns
                type: string
                x-go-name: Name
            value:
                description: The value of this field.
                example: they/them
                type: string
                x-go-name: Value
            verified_at:
                description: If this field has been verified, when did this occur? (ISO 8601 Datetime).
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: VerifiedAt
        title: Field represents a name/value pair to display on an account's profile.
        type: object
        x-go-name: Field
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    headerFilterCreateRequest:
        properties:
            header:
                description: The HTTP header to match against (e.g. User-Agent).
                type: string
                x-go-name: Header
            regex:
                description: The header value matching regular expression.
                type: string
                x-go-name: Regex
        title: HeaderFilterRequest is the form submitted as a POST to create a new header filter entry (allow / block).
        type: object
        x-go-name: HeaderFilterRequest
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    hostmeta:
        description: 'See: https://www.rfc-editor.org/rfc/rfc6415.html#section-3'
        properties:
            Link:
                items:
                    $ref: '#/definitions/Link'
                type: array
            XMLNS:
                type: string
            XMLName: {}
        title: HostMeta represents a hostmeta document.
        type: object
        x-go-name: HostMeta
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceConfigurationAccounts:
        properties:
            allow_custom_css:
                description: Whether or not accounts on this instance are allowed to upload custom CSS for profiles and statuses.
                example: false
                type: boolean
                x-go-name: AllowCustomCSS
            max_featured_tags:
                description: |-
                    The maximum number of featured tags allowed for each account.
                    Currently not implemented, so this is hardcoded to 10.
                format: int64
                type: integer
                x-go-name: MaxFeaturedTags
            max_profile_fields:
                description: |-
                    The maximum number of profile fields allowed for each account.
                    Currently not configurable, so this is hardcoded to 6. (https://github.com/superseriousbusiness/gotosocial/issues/1876)
                format: int64
                type: integer
                x-go-name: MaxProfileFields
        title: InstanceConfigurationAccounts models instance account config parameters.
        type: object
        x-go-name: InstanceConfigurationAccounts
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceConfigurationMediaAttachments:
        properties:
            image_matrix_limit:
                description: |-
                    Max allowed image size in pixels as height*width.

                    GtS doesn't set a limit on this, but for compatibility
                    we give Mastodon's 4096x4096px value here.
                example: 16777216
                format: int64
                type: integer
                x-go-name: ImageMatrixLimit
            image_size_limit:
                description: Max allowed image size in bytes
                example: 2097152
                format: int64
                type: integer
                x-go-name: ImageSizeLimit
            supported_mime_types:
                description: List of mime types that it's possible to upload to this instance.
                example:
                    - image/jpeg
                    - image/gif
                items:
                    type: string
                type: array
                x-go-name: SupportedMimeTypes
            video_frame_rate_limit:
                description: Max allowed video frame rate.
                example: 60
                format: int64
                type: integer
                x-go-name: VideoFrameRateLimit
            video_matrix_limit:
                description: |-
                    Max allowed video size in pixels as height*width.

                    GtS doesn't set a limit on this, but for compatibility
                    we give Mastodon's 4096x4096px value here.
                example: 16777216
                format: int64
                type: integer
                x-go-name: VideoMatrixLimit
            video_size_limit:
                description: Max allowed video size in bytes
                example: 10485760
                format: int64
                type: integer
                x-go-name: VideoSizeLimit
        title: InstanceConfigurationMediaAttachments models instance media attachment config parameters.
        type: object
        x-go-name: InstanceConfigurationMediaAttachments
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceConfigurationPolls:
        properties:
            max_characters_per_option:
                description: Number of characters allowed per option in the poll.
                example: 50
                format: int64
                type: integer
                x-go-name: MaxCharactersPerOption
            max_expiration:
                description: Maximum expiration time of the poll in seconds.
                example: 2629746
                format: int64
                type: integer
                x-go-name: MaxExpiration
            max_options:
                description: Number of options permitted in a poll on this instance.
                example: 4
                format: int64
                type: integer
                x-go-name: MaxOptions
            min_expiration:
                description: Minimum expiration time of the poll in seconds.
                example: 300
                format: int64
                type: integer
                x-go-name: MinExpiration
        title: InstanceConfigurationPolls models instance poll config parameters.
        type: object
        x-go-name: InstanceConfigurationPolls
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceConfigurationStatuses:
        properties:
            characters_reserved_per_url:
                description: Amount of characters clients should assume a url takes up.
                example: 25
                format: int64
                type: integer
                x-go-name: CharactersReservedPerURL
            max_characters:
                description: Maximum allowed length of a post on this instance, in characters.
                example: 5000
                format: int64
                type: integer
                x-go-name: MaxCharacters
            max_media_attachments:
                description: Max number of attachments allowed on a status.
                example: 4
                format: int64
                type: integer
                x-go-name: MaxMediaAttachments
            supported_mime_types:
                description: List of mime types that it's possible to use for statuses on this instance.
                example:
                    - text/plain
                    - text/markdown
                items:
                    type: string
                type: array
                x-go-name: SupportedMimeTypes
        title: InstanceConfigurationStatuses models instance status config parameters.
        type: object
        x-go-name: InstanceConfigurationStatuses
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceRule:
        properties:
            id:
                type: string
                x-go-name: ID
            text:
                type: string
                x-go-name: Text
        title: InstanceRule represents a single instance rule.
        type: object
        x-go-name: InstanceRule
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceRuleCreateRequest:
        properties:
            Text:
                type: string
        title: InstanceRuleCreateRequest represents a request to create a new instance rule, made through the admin API.
        type: object
        x-go-name: InstanceRuleCreateRequest
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceRuleUpdateRequest:
        properties:
            ID:
                type: string
            Text:
                type: string
        title: InstanceRuleUpdateRequest represents a request to update the text of an instance rule, made through the admin API.
        type: object
        x-go-name: InstanceRuleUpdateRequest
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceV1:
        properties:
            account_domain:
                description: |-
                    The domain of accounts on this instance.
                    This will not necessarily be the same as
                    simply the Host part of the URI.
                example: example.org
                type: string
                x-go-name: AccountDomain
            approval_required:
                description: New account registrations require admin approval.
                type: boolean
                x-go-name: ApprovalRequired
            configuration:
                $ref: '#/definitions/instanceV1Configuration'
            contact_account:
                $ref: '#/definitions/account'
            description:
                description: |-
                    Description of the instance.

                    Should be HTML formatted, but might be plaintext.

                    This should be displayed on the 'about' page for an instance.
                type: string
                x-go-name: Description
            description_text:
                description: Raw (unparsed) version of description.
                type: string
                x-go-name: DescriptionText
            email:
                description: An email address that may be used for inquiries.
                example: admin@example.org
                type: string
                x-go-name: Email
            invites_enabled:
                description: Invites are enabled on this instance.
                type: boolean
                x-go-name: InvitesEnabled
            languages:
                description: Primary language of the instance.
                example: en
                items:
                    type: string
                type: array
                x-go-name: Languages
            max_toot_chars:
                description: |-
                    Maximum allowed length of a post on this instance, in characters.

                    This is provided for compatibility with Tusky and other apps.
                example: 5000
                format: uint64
                type: integer
                x-go-name: MaxTootChars
            registrations:
                description: New account registrations are enabled on this instance.
                type: boolean
                x-go-name: Registrations
            rules:
                description: An itemized list of rules for this instance.
                items:
                    $ref: '#/definitions/instanceRule'
                type: array
                x-go-name: Rules
            short_description:
                description: |-
                    A shorter description of the instance.

                    Should be HTML formatted, but might be plaintext.

                    This should be displayed on the instance splash/landing page.
                type: string
                x-go-name: ShortDescription
            short_description_text:
                description: Raw (unparsed) version of short description.
                type: string
                x-go-name: ShortDescriptionText
            stats:
                additionalProperties:
                    format: int64
                    type: integer
                description: 'Statistics about the instance: number of posts, accounts, etc.'
                type: object
                x-go-name: Stats
            terms:
                description: Terms and conditions for accounts on this instance.
                type: string
                x-go-name: Terms
            terms_text:
                description: Raw (unparsed) version of terms.
                type: string
                x-go-name: TermsRaw
            thumbnail:
                description: URL of the instance avatar/banner image.
                example: https://example.org/files/instance/thumbnail.jpeg
                type: string
                x-go-name: Thumbnail
            thumbnail_description:
                description: Description of the instance thumbnail.
                example: picture of a cute lil' friendly sloth
                type: string
                x-go-name: ThumbnailDescription
            thumbnail_type:
                description: MIME type of the instance thumbnail.
                example: image/png
                type: string
                x-go-name: ThumbnailType
            title:
                description: The title of the instance.
                example: GoToSocial Example Instance
                type: string
                x-go-name: Title
            uri:
                description: The URI of the instance.
                example: https://gts.example.org
                type: string
                x-go-name: URI
            urls:
                $ref: '#/definitions/instanceV1URLs'
            version:
                description: |-
                    The version of GoToSocial installed on the instance.

                    This will contain at least a semantic version number.

                    It may also contain, after a space, the short git commit ID of the running software.
                example: 0.1.1 cb85f65
                type: string
                x-go-name: Version
        title: InstanceV1 models information about this instance.
        type: object
        x-go-name: InstanceV1
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceV1Configuration:
        properties:
            accounts:
                $ref: '#/definitions/instanceConfigurationAccounts'
            emojis:
                $ref: '#/definitions/InstanceConfigurationEmojis'
            media_attachments:
                $ref: '#/definitions/instanceConfigurationMediaAttachments'
            polls:
                $ref: '#/definitions/instanceConfigurationPolls'
            statuses:
                $ref: '#/definitions/instanceConfigurationStatuses'
        title: InstanceV1Configuration models instance configuration parameters.
        type: object
        x-go-name: InstanceV1Configuration
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceV1URLs:
        properties:
            streaming_api:
                description: Websockets address for status and notification streaming.
                example: wss://example.org
                type: string
                x-go-name: StreamingAPI
        title: InstanceV1URLs models instance-relevant URLs for client application consumption.
        type: object
        x-go-name: InstanceV1URLs
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceV2:
        properties:
            account_domain:
                description: |-
                    The domain of accounts on this instance.
                    This will not necessarily be the same as
                    domain.
                example: example.org
                type: string
                x-go-name: AccountDomain
            configuration:
                $ref: '#/definitions/instanceV2Configuration'
            contact:
                $ref: '#/definitions/instanceV2Contact'
            description:
                description: |-
                    Description of the instance.

                    Should be HTML formatted, but might be plaintext.

                    This should be displayed on the 'about' page for an instance.
                type: string
                x-go-name: Description
            description_text:
                description: Raw (unparsed) version of description.
                type: string
                x-go-name: DescriptionText
            domain:
                description: The domain of the instance.
                example: gts.example.org
                type: string
                x-go-name: Domain
            languages:
                description: Primary languages of the instance + moderators/admins.
                example:
                    - en
                items:
                    type: string
                type: array
                x-go-name: Languages
            registrations:
                $ref: '#/definitions/instanceV2Registrations'
            rules:
                description: An itemized list of rules for this instance.
                items:
                    $ref: '#/definitions/instanceRule'
                type: array
                x-go-name: Rules
            source_url:
                description: The URL for the source code of the software running on this instance, in keeping with AGPL license requirements.
                example: https://github.com/superseriousbusiness/gotosocial
                type: string
                x-go-name: SourceURL
            terms:
                description: Terms and conditions for accounts on this instance.
                type: string
                x-go-name: Terms
            terms_text:
                description: Raw (unparsed) version of terms.
                type: string
                x-go-name: TermsText
            thumbnail:
                $ref: '#/definitions/instanceV2Thumbnail'
            title:
                description: The title of the instance.
                example: GoToSocial Example Instance
                type: string
                x-go-name: Title
            usage:
                $ref: '#/definitions/instanceV2Usage'
            version:
                description: |-
                    The version of GoToSocial installed on the instance.

                    This will contain at least a semantic version number.

                    It may also contain, after a space, the short git commit ID of the running software.
                example: 0.1.1 cb85f65
                type: string
                x-go-name: Version
        title: InstanceV2 models information about this instance.
        type: object
        x-go-name: InstanceV2
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceV2Configuration:
        properties:
            accounts:
                $ref: '#/definitions/instanceConfigurationAccounts'
            emojis:
                $ref: '#/definitions/InstanceConfigurationEmojis'
            media_attachments:
                $ref: '#/definitions/instanceConfigurationMediaAttachments'
            polls:
                $ref: '#/definitions/instanceConfigurationPolls'
            statuses:
                $ref: '#/definitions/instanceConfigurationStatuses'
            translation:
                $ref: '#/definitions/instanceV2ConfigurationTranslation'
            urls:
                $ref: '#/definitions/instanceV2URLs'
        title: Configured values and limits for this instance.
        type: object
        x-go-name: InstanceV2Configuration
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceV2ConfigurationTranslation:
        properties:
            enabled:
                description: |-
                    Whether the Translations API is available on this instance.
                    Not implemented so this value is always false.
                type: boolean
                x-go-name: Enabled
        title: Hints related to translation.
        type: object
        x-go-name: InstanceV2ConfigurationTranslation
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceV2Contact:
        properties:
            account:
                $ref: '#/definitions/account'
            email:
                description: |-
                    An email address that can be messaged regarding inquiries or issues.
                    Empty string if no email address set.
                example: someone@example.org
                type: string
                x-go-name: Email
        title: Hints related to contacting a representative of the instance.
        type: object
        x-go-name: InstanceV2Contact
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceV2Registrations:
        properties:
            approval_required:
                description: Whether registrations require moderator approval.
                example: true
                type: boolean
                x-go-name: ApprovalRequired
            enabled:
                description: Whether registrations are enabled.
                example: false
                type: boolean
                x-go-name: Enabled
            message:
                description: |-
                    A custom message (html string) to be shown when registrations are closed.
                    Value will be null if no message is set.
                example: <p>Registrations are currently closed on example.org because of spam bots!</p>
                type: string
                x-go-name: Message
        title: Information about registering for this instance.
        type: object
        x-go-name: InstanceV2Registrations
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceV2Thumbnail:
        properties:
            blurhash:
                description: |-
                    A hash computed by the BlurHash algorithm, for generating colorful preview thumbnails when media has not been downloaded yet.
                    Key/value not set if no blurhash available.
                example: UeKUpFxuo~R%0nW;WCnhF6RjaJt757oJodS$
                type: string
                x-go-name: Blurhash
            thumbnail_description:
                description: |-
                    Description of the instance thumbnail.
                    Key/value not set if no description available.
                example: picture of a cute lil' friendly sloth
                type: string
                x-go-name: Description
            thumbnail_type:
                description: |-
                    MIME type of the instance thumbnail.
                    Key/value not set if thumbnail image type unknown.
                example: image/png
                type: string
                x-go-name: Type
            url:
                description: The URL for the thumbnail image.
                example: https://example.org/fileserver/01BPSX2MKCRVMD4YN4D71G9CP5/attachment/original/01H88X0KQ2DFYYDSWYP93VDJZA.png
                type: string
                x-go-name: URL
            versions:
                $ref: '#/definitions/instanceV2ThumbnailVersions'
        title: An image used to represent this instance.
        type: object
        x-go-name: InstanceV2Thumbnail
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceV2ThumbnailVersions:
        properties:
            '@1x':
                description: |-
                    The URL for the thumbnail image at 1x resolution.
                    Key/value not set if scaled versions not available.
                type: string
                x-go-name: Size1URL
            '@2x':
                description: |-
                    The URL for the thumbnail image at 2x resolution.
                    Key/value not set if scaled versions not available.
                type: string
                x-go-name: Size2URL
        title: Links to scaled resolution images, for high DPI screens.
        type: object
        x-go-name: InstanceV2ThumbnailVersions
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceV2URLs:
        properties:
            streaming:
                description: Websockets address for status and notification streaming.
                example: wss://example.org
                type: string
                x-go-name: Streaming
        title: InstanceV2URLs models instance-relevant URLs for client application consumption.
        type: object
        x-go-name: InstanceV2URLs
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceV2Usage:
        properties:
            users:
                $ref: '#/definitions/instanceV2Users'
        title: Usage data for this instance.
        type: object
        x-go-name: InstanceV2Usage
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    instanceV2Users:
        properties:
            active_month:
                description: |-
                    The number of active users in the past 4 weeks.
                    Currently not implemented: will always be 0.
                example: 0
                format: int64
                type: integer
                x-go-name: ActiveMonth
        title: Usage data related to users on this instance.
        type: object
        x-go-name: InstanceV2Users
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    list:
        properties:
            id:
                description: The ID of the list.
                type: string
                x-go-name: ID
            replies_policy:
                description: |-
                    RepliesPolicy for this list.
                    followed = Show replies to any followed user
                    list = Show replies to members of the list
                    none = Show replies to no one
                type: string
                x-go-name: RepliesPolicy
            title:
                description: The user-defined title of the list.
                type: string
                x-go-name: Title
        title: List represents a user-created list of accounts that the user follows.
        type: object
        x-go-name: List
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    mediaDimensions:
        properties:
            aspect:
                description: |-
                    Aspect ratio of the media.
                    Equal to width / height.
                example: 1.777777778
                format: float
                type: number
                x-go-name: Aspect
            bitrate:
                description: Bitrate of the media in bits per second.
                example: 1000000
                format: int64
                type: integer
                x-go-name: Bitrate
            duration:
                description: |-
                    Duration of the media in seconds.
                    Only set for video and audio.
                example: 5.43
                format: float
                type: number
                x-go-name: Duration
            frame_rate:
                description: |-
                    Framerate of the media.
                    Only set for video and gifs.
                example: "30"
                type: string
                x-go-name: FrameRate
            height:
                description: |-
                    Height of the media in pixels.
                    Not set for audio.
                example: 1080
                format: int64
                type: integer
                x-go-name: Height
            size:
                description: |-
                    Size of the media, in the format `[width]x[height]`.
                    Not set for audio.
                example: 1920x1080
                type: string
                x-go-name: Size
            width:
                description: |-
                    Width of the media in pixels.
                    Not set for audio.
                example: 1920
                format: int64
                type: integer
                x-go-name: Width
        title: MediaDimensions models detailed properties of a piece of media.
        type: object
        x-go-name: MediaDimensions
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    mediaFocus:
        properties:
            x:
                description: |-
                    x position of the focus
                    should be between -1 and 1
                format: float
                type: number
                x-go-name: X
            "y":
                description: |-
                    y position of the focus
                    should be between -1 and 1
                format: float
                type: number
                x-go-name: "Y"
        title: MediaFocus models the focal point of a piece of media.
        type: object
        x-go-name: MediaFocus
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    mediaMeta:
        description: This can be metadata about an image, an audio file, video, etc.
        properties:
            focus:
                $ref: '#/definitions/mediaFocus'
            original:
                $ref: '#/definitions/mediaDimensions'
            small:
                $ref: '#/definitions/mediaDimensions'
        title: MediaMeta models media metadata.
        type: object
        x-go-name: MediaMeta
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    multiStatus:
        description: |-
            This model should be transmitted along with http code
            207 MULTI-STATUS to indicate a mixture of responses.
            See https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/207
        properties:
            data:
                items:
                    $ref: '#/definitions/multiStatusEntry'
                type: array
                x-go-name: Data
            metadata:
                $ref: '#/definitions/multiStatusMetadata'
        title: MultiStatus models a multistatus HTTP response body.
        type: object
        x-go-name: MultiStatus
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    multiStatusEntry:
        description: |-
            It can model either a success or a failure. The type
            and value of `Resource` is left to the discretion of
            the caller, but at minimum it should be expected to be
            JSON-serializable.
        properties:
            message:
                description: Message/error message for this entry.
                type: string
                x-go-name: Message
            resource:
                description: |-
                    The resource/result for this entry.
                    Value may be any type, check the docs
                    per endpoint to see which to expect.
                x-go-name: Resource
            status:
                description: HTTP status code of this entry.
                format: int64
                type: integer
                x-go-name: Status
        title: MultiStatusEntry models one entry in multistatus data.
        type: object
        x-go-name: MultiStatusEntry
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    multiStatusMetadata:
        description: |-
            MultiStatusMetadata models an at-a-glance summary of
            the data contained in the MultiStatus.
        properties:
            failure:
                description: Count of unsuccessful results (!2xx).
                format: int64
                type: integer
                x-go-name: Failure
            success:
                description: Count of successful results (2xx).
                format: int64
                type: integer
                x-go-name: Success
            total:
                description: Success count + failure count.
                format: int64
                type: integer
                x-go-name: Total
        type: object
        x-go-name: MultiStatusMetadata
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    nodeinfo:
        description: 'See: https://nodeinfo.diaspora.software/schema.html'
        properties:
            metadata:
                additionalProperties: {}
                description: Free form key value pairs for software specific values. Clients should not rely on any specific key present.
                type: object
                x-go-name: Metadata
            openRegistrations:
                description: Whether this server allows open self-registration.
                example: false
                type: boolean
                x-go-name: OpenRegistrations
            protocols:
                description: The protocols supported on this server.
                items:
                    type: string
                type: array
                x-go-name: Protocols
            services:
                $ref: '#/definitions/NodeInfoServices'
            software:
                $ref: '#/definitions/NodeInfoSoftware'
            usage:
                $ref: '#/definitions/NodeInfoUsage'
            version:
                description: The schema version
                example: "2.0"
                type: string
                x-go-name: Version
        title: Nodeinfo represents a version 2.1 or version 2.0 nodeinfo schema.
        type: object
        x-go-name: Nodeinfo
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    notification:
        properties:
            account:
                $ref: '#/definitions/account'
            created_at:
                description: The timestamp of the notification (ISO 8601 Datetime)
                type: string
                x-go-name: CreatedAt
            id:
                description: The id of the notification in the database.
                type: string
                x-go-name: ID
            status:
                $ref: '#/definitions/status'
            type:
                description: |-
                    The type of event that resulted in the notification.
                    follow = Someone followed you
                    follow_request = Someone requested to follow you
                    mention = Someone mentioned you in their status
                    reblog = Someone boosted one of your statuses
                    favourite = Someone favourited one of your statuses
                    poll = A poll you have voted in or created has ended
                    status = Someone you enabled notifications for has posted a status
                type: string
                x-go-name: Type
        title: Notification represents a notification of an event relevant to the user.
        type: object
        x-go-name: Notification
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    oauthToken:
        properties:
            access_token:
                description: Access token used for authorization.
                type: string
                x-go-name: AccessToken
            created_at:
                description: When the OAuth token was generated (UNIX timestamp seconds).
                example: 1627644520
                format: int64
                type: integer
                x-go-name: CreatedAt
            scope:
                description: OAuth scopes granted by this token, space-separated.
                example: read write admin
                type: string
                x-go-name: Scope
            token_type:
                description: OAuth token type. Will always be 'Bearer'.
                example: bearer
                type: string
                x-go-name: TokenType
        title: Token represents an OAuth token used for authenticating with the GoToSocial API and performing actions.
        type: object
        x-go-name: Token
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    poll:
        properties:
            emojis:
                description: Custom emoji to be used for rendering poll options.
                items:
                    $ref: '#/definitions/emoji'
                type: array
                x-go-name: Emojis
            expired:
                description: Is the poll currently expired?
                type: boolean
                x-go-name: Expired
            expires_at:
                description: When the poll ends. (ISO 8601 Datetime).
                type: string
                x-go-name: ExpiresAt
            id:
                description: The ID of the poll in the database.
                example: 01FBYKMD1KBMJ0W6JF1YZ3VY5D
                type: string
                x-go-name: ID
            multiple:
                description: Does the poll allow multiple-choice answers?
                type: boolean
                x-go-name: Multiple
            options:
                description: Possible answers for the poll.
                items:
                    $ref: '#/definitions/pollOption'
                type: array
                x-go-name: Options
            own_votes:
                description: |-
                    When called with a user token, which options has the authorized
                    user chosen? Contains an array of index values for options.

                    Omitted when no user token provided.
                items:
                    format: int64
                    type: integer
                type: array
                x-go-name: OwnVotes
            voted:
                description: |-
                    When called with a user token, has the authorized user voted?

                    Omitted when no user token provided.
                type: boolean
                x-go-name: Voted
            voters_count:
                description: How many unique accounts have voted on a multiple-choice poll.
                format: int64
                type: integer
                x-go-name: VotersCount
            votes_count:
                description: How many votes have been received.
                format: int64
                type: integer
                x-go-name: VotesCount
        title: Poll represents a poll attached to a status.
        type: object
        x-go-name: Poll
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    pollOption:
        properties:
            title:
                description: The text value of the poll option. String.
                type: string
                x-go-name: Title
            votes_count:
                description: The number of received votes for this option.
                format: int64
                type: integer
                x-go-name: VotesCount
        title: PollOption represents the current vote counts for different poll options.
        type: object
        x-go-name: PollOption
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    pollRequest:
        properties:
            ExpiresIn:
                description: |-
                    Duration the poll should be open, in seconds.
                    If provided, media_ids cannot be used, and poll[options] must be provided.
                format: int64
                type: integer
            expires_in:
                description: |-
                    Duration the poll should be open, in seconds.
                    If provided, media_ids cannot be used, and poll[options] must be provided.
                x-go-name: ExpiresInI
            hide_totals:
                description: Hide vote counts until the poll ends.
                type: boolean
                x-go-name: HideTotals
            multiple:
                description: Allow multiple choices on this poll.
                type: boolean
                x-go-name: Multiple
            options:
                description: |-
                    Array of possible answers.
                    If provided, media_ids cannot be used, and poll[expires_in] must be provided.
                    name: poll[options]
                items:
                    type: string
                type: array
                x-go-name: Options
        title: PollRequest models a request to create a poll.
        type: object
        x-go-name: PollRequest
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    report:
        properties:
            action_taken:
                description: Whether an action has been taken by an admin in response to this report.
                example: false
                type: boolean
                x-go-name: ActionTaken
            action_taken_at:
                description: |-
                    If an action was taken, at what time was this done? (ISO 8601 Datetime)
                    Will be null if not set / no action yet taken.
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: ActionTakenAt
            action_taken_comment:
                description: |-
                    If an action was taken, what comment was made by the admin on the taken action?
                    Will be null if not set / no action yet taken.
                example: Account was suspended.
                type: string
                x-go-name: ActionTakenComment
            category:
                description: Under what category was this report created?
                example: spam
                type: string
                x-go-name: Category
            comment:
                description: |-
                    Comment submitted when the report was created.
                    Will be empty if no comment was submitted.
                example: This person has been harassing me.
                type: string
                x-go-name: Comment
            created_at:
                description: The date when this report was created (ISO 8601 Datetime).
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            forwarded:
                description: Bool to indicate that report should be federated to remote instance.
                example: true
                type: boolean
                x-go-name: Forwarded
            id:
                description: ID of the report.
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: ID
            rule_ids:
                description: |-
                    Array of rule IDs that were submitted along with this report.
                    Will be empty if no rule IDs were submitted.
                example:
                    - 01GPBN5YDY6JKBWE44H7YQBDCQ
                    - 01GPBN65PDWSBPWVDD0SQCFFY3
                items:
                    type: string
                type: array
                x-go-name: RuleIDs
            status_ids:
                description: |-
                    Array of IDs of statuses that were submitted along with this report.
                    Will be empty if no status IDs were submitted.
                example:
                    - 01GPBN5YDY6JKBWE44H7YQBDCQ
                    - 01GPBN65PDWSBPWVDD0SQCFFY3
                items:
                    type: string
                type: array
                x-go-name: StatusIDs
            target_account:
                $ref: '#/definitions/account'
        title: Report models a moderation report submitted to the instance, either via the client API or via the federated API.
        type: object
        x-go-name: Report
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    searchResult:
        properties:
            accounts:
                items:
                    $ref: '#/definitions/account'
                type: array
                x-go-name: Accounts
            hashtags:
                description: Slice of strings if api v1, slice of tags if api v2.
                items: {}
                type: array
                x-go-name: Hashtags
            statuses:
                items:
                    $ref: '#/definitions/status'
                type: array
                x-go-name: Statuses
        title: SearchResult models a search result.
        type: object
        x-go-name: SearchResult
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    status:
        properties:
            account:
                $ref: '#/definitions/account'
            application:
                $ref: '#/definitions/application'
            bookmarked:
                description: This status has been bookmarked by the account viewing it.
                type: boolean
                x-go-name: Bookmarked
            card:
                $ref: '#/definitions/card'
            content:
                description: The content of this status. Should be HTML, but might also be plaintext in some cases.
                example: <p>Hey this is a status!</p>
                type: string
                x-go-name: Content
            created_at:
                description: The date when this status was created (ISO 8601 Datetime).
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            emojis:
                description: Custom emoji to be used when rendering status content.
                items:
                    $ref: '#/definitions/emoji'
                type: array
                x-go-name: Emojis
            favourited:
                description: This status has been favourited by the account viewing it.
                type: boolean
                x-go-name: Favourited
            favourites_count:
                description: Number of favourites/likes this status has received, according to our instance.
                format: int64
                type: integer
                x-go-name: FavouritesCount
            id:
                description: ID of the status.
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: ID
            in_reply_to_account_id:
                description: ID of the account being replied to.
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: InReplyToAccountID
            in_reply_to_id:
                description: ID of the status being replied to.
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: InReplyToID
            language:
                description: |-
                    Primary language of this status (ISO 639 Part 1 two-letter language code).
                    Will be null if language is not known.
                example: en
                type: string
                x-go-name: Language
            media_attachments:
                description: Media that is attached to this status.
                items:
                    $ref: '#/definitions/attachment'
                type: array
                x-go-name: MediaAttachments
            mentions:
                description: Mentions of users within the status content.
                items:
                    $ref: '#/definitions/Mention'
                type: array
                x-go-name: Mentions
            muted:
                description: Replies to this status have been muted by the account viewing it.
                type: boolean
                x-go-name: Muted
            pinned:
                description: This status has been pinned by the account viewing it (only relevant for your own statuses).
                type: boolean
                x-go-name: Pinned
            poll:
                $ref: '#/definitions/poll'
            reblog:
                $ref: '#/definitions/statusReblogged'
            reblogged:
                description: This status has been boosted/reblogged by the account viewing it.
                type: boolean
                x-go-name: Reblogged
            reblogs_count:
                description: Number of times this status has been boosted/reblogged, according to our instance.
                format: int64
                type: integer
                x-go-name: ReblogsCount
            replies_count:
                description: Number of replies to this status, according to our instance.
                format: int64
                type: integer
                x-go-name: RepliesCount
            sensitive:
                description: Status contains sensitive content.
                example: false
                type: boolean
                x-go-name: Sensitive
            spoiler_text:
                description: Subject, summary, or content warning for the status.
                example: warning nsfw
                type: string
                x-go-name: SpoilerText
            tags:
                description: Hashtags used within the status content.
                items:
                    $ref: '#/definitions/tag'
                type: array
                x-go-name: Tags
            text:
                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.
                type: string
                x-go-name: Text
            uri:
                description: ActivityPub URI of the status. Equivalent to the status's activitypub ID.
                example: https://example.org/users/some_user/statuses/01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: URI
            url:
                description: The status's publicly available web URL. This link will only work if the visibility of the status is 'public'.
                example: https://example.org/@some_user/statuses/01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: URL
            visibility:
                description: Visibility of this status.
                example: unlisted
                type: string
                x-go-name: Visibility
        title: Status models a status or post.
        type: object
        x-go-name: Status
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    statusContext:
        properties:
            ancestors:
                description: Parents in the thread.
                items:
                    $ref: '#/definitions/status'
                type: array
                x-go-name: Ancestors
            descendants:
                description: Children in the thread.
                items:
                    $ref: '#/definitions/status'
                type: array
                x-go-name: Descendants
        title: Context models the tree around a given status.
        type: object
        x-go-name: Context
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    statusCreateRequest:
        properties:
            content_type:
                description: |-
                    Content type to use when parsing this status.
                    in: formData
                type: string
                x-go-name: ContentType
            in_reply_to_id:
                description: |-
                    ID of the status being replied to, if status is a reply.
                    in: formData
                type: string
                x-go-name: InReplyToID
            language:
                description: |-
                    ISO 639 language code for this status.
                    in: formData
                type: string
                x-go-name: Language
            media_ids:
                description: |-
                    Array of Attachment ids to be attached as media.
                    If provided, status becomes optional, and poll cannot be used.

                    If the status is being submitted as a form, the key is 'media_ids[]',
                    but if it's json or xml, the key is 'media_ids'.

                    in: formData
                items:
                    type: string
                type: array
                x-go-name: MediaIDs
            poll:
                $ref: '#/definitions/pollRequest'
            scheduled_at:
                description: |-
                    ISO 8601 Datetime at which to schedule a status.
                    Providing this parameter will cause ScheduledStatus to be returned instead of Status.
                    Must be at least 5 minutes in the future.
                    in: formData
                type: string
                x-go-name: ScheduledAt
            sensitive:
                description: |-
                    Status and attached media should be marked as sensitive.
                    in: formData
                type: boolean
                x-go-name: Sensitive
            spoiler_text:
                description: |-
                    Text to be shown as a warning or subject before the actual content.
                    Statuses are generally collapsed behind this field.
                    in: formData
                type: string
                x-go-name: SpoilerText
            status:
                description: |-
                    Text content of the status.
                    If media_ids is provided, this becomes optional.
                    Attaching a poll is optional while status is provided.
                    in: formData
                type: string
                x-go-name: Status
            visibility:
                description: |-
                    Visibility of the posted status.
                    in: formData
                type: string
                x-go-name: Visibility
        title: StatusCreateRequest models status creation parameters.
        type: object
        x-go-name: StatusCreateRequest
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    statusReblogged:
        properties:
            account:
                $ref: '#/definitions/account'
            application:
                $ref: '#/definitions/application'
            bookmarked:
                description: This status has been bookmarked by the account viewing it.
                type: boolean
                x-go-name: Bookmarked
            card:
                $ref: '#/definitions/card'
            content:
                description: The content of this status. Should be HTML, but might also be plaintext in some cases.
                example: <p>Hey this is a status!</p>
                type: string
                x-go-name: Content
            created_at:
                description: The date when this status was created (ISO 8601 Datetime).
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            emojis:
                description: Custom emoji to be used when rendering status content.
                items:
                    $ref: '#/definitions/emoji'
                type: array
                x-go-name: Emojis
            favourited:
                description: This status has been favourited by the account viewing it.
                type: boolean
                x-go-name: Favourited
            favourites_count:
                description: Number of favourites/likes this status has received, according to our instance.
                format: int64
                type: integer
                x-go-name: FavouritesCount
            id:
                description: ID of the status.
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: ID
            in_reply_to_account_id:
                description: ID of the account being replied to.
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: InReplyToAccountID
            in_reply_to_id:
                description: ID of the status being replied to.
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: InReplyToID
            language:
                description: |-
                    Primary language of this status (ISO 639 Part 1 two-letter language code).
                    Will be null if language is not known.
                example: en
                type: string
                x-go-name: Language
            media_attachments:
                description: Media that is attached to this status.
                items:
                    $ref: '#/definitions/attachment'
                type: array
                x-go-name: MediaAttachments
            mentions:
                description: Mentions of users within the status content.
                items:
                    $ref: '#/definitions/Mention'
                type: array
                x-go-name: Mentions
            muted:
                description: Replies to this status have been muted by the account viewing it.
                type: boolean
                x-go-name: Muted
            pinned:
                description: This status has been pinned by the account viewing it (only relevant for your own statuses).
                type: boolean
                x-go-name: Pinned
            poll:
                $ref: '#/definitions/poll'
            reblog:
                $ref: '#/definitions/statusReblogged'
            reblogged:
                description: This status has been boosted/reblogged by the account viewing it.
                type: boolean
                x-go-name: Reblogged
            reblogs_count:
                description: Number of times this status has been boosted/reblogged, according to our instance.
                format: int64
                type: integer
                x-go-name: ReblogsCount
            replies_count:
                description: Number of replies to this status, according to our instance.
                format: int64
                type: integer
                x-go-name: RepliesCount
            sensitive:
                description: Status contains sensitive content.
                example: false
                type: boolean
                x-go-name: Sensitive
            spoiler_text:
                description: Subject, summary, or content warning for the status.
                example: warning nsfw
                type: string
                x-go-name: SpoilerText
            tags:
                description: Hashtags used within the status content.
                items:
                    $ref: '#/definitions/tag'
                type: array
                x-go-name: Tags
            text:
                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.
                type: string
                x-go-name: Text
            uri:
                description: ActivityPub URI of the status. Equivalent to the status's activitypub ID.
                example: https://example.org/users/some_user/statuses/01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: URI
            url:
                description: The status's publicly available web URL. This link will only work if the visibility of the status is 'public'.
                example: https://example.org/@some_user/statuses/01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: URL
            visibility:
                description: Visibility of this status.
                example: unlisted
                type: string
                x-go-name: Visibility
        title: StatusReblogged represents a reblogged status.
        type: object
        x-go-name: StatusReblogged
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    swaggerCollection:
        properties:
            '@context':
                description: |-
                    ActivityStreams JSON-LD context.
                    A string or an array of strings, or more
                    complex nested items.
                example: https://www.w3.org/ns/activitystreams
                x-go-name: Context
            first:
                $ref: '#/definitions/swaggerCollectionPage'
            id:
                description: ActivityStreams ID.
                example: https://example.org/users/some_user/statuses/106717595988259568/replies
                type: string
                x-go-name: ID
            last:
                $ref: '#/definitions/swaggerCollectionPage'
            type:
                description: ActivityStreams type.
                example: Collection
                type: string
                x-go-name: Type
        title: SwaggerCollection represents an ActivityPub Collection.
        type: object
        x-go-name: SwaggerCollection
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/activitypub/users
    swaggerCollectionPage:
        properties:
            id:
                description: ActivityStreams ID.
                example: https://example.org/users/some_user/statuses/106717595988259568/replies?page=true
                type: string
                x-go-name: ID
            items:
                description: Items on this page.
                example:
                    - https://example.org/users/some_other_user/statuses/086417595981111564
                    - https://another.example.com/users/another_user/statuses/01FCN8XDV3YG7B4R42QA6YQZ9R
                items:
                    type: string
                type: array
                x-go-name: Items
            next:
                description: Link to the next page.
                example: https://example.org/users/some_user/statuses/106717595988259568/replies?only_other_accounts=true&page=true
                type: string
                x-go-name: Next
            partOf:
                description: Collection this page belongs to.
                example: https://example.org/users/some_user/statuses/106717595988259568/replies
                type: string
                x-go-name: PartOf
            type:
                description: ActivityStreams type.
                example: CollectionPage
                type: string
                x-go-name: Type
        title: SwaggerCollectionPage represents one page of a collection.
        type: object
        x-go-name: SwaggerCollectionPage
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/activitypub/users
    swaggerFeaturedCollection:
        properties:
            '@context':
                description: |-
                    ActivityStreams JSON-LD context.
                    A string or an array of strings, or more
                    complex nested items.
                example: https://www.w3.org/ns/activitystreams
                x-go-name: Context
            TotalItems:
                description: Number of items in this collection.
                example: 2
                format: int64
                type: integer
            id:
                description: ActivityStreams ID.
                example: https://example.org/users/some_user/collections/featured
                type: string
                x-go-name: ID
            items:
                description: List of status URIs.
                example: '[''https://example.org/users/some_user/statuses/01GSZ0F7Q8SJKNRF777GJD271R'', ''https://example.org/users/some_user/statuses/01GSZ0G012CBQ7TEKX689S3QRE'']'
                items:
                    type: string
                type: array
                x-go-name: Items
            type:
                description: ActivityStreams type.
                example: OrderedCollection
                type: string
                x-go-name: Type
        title: SwaggerFeaturedCollection represents an ActivityPub OrderedCollection.
        type: object
        x-go-name: SwaggerFeaturedCollection
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/activitypub/users
    tag:
        properties:
            history:
                description: |-
                    History of this hashtag's usage.
                    Currently just a stub, if provided will always be an empty array.
                example: []
                items: {}
                type: array
                x-go-name: History
            name:
                description: 'The value of the hashtag after the # sign.'
                example: helloworld
                type: string
                x-go-name: Name
            url:
                description: Web link to the hashtag.
                example: https://example.org/tags/helloworld
                type: string
                x-go-name: URL
        title: Tag represents a hashtag used within the content of a status.
        type: object
        x-go-name: Tag
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    updateField:
        description: By default, max 6 fields and 255 characters per property/value.
        properties:
            name:
                description: Name of the field
                type: string
                x-go-name: Name
            value:
                description: Value of the field
                type: string
                x-go-name: Value
        title: UpdateField is to be used specifically in an UpdateCredentialsRequest.
        type: object
        x-go-name: UpdateField
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    updateSource:
        properties:
            language:
                description: Default language to use for authored statuses. (ISO 6391)
                type: string
                x-go-name: Language
            privacy:
                description: Default post privacy for authored statuses.
                type: string
                x-go-name: Privacy
            sensitive:
                description: Mark authored statuses as sensitive by default.
                type: boolean
                x-go-name: Sensitive
            status_content_type:
                description: Default format for authored statuses (text/plain or text/markdown).
                type: string
                x-go-name: StatusContentType
        title: UpdateSource is to be used specifically in an UpdateCredentialsRequest.
        type: object
        x-go-name: UpdateSource
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
    wellKnownResponse:
        description: See https://webfinger.net/
        properties:
            aliases:
                items:
                    type: string
                type: array
                x-go-name: Aliases
            links:
                items:
                    $ref: '#/definitions/Link'
                type: array
                x-go-name: Links
            subject:
                type: string
                x-go-name: Subject
        title: |-
            WellKnownResponse represents the response to either a webfinger request for an 'acct' resource, or a request to nodeinfo.
            For example, it would be returned from https://example.org/.well-known/webfinger?resource=acct:some_username@example.org
        type: object
        x-go-name: WellKnownResponse
        x-go-package: github.com/superseriousbusiness/gotosocial/internal/api/model
host: example.org
info:
    contact:
        email: admin@gotosocial.org
        name: GoToSocial Authors
    license:
        name: AGPL3
        url: https://www.gnu.org/licenses/agpl-3.0.en.html
    title: GoToSocial Swagger documentation.
    version: REPLACE_ME
paths:
    /.well-known/host-meta:
        get:
            description: 'See: https://www.rfc-editor.org/rfc/rfc6415.html'
            operationId: hostMetaGet
            produces:
                - application/xrd+xml"
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/hostmeta'
            summary: Returns a compliant hostmeta response to web host metadata queries.
            tags:
                - .well-known
    /.well-known/nodeinfo:
        get:
            description: |-
                eg. `{"links":[{"rel":"http://nodeinfo.diaspora.software/ns/schema/2.0","href":"http://example.org/nodeinfo/2.0"}]}`
                See: https://nodeinfo.diaspora.software/protocol.html
            operationId: nodeInfoWellKnownGet
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/wellKnownResponse'
            summary: Returns a well-known response which redirects callers to `/nodeinfo/2.0`.
            tags:
                - .well-known
    /.well-known/webfinger:
        get:
            description: |-
                For example, a GET to `https://goblin.technology/.well-known/webfinger?resource=acct:tobi@goblin.technology` would return:

                ```

                {"subject":"acct:tobi@goblin.technology","aliases":["https://goblin.technology/users/tobi","https://goblin.technology/@tobi"],"links":[{"rel":"http://webfinger.net/rel/profile-page","type":"text/html","href":"https://goblin.technology/@tobi"},{"rel":"self","type":"application/activity+json","href":"https://goblin.technology/users/tobi"}]}

                ```

                See: https://webfinger.net/
            operationId: webfingerGet
            produces:
                - application/jrd+json
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/wellKnownResponse'
            summary: Handles webfinger account lookup requests.
            tags:
                - .well-known
    /api/{api_version}/media:
        post:
            consumes:
                - multipart/form-data
            operationId: mediaCreate
            parameters:
                - description: Version of the API to use. Must be either `v1` or `v2`.
                  in: path
                  name: api_version
                  required: true
                  type: string
                - description: Image or media description to use as alt-text on the attachment. This is very useful for users of screenreaders! May or may not be required, depending on your instance settings.
                  in: formData
                  name: description
                  type: string
                - default: 0,0
                  description: 'Focus of the media file. If present, it should be in the form of two comma-separated floats between -1 and 1. For example: `-0.5,0.25`.'
                  in: formData
                  name: focus
                  type: string
                - description: The media attachment to upload.
                  in: formData
                  name: file
                  required: true
                  type: file
            produces:
                - application/json
            responses:
                "200":
                    description: The newly-created media attachment.
                    schema:
                        $ref: '#/definitions/attachment'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "422":
                    description: unprocessable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:media
            summary: Upload a new media attachment.
            tags:
                - media
    /api/{api_version}/search:
        get:
            description: If statuses are in the result, they will be returned in descending chronological order (newest first), with sequential IDs (bigger = newer).
            operationId: searchGet
            parameters:
                - description: Version of the API to use. Must be either `v1` or `v2`. If v1 is used, Hashtag results will be a slice of strings. If v2 is used, Hashtag results will be a slice of apimodel tags.
                  in: path
                  name: api_version
                  required: true
                  type: string
                - description: Return only items *OLDER* than the given max ID. The item with the specified ID will not be included in the response. Currently only used if 'type' is set to a specific type.
                  in: query
                  name: max_id
                  type: string
                - description: Return only items *immediately newer* than the given min ID. The item with the specified ID will not be included in the response. Currently only used if 'type' is set to a specific type.
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: Number of each type of item to return.
                  in: query
                  maximum: 40
                  minimum: 1
                  name: limit
                  type: integer
                - default: 0
                  description: Page number of results to return (starts at 0). This parameter is currently not used, page by selecting a specific query type and using maxID and minID instead.
                  in: query
                  maximum: 10
                  minimum: 0
                  name: offset
                  type: integer
                - description: |-
                    Query string to search for. This can be in the following forms:
                    - `@[username]` -- search for an account with the given username on any domain. Can return multiple results.
                    - @[username]@[domain]` -- search for a remote account with exact username and domain. Will only ever return 1 result at most.
                    - `https://example.org/some/arbitrary/url` -- search for an account OR a status with the given URL. Will only ever return 1 result at most.
                    - `#[hashtag_name]` -- search for a hashtag with the given hashtag name, or starting with the given hashtag name. Case insensitive. Can return multiple results.
                    - any arbitrary string -- search for accounts or statuses containing the given string. Can return multiple results.
                  in: query
                  name: q
                  required: true
                  type: string
                - description: |-
                    Type of item to return. One of:
                    - `` -- empty string; return any/all results.
                    - `accounts` -- return only account(s).
                    - `statuses` -- return only status(es).
                    - `hashtags` -- return only hashtag(s).
                    If `type` is specified, paging can be performed using max_id and min_id parameters.
                    If `type` is not specified, see the `offset` parameter for paging.
                  in: query
                  name: type
                  type: string
                - default: false
                  description: If searching query is for `@[username]@[domain]`, or a URL, allow the GoToSocial instance to resolve the search by making calls to remote instances (webfinger, ActivityPub, etc).
                  in: query
                  name: resolve
                  type: boolean
                - default: false
                  description: If search type includes accounts, and search query is an arbitrary string, show only accounts that the requesting account follows. If this is set to `true`, then the GoToSocial instance will enhance the search by also searching within account notes, not just in usernames and display names.
                  in: query
                  name: following
                  type: boolean
                - default: false
                  description: If searching for hashtags, exclude those not yet approved by instance admin. Currently this parameter is unused.
                  in: query
                  name: exclude_unreviewed
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: Results of the search.
                    schema:
                        $ref: '#/definitions/searchResult'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:search
            summary: Search for statuses, accounts, or hashtags, on this instance or elsewhere.
            tags:
                - search
    /api/v1/accounts:
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                The parameters can also be given in the body of the request, as JSON, if the content-type is set to 'application/json'.
                The parameters can also be given in the body of the request, as XML, if the content-type is set to 'application/xml'.
            operationId: accountCreate
            parameters:
                - description: Text that will be reviewed by moderators if registrations require manual approval.
                  in: query
                  name: reason
                  type: string
                  x-go-name: Reason
                - description: The desired username for the account.
                  in: query
                  name: username
                  type: string
                  x-go-name: Username
                - description: The email address to be used for login.
                  in: query
                  name: email
                  type: string
                  x-go-name: Email
                - description: The password to be used for login. This will be hashed before storage.
                  in: query
                  name: password
                  type: string
                  x-go-name: Password
                - description: The user agrees to the terms, conditions, and policies of the instance.
                  in: query
                  name: agreement
                  type: boolean
                  x-go-name: Agreement
                - description: The language of the confirmation email that will be sent.
                  in: query
                  name: locale
                  type: string
                  x-go-name: Locale
            produces:
                - application/json
            responses:
                "200":
                    description: An OAuth2 access token for the newly-created account.
                    schema:
                        $ref: '#/definitions/oauthToken'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Application:
                    - write:accounts
            summary: Create a new account using an application token.
            tags:
                - accounts
    /api/v1/accounts/{id}:
        get:
            operationId: accountGet
            parameters:
                - description: The id of the requested account.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The requested account.
                    schema:
                        $ref: '#/definitions/account'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: Get information about an account with the given ID.
            tags:
                - accounts
    /api/v1/accounts/{id}/block:
        post:
            operationId: accountBlock
            parameters:
                - description: The id of the account to block.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: Your relationship to the account.
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:blocks
            summary: Block account with id.
            tags:
                - accounts
    /api/v1/accounts/{id}/follow:
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                The parameters can also be given in the body of the request, as JSON, if the content-type is set to 'application/json'.
                The parameters can also be given in the body of the request, as XML, if the content-type is set to 'application/xml'.

                If you already follow (request) the given account, then the follow (request) will be updated instead using the
                `reblogs` and `notify` parameters.
            operationId: accountFollow
            parameters:
                - description: ID of the account to follow.
                  in: path
                  name: id
                  required: true
                  type: string
                - default: true
                  description: Show reblogs from this account.
                  in: formData
                  name: reblogs
                  type: boolean
                - default: false
                  description: Notify when this account posts.
                  in: formData
                  name: notify
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: Your relationship to this account.
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:follows
            summary: Follow account with id.
            tags:
                - accounts
    /api/v1/accounts/{id}/followers:
        get:
            description: |-
                The next and previous queries can be parsed from the returned Link header.
                Example:

                ```
                <https://example.org/api/v1/accounts/0657WMDEC3KQDTD6NZ4XJZBK4M/followers?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/accounts/0657WMDEC3KQDTD6NZ4XJZBK4M/followers?limit=80&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````
            operationId: accountFollowers
            parameters:
                - description: Account ID.
                  in: path
                  name: id
                  required: true
                  type: string
                - description: 'Return only follower accounts *OLDER* than the given max ID. The follower account with the specified ID will not be included in the response. NOTE: the ID is of the internal follow, NOT any of the returned accounts.'
                  in: query
                  name: max_id
                  type: string
                - description: 'Return only follower accounts *NEWER* than the given since ID. The follower account with the specified ID will not be included in the response. NOTE: the ID is of the internal follow, NOT any of the returned accounts.'
                  in: query
                  name: since_id
                  type: string
                - description: 'Return only follower accounts *IMMEDIATELY NEWER* than the given min ID. The follower account with the specified ID will not be included in the response. NOTE: the ID is of the internal follow, NOT any of the returned accounts.'
                  in: query
                  name: min_id
                  type: string
                - default: 40
                  description: Number of follower accounts to return.
                  in: query
                  maximum: 80
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: Array of accounts that follow this account.
                    schema:
                        items:
                            $ref: '#/definitions/account'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: See followers of account with given id.
            tags:
                - accounts
    /api/v1/accounts/{id}/following:
        get:
            description: |-
                The next and previous queries can be parsed from the returned Link header.
                Example:

                ```
                <https://example.org/api/v1/accounts/0657WMDEC3KQDTD6NZ4XJZBK4M/following?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/accounts/0657WMDEC3KQDTD6NZ4XJZBK4M/following?limit=80&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````
            operationId: accountFollowing
            parameters:
                - description: Account ID.
                  in: path
                  name: id
                  required: true
                  type: string
                - description: 'Return only following accounts *OLDER* than the given max ID. The following account with the specified ID will not be included in the response. NOTE: the ID is of the internal follow, NOT any of the returned accounts.'
                  in: query
                  name: max_id
                  type: string
                - description: 'Return only following accounts *NEWER* than the given since ID. The following account with the specified ID will not be included in the response. NOTE: the ID is of the internal follow, NOT any of the returned accounts.'
                  in: query
                  name: since_id
                  type: string
                - description: 'Return only following accounts *IMMEDIATELY NEWER* than the given min ID. The following account with the specified ID will not be included in the response. NOTE: the ID is of the internal follow, NOT any of the returned accounts.'
                  in: query
                  name: min_id
                  type: string
                - default: 40
                  description: Number of following accounts to return.
                  in: query
                  maximum: 80
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: Array of accounts that are followed by this account.
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: See accounts followed by given account id.
            tags:
                - accounts
    /api/v1/accounts/{id}/lists:
        get:
            operationId: accountLists
            parameters:
                - description: Account ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: Array of all lists containing this account.
                    schema:
                        items:
                            $ref: '#/definitions/list'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:lists
            summary: See all lists of yours that contain requested account.
            tags:
                - accounts
    /api/v1/accounts/{id}/note:
        post:
            consumes:
                - multipart/form-data
            operationId: accountNote
            parameters:
                - description: The id of the account for which to set a note.
                  in: path
                  name: id
                  required: true
                  type: string
                - default: ""
                  description: The text of the note. Omit this parameter or send an empty string to clear the note.
                  in: formData
                  name: comment
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: Your relationship to the account.
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: Set a private note for an account with the given id.
            tags:
                - accounts
    /api/v1/accounts/{id}/statuses:
        get:
            description: The statuses will be returned in descending chronological order (newest first), with sequential IDs (bigger = newer).
            operationId: accountStatuses
            parameters:
                - description: Account ID.
                  in: path
                  name: id
                  required: true
                  type: string
                - default: 30
                  description: Number of statuses to return.
                  in: query
                  name: limit
                  type: integer
                - default: false
                  description: Exclude statuses that are a reply to another status.
                  in: query
                  name: exclude_replies
                  type: boolean
                - default: false
                  description: Exclude statuses that are a reblog/boost of another status.
                  in: query
                  name: exclude_reblogs
                  type: boolean
                - description: Return only statuses *OLDER* than the given max status ID. The status with the specified ID will not be included in the response.
                  in: query
                  name: max_id
                  type: string
                - description: Return only statuses *NEWER* than the given min status ID. The status with the specified ID will not be included in the response.
                  in: query
                  name: min_id
                  type: string
                - default: false
                  description: Show only pinned statuses. In other words, exclude statuses that are not pinned to the given account ID.
                  in: query
                  name: pinned
                  type: boolean
                - default: false
                  description: Show only statuses with media attachments.
                  in: query
                  name: only_media
                  type: boolean
                - default: false
                  description: Show only statuses with a privacy setting of 'public'.
                  in: query
                  name: only_public
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: Array of statuses.
                    schema:
                        items:
                            $ref: '#/definitions/status'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: See statuses posted by the requested account.
            tags:
                - accounts
    /api/v1/accounts/{id}/unblock:
        post:
            operationId: accountUnblock
            parameters:
                - description: The id of the account to unblock.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: Your relationship to this account.
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:blocks
            summary: Unblock account with ID.
            tags:
                - accounts
    /api/v1/accounts/{id}/unfollow:
        post:
            operationId: accountUnfollow
            parameters:
                - description: The id of the account to unfollow.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: Your relationship to this account.
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:follows
            summary: Unfollow account with id.
            tags:
                - accounts
    /api/v1/accounts/alias:
        post:
            consumes:
                - multipart/form-data
            description: |-
                This is useful when you want to move from another account this this account.

                In such cases, you should set the alsoKnownAs of this account to the URI of
                the account you want to move from.
            operationId: accountAlias
            parameters:
                - description: |-
                    ActivityPub URI/IDs of target accounts to which this account is being aliased. Eg., `["https://example.org/users/some_account"]`.
                    Use an empty array to unset alsoKnownAs, clearing the aliases.
                  in: formData
                  name: also_known_as_uris
                  required: true
                  type: string
            responses:
                "200":
                    description: The newly updated account.
                    schema:
                        $ref: '#/definitions/account'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "422":
                    description: Unprocessable. Check the response body for more details.
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: Alias your account to another account by setting alsoKnownAs to the given URI.
            tags:
                - accounts
    /api/v1/accounts/delete:
        post:
            consumes:
                - multipart/form-data
            operationId: accountDelete
            parameters:
                - description: Password of the account user, for confirmation.
                  in: formData
                  name: password
                  required: true
                  type: string
            responses:
                "202":
                    description: The account deletion has been accepted and the account will be deleted.
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: Delete your account.
            tags:
                - accounts
    /api/v1/accounts/lookup:
        get:
            operationId: accountLookupGet
            parameters:
                - description: The username or Webfinger address to lookup.
                  in: query
                  name: acct
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: Result of the lookup.
                    schema:
                        $ref: '#/definitions/account'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: Quickly lookup a username to see if it is available, skipping WebFinger resolution.
            tags:
                - accounts
    /api/v1/accounts/move:
        post:
            consumes:
                - multipart/form-data
            operationId: accountMove
            parameters:
                - description: Password of the account user, for confirmation.
                  in: formData
                  name: password
                  required: true
                  type: string
                - description: ActivityPub URI/ID of the target account. Eg., `https://example.org/users/some_account`. The target account must be alsoKnownAs the requesting account in order for the move to be successful.
                  in: formData
                  name: moved_to_uri
                  required: true
                  type: string
            responses:
                "202":
                    description: The account move has been accepted and the account will be moved.
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "422":
                    description: Unprocessable. Check the response body for more details.
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: Move your account to another account.
            tags:
                - accounts
    /api/v1/accounts/relationships:
        get:
            operationId: accountRelationships
            parameters:
                - description: Account IDs.
                  in: query
                  items:
                    type: string
                  name: id
                  required: true
                  type: array
            produces:
                - application/json
            responses:
                "200":
                    description: Array of account relationships.
                    schema:
                        items:
                            $ref: '#/definitions/accountRelationship'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: See your account's relationships with the given account IDs.
            tags:
                - accounts
    /api/v1/accounts/search:
        get:
            operationId: accountSearchGet
            parameters:
                - default: 40
                  description: Number of results to try to return.
                  in: query
                  maximum: 80
                  minimum: 1
                  name: limit
                  type: integer
                - default: 0
                  description: Page number of results to return (starts at 0). This parameter is currently not used, offsets over 0 will always return 0 results.
                  in: query
                  maximum: 10
                  minimum: 0
                  name: offset
                  type: integer
                - description: |-
                    Query string to search for. This can be in the following forms:
                    - `@[username]` -- search for an account with the given username on any domain. Can return multiple results.
                    - `@[username]@[domain]` -- search for a remote account with exact username and domain. Will only ever return 1 result at most.
                    - any arbitrary string -- search for accounts containing the given string in their username or display name. Can return multiple results.
                  in: query
                  name: q
                  required: true
                  type: string
                - default: false
                  description: If query is for `@[username]@[domain]`, or a URL, allow the GoToSocial instance to resolve the search by making calls to remote instances (webfinger, ActivityPub, etc).
                  in: query
                  name: resolve
                  type: boolean
                - default: false
                  description: Show only accounts that the requesting account follows. If this is set to `true`, then the GoToSocial instance will enhance the search by also searching within account notes, not just in usernames and display names.
                  in: query
                  name: following
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: Results of the search.
                    schema:
                        items:
                            $ref: '#/definitions/account'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: Search for accounts by username and/or display name.
            tags:
                - accounts
    /api/v1/accounts/update_credentials:
        patch:
            consumes:
                - multipart/form-data
                - application/x-www-form-urlencoded
                - application/json
            operationId: accountUpdate
            parameters:
                - description: Account should be made discoverable and shown in the profile directory (if enabled).
                  in: formData
                  name: discoverable
                  type: boolean
                - description: Account is flagged as a bot.
                  in: formData
                  name: bot
                  type: boolean
                - allowEmptyValue: true
                  description: The display name to use for the account.
                  in: formData
                  name: display_name
                  type: string
                - allowEmptyValue: true
                  description: Bio/description of this account.
                  in: formData
                  name: note
                  type: string
                - description: Avatar of the user.
                  in: formData
                  name: avatar
                  type: file
                - description: Header of the user.
                  in: formData
                  name: header
                  type: file
                - description: Require manual approval of follow requests.
                  in: formData
                  name: locked
                  type: boolean
                - description: Default post privacy for authored statuses.
                  in: formData
                  name: source[privacy]
                  type: string
                - description: Mark authored statuses as sensitive by default.
                  in: formData
                  name: source[sensitive]
                  type: boolean
                - description: Default language to use for authored statuses (ISO 6391).
                  in: formData
                  name: source[language]
                  type: string
                - description: Default content type to use for authored statuses (text/plain or text/markdown).
                  in: formData
                  name: source[status_content_type]
                  type: string
                - description: Custom CSS to use when rendering this account's profile or statuses. String must be no more than 5,000 characters (~5kb).
                  in: formData
                  name: custom_css
                  type: string
                - description: Enable RSS feed for this account's Public posts at `/[username]/feed.rss`
                  in: formData
                  name: enable_rss
                  type: boolean
                - description: Profile fields to be added to this account's profile
                  in: formData
                  items:
                    type: object
                  name: fields_attributes
                  type: array
            produces:
                - application/json
            responses:
                "200":
                    description: The newly updated account.
                    schema:
                        $ref: '#/definitions/account'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: Update your account.
            tags:
                - accounts
    /api/v1/accounts/verify_credentials:
        get:
            operationId: accountVerify
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/account'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: Verify a token by returning account details pertaining to it.
            tags:
                - accounts
    /api/v1/admin/accounts/{id}/action:
        post:
            consumes:
                - multipart/form-data
            operationId: adminAccountAction
            parameters:
                - description: ID of the account.
                  in: path
                  name: id
                  required: true
                  type: string
                - description: Type of action to be taken, currently only supports `suspend`.
                  in: formData
                  name: type
                  required: true
                  type: string
                - description: Optional text describing why this action was taken.
                  in: formData
                  name: text
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: OK
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "409":
                    description: 'Conflict: There is already an admin action running that conflicts with this action. Check the error message in the response body for more information. This is a temporary error; it should be possible to process this action if you try again in a bit.'
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Perform an admin action on an account.
            tags:
                - admin
    /api/v1/admin/custom_emojis:
        get:
            description: |-
                The next and previous queries can be parsed from the returned Link header.
                Example:

                `<http://localhost:8080/api/v1/admin/custom_emojis?limit=30&max_shortcode_domain=yell@fossbros-anonymous.io&filter=domain:all>; rel="next", <http://localhost:8080/api/v1/admin/custom_emojis?limit=30&min_shortcode_domain=rainbow@&filter=domain:all>; rel="prev"`
            operationId: emojisGet
            parameters:
                - default: domain:all
                  description: |-
                    Comma-separated list of filters to apply to results. Recognized filters are:

                    `domain:[domain]` -- show emojis from the given domain, eg `?filter=domain:example.org` will show emojis from `example.org` only.
                    Instead of giving a specific domain, you can also give either one of the key words `local` or `all` to show either local emojis only (`domain:local`) or show all emojis from all domains (`domain:all`).
                    Note: `domain:*` is equivalent to `domain:all` (including local).
                    If no domain filter is provided, `domain:all` will be assumed.

                    `disabled` -- include emojis that have been disabled.

                    `enabled` -- include emojis that are enabled.

                    `shortcode:[shortcode]` -- show only emojis with the given shortcode, eg `?filter=shortcode:blob_cat_uwu` will show only emojis with the shortcode `blob_cat_uwu` (case sensitive).

                    If neither `disabled` or `enabled` are provided, both disabled and enabled emojis will be shown.

                    If no filter query string is provided, the default `domain:all` will be used, which will show all emojis from all domains.
                  in: query
                  name: filter
                  type: string
                - default: 50
                  description: Number of emojis to return. Less than 1, or not set, means unlimited (all emojis).
                  in: query
                  name: limit
                  type: integer
                - description: |-
                    Return only emojis with `[shortcode]@[domain]` *LOWER* (alphabetically) than given `[shortcode]@[domain]`. For example, if `max_shortcode_domain=beep@example.org`, then returned values might include emojis with `[shortcode]@[domain]`s like `car@example.org`, `debian@aaa.com`, `test@` (local emoji), etc.
                    Emoji with the given `[shortcode]@[domain]` will not be included in the result set.
                  in: query
                  name: max_shortcode_domain
                  type: string
                - description: |-
                    Return only emojis with `[shortcode]@[domain]` *HIGHER* (alphabetically) than given `[shortcode]@[domain]`. For example, if `max_shortcode_domain=beep@example.org`, then returned values might include emojis with `[shortcode]@[domain]`s like `arse@test.com`, `0101_binary@hackers.net`, `bee@` (local emoji), etc.
                    Emoji with the given `[shortcode]@[domain]` will not be included in the result set.
                  in: query
                  name: min_shortcode_domain
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: An array of emojis, arranged alphabetically by shortcode and domain.
                    headers:
                        Link:
                            description: Links to the next and previous queries.
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/adminEmoji'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            summary: View local and remote emojis available to / known by this instance.
            tags:
                - admin
        post:
            consumes:
                - multipart/form-data
            operationId: emojiCreate
            parameters:
                - description: The code to use for the emoji, which will be used by instance denizens to select it. This must be unique on the instance.
                  in: formData
                  name: shortcode
                  pattern: \w{2,30}
                  required: true
                  type: string
                - description: A png or gif image of the emoji. Animated pngs work too! To ensure compatibility with other fedi implementations, emoji size limit is 50kb by default.
                  in: formData
                  name: image
                  required: true
                  type: file
                - description: Category in which to place the new emoji. 64 characters or less. If left blank, emoji will be uncategorized. If a category with the given name doesn't exist yet, it will be created.
                  in: formData
                  name: category
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The newly-created emoji.
                    schema:
                        $ref: '#/definitions/emoji'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "409":
                    description: conflict -- shortcode for this emoji is already in use
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Upload and create a new instance emoji.
            tags:
                - admin
    /api/v1/admin/custom_emojis/{id}:
        delete:
            description: |-
                Emoji with the given ID will no longer be available to use on the instance.

                If you just want to update the emoji image instead, use the `/api/v1/admin/custom_emojis/{id}` PATCH route.

                To disable emojis from **remote** instances, use the `/api/v1/admin/custom_emojis/{id}` PATCH route.
            operationId: emojiDelete
            parameters:
                - description: The id of the emoji.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The deleted emoji will be returned to the caller in case further processing is necessary.
                    schema:
                        $ref: '#/definitions/adminEmoji'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Delete a **local** emoji with the given ID from the instance.
            tags:
                - admin
        get:
            operationId: emojiGet
            parameters:
                - description: The id of the emoji.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: A single emoji.
                    schema:
                        $ref: '#/definitions/adminEmoji'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            summary: Get the admin view of a single emoji.
            tags:
                - admin
        patch:
            consumes:
                - multipart/form-data
            description: |-
                Action performed depends upon the action `type` provided.

                `disable`: disable a REMOTE emoji from being used/displayed on this instance. Does not work for local emojis.

                `copy`: copy a REMOTE emoji to this instance. When doing this action, a shortcode MUST be provided, and it must
                be unique among emojis already present on this instance. A category MAY be provided, and the copied emoji will then
                be put into the provided category.

                `modify`: modify a LOCAL emoji. You can provide a new image for the emoji and/or update the category.

                Local emojis cannot be deleted using this endpoint. To delete a local emoji, check DELETE /api/v1/admin/custom_emojis/{id} instead.
            operationId: emojiUpdate
            parameters:
                - description: The id of the emoji.
                  in: path
                  name: id
                  required: true
                  type: string
                - description: |-
                    Type of action to be taken. One of: (`disable`, `copy`, `modify`).
                    For REMOTE emojis, `copy` or `disable` are supported.
                    For LOCAL emojis, only `modify` is supported.
                  in: formData
                  name: type
                  required: true
                  type: string
                - description: The code to use for the emoji, which will be used by instance denizens to select it. This must be unique on the instance. Works for the `copy` action type only.
                  in: formData
                  name: shortcode
                  pattern: \w{2,30}
                  type: string
                - description: A new png or gif image to use for the emoji. Animated pngs work too! To ensure compatibility with other fedi implementations, emoji size limit is 50kb by default. Works for LOCAL emojis only.
                  in: formData
                  name: image
                  type: file
                - description: Category in which to place the emoji. 64 characters or less. If a category with the given name doesn't exist yet, it will be created.
                  in: formData
                  name: category
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The updated emoji.
                    schema:
                        $ref: '#/definitions/adminEmoji'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Perform admin action on a local or remote emoji known to this instance.
            tags:
                - admin
    /api/v1/admin/custom_emojis/categories:
        get:
            operationId: emojiCategoriesGet
            parameters:
                - description: The id of the emoji.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: Array of existing emoji categories.
                    schema:
                        items:
                            $ref: '#/definitions/adminEmojiCategory'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            summary: Get a list of existing emoji categories.
            tags:
                - admin
    /api/v1/admin/debug/apurl:
        get:
            description: Only enabled / exposed if GoToSocial was built and is running with flag DEBUG=1.
            operationId: debugAPUrl
            parameters:
                - description: The URL / ActivityPub ID to dereference. This should be a full URL, including protocol. Eg., `https://example.org/users/someone`
                  in: query
                  name: url
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/debugAPUrlResponse'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Perform a GET to the specified ActivityPub URL and return detailed debugging information.
            tags:
                - debug
    /api/v1/admin/domain_allows:
        get:
            operationId: domainAllowsGet
            parameters:
                - description: If set to `true`, then each entry in the returned list of domain allows will only consist of the fields `domain` and `public_comment`. This is perfect for when you want to save and share a list of all the domains you have allowed on your instance, so that someone else can easily import them, but you don't want them to see the database IDs of your allows, or private comments etc.
                  in: query
                  name: export
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: All domain allows currently in place.
                    schema:
                        items:
                            $ref: '#/definitions/domainPermission'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: View all domain allows currently in place.
            tags:
                - admin
        post:
            consumes:
                - multipart/form-data
            description: |-
                You have two options when using this endpoint: either you can set `import` to `true` and
                upload a file containing multiple domain allows, JSON-formatted, or you can leave import as
                `false`, and just add one domain allow.

                The format of the json file should be something like: `[{"domain":"example.org"},{"domain":"whatever.com","public_comment":"they smell"}]`
            operationId: domainAllowCreate
            parameters:
                - default: false
                  description: Signal that a list of domain allows is being imported as a file. If set to `true`, then 'domains' must be present as a JSON-formatted file. If set to `false`, then `domains` will be ignored, and `domain` must be present.
                  in: query
                  name: import
                  type: boolean
                - description: JSON-formatted list of domain allows to import. This is only used if `import` is set to `true`.
                  in: formData
                  name: domains
                  type: file
                - description: Single domain to allow. Used only if `import` is not `true`.
                  in: formData
                  name: domain
                  type: string
                - description: Obfuscate the name of the domain when serving it publicly. Eg., `example.org` becomes something like `ex***e.org`. Used only if `import` is not `true`.
                  in: formData
                  name: obfuscate
                  type: boolean
                - description: Public comment about this domain allow. This will be displayed alongside the domain allow if you choose to share allows. Used only if `import` is not `true`.
                  in: formData
                  name: public_comment
                  type: string
                - description: Private comment about this domain allow. Will only be shown to other admins, so this is a useful way of internally keeping track of why a certain domain ended up allowed. Used only if `import` is not `true`.
                  in: formData
                  name: private_comment
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The newly created domain allow, if `import` != `true`. If a list has been imported, then an `array` of newly created domain allows will be returned instead.
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "409":
                    description: 'Conflict: There is already an admin action running that conflicts with this action. Check the error message in the response body for more information. This is a temporary error; it should be possible to process this action if you try again in a bit.'
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Create one or more domain allows, from a string or a file.
            tags:
                - admin
    /api/v1/admin/domain_allows/{id}:
        delete:
            operationId: domainAllowDelete
            parameters:
                - description: The id of the domain allow.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The domain allow that was just deleted.
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "409":
                    description: 'Conflict: There is already an admin action running that conflicts with this action. Check the error message in the response body for more information. This is a temporary error; it should be possible to process this action if you try again in a bit.'
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Delete domain allow with the given ID.
            tags:
                - admin
        get:
            operationId: domainAllowGet
            parameters:
                - description: The id of the domain allow.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The requested domain allow.
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: View domain allow with the given ID.
            tags:
                - admin
    /api/v1/admin/domain_blocks:
        get:
            operationId: domainBlocksGet
            parameters:
                - description: If set to `true`, then each entry in the returned list of domain blocks will only consist of the fields `domain` and `public_comment`. This is perfect for when you want to save and share a list of all the domains you have blocked on your instance, so that someone else can easily import them, but you don't want them to see the database IDs of your blocks, or private comments etc.
                  in: query
                  name: export
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: All domain blocks currently in place.
                    schema:
                        items:
                            $ref: '#/definitions/domainPermission'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: View all domain blocks currently in place.
            tags:
                - admin
        post:
            consumes:
                - multipart/form-data
            description: |-
                You have two options when using this endpoint: either you can set `import` to `true` and
                upload a file containing multiple domain blocks, JSON-formatted, or you can leave import as
                `false`, and just add one domain block.

                The format of the json file should be something like: `[{"domain":"example.org"},{"domain":"whatever.com","public_comment":"they smell"}]`
            operationId: domainBlockCreate
            parameters:
                - default: false
                  description: Signal that a list of domain blocks is being imported as a file. If set to `true`, then 'domains' must be present as a JSON-formatted file. If set to `false`, then `domains` will be ignored, and `domain` must be present.
                  in: query
                  name: import
                  type: boolean
                - description: JSON-formatted list of domain blocks to import. This is only used if `import` is set to `true`.
                  in: formData
                  name: domains
                  type: file
                - description: Single domain to block. Used only if `import` is not `true`.
                  in: formData
                  name: domain
                  type: string
                - description: Obfuscate the name of the domain when serving it publicly. Eg., `example.org` becomes something like `ex***e.org`. Used only if `import` is not `true`.
                  in: formData
                  name: obfuscate
                  type: boolean
                - description: Public comment about this domain block. This will be displayed alongside the domain block if you choose to share blocks. Used only if `import` is not `true`.
                  in: formData
                  name: public_comment
                  type: string
                - description: Private comment about this domain block. Will only be shown to other admins, so this is a useful way of internally keeping track of why a certain domain ended up blocked. Used only if `import` is not `true`.
                  in: formData
                  name: private_comment
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The newly created domain block, if `import` != `true`. If a list has been imported, then an `array` of newly created domain blocks will be returned instead.
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "409":
                    description: 'Conflict: There is already an admin action running that conflicts with this action. Check the error message in the response body for more information. This is a temporary error; it should be possible to process this action if you try again in a bit.'
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Create one or more domain blocks, from a string or a file.
            tags:
                - admin
    /api/v1/admin/domain_blocks/{id}:
        delete:
            operationId: domainBlockDelete
            parameters:
                - description: The id of the domain block.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The domain block that was just deleted.
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "409":
                    description: 'Conflict: There is already an admin action running that conflicts with this action. Check the error message in the response body for more information. This is a temporary error; it should be possible to process this action if you try again in a bit.'
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Delete domain block with the given ID.
            tags:
                - admin
        get:
            operationId: domainBlockGet
            parameters:
                - description: The id of the domain block.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The requested domain block.
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: View domain block with the given ID.
            tags:
                - admin
    /api/v1/admin/domain_keys_expire:
        post:
            consumes:
                - multipart/form-data
            description: |-
                This is useful in cases where the remote domain has had to rotate their keys for whatever
                reason (security issue, data leak, routine safety procedure, etc), and your instance can no
                longer communicate with theirs properly using cached keys. A key marked as expired in this way
                will be lazily refetched next time a request is made to your instance signed by the owner of that
                key, so no further action should be required in order to reestablish communication with that domain.

                This endpoint is explicitly not for rotating your *own* keys, it only works for remote instances.

                Using this endpoint to expire keys for a domain that hasn't rotated all of their keys is not
                harmful and won't break federation, but it is pointless and will cause unnecessary requests to
                be performed.
            operationId: domainKeysExpire
            parameters:
                - description: Domain to expire keys for.
                  example: example.org
                  in: formData
                  name: domain
                  type: string
            produces:
                - application/json
            responses:
                "202":
                    description: Request accepted and will be processed. Check the logs for progress / errors.
                    schema:
                        $ref: '#/definitions/adminActionResponse'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "409":
                    description: 'Conflict: There is already an admin action running that conflicts with this action. Check the error message in the response body for more information. This is a temporary error; it should be possible to process this action if you try again in a bit.'
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Force expiry of cached public keys for all accounts on the given domain stored in your database.
            tags:
                - admin
    /api/v1/admin/email/test:
        post:
            consumes:
                - multipart/form-data
            description: |-
                This can be used to validate an instance's SMTP configuration, and to debug any potential issues.

                If an error is returned by the SMTP connection, this handler will return code 422 to indicate that
                the request could not be processed, and the SMTP error will be returned to the caller.
            operationId: testEmailSend
            parameters:
                - description: The email address that the test email should be sent to.
                  in: formData
                  name: email
                  type: string
            produces:
                - application/json
            responses:
                "202":
                    description: Test email was sent.
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "422":
                    description: An smtp occurred while the email attempt was in progress. Check the returned json for more information. The smtp error will be included, to help you debug communication with the smtp server.
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Send a generic test email to a specified email address.
            tags:
                - admin
    /api/v1/admin/header_allows:
        get:
            operationId: headerFilterAllowsGet
            responses:
                "200":
                    description: All "allow" header filters currently in place.
                    schema:
                        items:
                            $ref: '#/definitions/headerFilter'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Get all "allow" header filters currently in place.
            tags:
                - admin
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                The parameters can also be given in the body of the request, as JSON, if the content-type is set to 'application/json'.
                The parameters can also be given in the body of the request, as XML, if the content-type is set to 'application/xml'.
            operationId: headerFilterAllowCreate
            produces:
                - application/json
            responses:
                "200":
                    description: The newly created "allow" header filter.
                    schema:
                        $ref: '#/definitions/headerFilter'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Create new "allow" HTTP request header filter.
            tags:
                - admin
    /api/v1/admin/header_allows/{id}:
        delete:
            operationId: headerFilterAllowDelete
            parameters:
                - description: Target header filter ID.
                  in: path
                  name: id
                  required: true
                  type: string
            responses:
                "202":
                    description: Accepted
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Delete the "allow" header filter with the given ID.
            tags:
                - admin
        get:
            operationId: headerFilterAllowGet
            parameters:
                - description: Target header filter ID.
                  in: path
                  name: id
                  required: true
                  type: string
            responses:
                "200":
                    description: The requested "allow" header filter.
                    schema:
                        $ref: '#/definitions/headerFilter'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Get "allow" header filter with the given ID.
            tags:
                - admin
    /api/v1/admin/header_blocks:
        get:
            operationId: headerFilterBlocksGet
            responses:
                "200":
                    description: All "block" header filters currently in place.
                    schema:
                        items:
                            $ref: '#/definitions/headerFilter'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Get all "allow" header filters currently in place.
            tags:
                - admin
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                The parameters can also be given in the body of the request, as JSON, if the content-type is set to 'application/json'.
                The parameters can also be given in the body of the request, as XML, if the content-type is set to 'application/xml'.
            operationId: headerFilterBlockCreate
            produces:
                - application/json
            responses:
                "200":
                    description: The newly created "block" header filter.
                    schema:
                        $ref: '#/definitions/headerFilter'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Create new "block" HTTP request header filter.
            tags:
                - admin
    /api/v1/admin/header_blocks/{id}:
        delete:
            operationId: headerFilterBlockDelete
            parameters:
                - description: Target header filter ID.
                  in: path
                  name: id
                  required: true
                  type: string
            responses:
                "202":
                    description: Accepted
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Delete the "block" header filter with the given ID.
            tags:
                - admin
        get:
            operationId: headerFilterBlockGet
            parameters:
                - description: Target header filter ID.
                  in: path
                  name: id
                  required: true
                  type: string
            responses:
                "200":
                    description: The requested "block" header filter.
                    schema:
                        $ref: '#/definitions/headerFilter'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Get "block" header filter with the given ID.
            tags:
                - admin
    /api/v1/admin/instance/rules:
        post:
            consumes:
                - multipart/form-data
            operationId: ruleCreate
            parameters:
                - description: Text body for the instance rule, plaintext.
                  in: formData
                  name: text
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The newly-created instance rule.
                    schema:
                        $ref: '#/definitions/instanceRule'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Create a new instance rule.
            tags:
                - admin
    /api/v1/admin/instance/rules{id}:
        delete:
            consumes:
                - multipart/form-data
            operationId: ruleDelete
            parameters:
                - description: The id of the rule to delete.
                  in: formData
                  name: id
                  required: true
                  type: path
            produces:
                - application/json
            responses:
                "200":
                    description: The deleted instance rule.
                    schema:
                        $ref: '#/definitions/instanceRule'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Delete an existing instance rule.
            tags:
                - admin
        patch:
            consumes:
                - multipart/form-data
            operationId: ruleUpdate
            parameters:
                - description: The id of the rule to update.
                  in: formData
                  name: id
                  required: true
                  type: path
                - description: Text body for the updated instance rule, plaintext.
                  in: formData
                  name: text
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The updated instance rule.
                    schema:
                        $ref: '#/definitions/instanceRule'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Update an existing instance rule.
            tags:
                - admin
    /api/v1/admin/media_cleanup:
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: Also cleans up unused headers + avatars from the media cache and prunes orphaned items from storage.
            operationId: mediaCleanup
            parameters:
                - description: |-
                    Number of days of remote media to keep. Native values will be treated as 0.
                    If value is not specified, the value of media-remote-cache-days in the server config will be used.
                  format: int64
                  in: query
                  name: remote_cache_days
                  type: integer
                  x-go-name: RemoteCacheDays
            produces:
                - application/json
            responses:
                "200":
                    description: Echos the number of days requested. The cleanup is performed asynchronously after the request completes.
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Clean up remote media older than the specified number of days.
            tags:
                - admin
    /api/v1/admin/media_refetch:
        post:
            description: |-
                Currently, this only includes remote emojis.
                This endpoint is useful when data loss has occurred, and you want to try to recover to a working state.
            operationId: mediaRefetch
            parameters:
                - description: Domain to refetch media from. If empty, all domains will be refetched.
                  in: query
                  name: domain
                  type: string
            produces:
                - application/json
            responses:
                "202":
                    description: Request accepted and will be processed. Check the logs for progress / errors.
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Refetch media specified in the database but missing from storage.
            tags:
                - admin
    /api/v1/admin/reports:
        get:
            description: |-
                The reports will be returned in descending chronological order (newest first), with sequential IDs (bigger = newer).

                The next and previous queries can be parsed from the returned Link header.

                Example:

                ```
                <https://example.org/api/v1/admin/reports?limit=20&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/admin/reports?limit=20&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````
            operationId: adminReports
            parameters:
                - description: If set to true, only resolved reports will be returned. If false, only unresolved reports will be returned. If unset, reports will not be filtered on their resolved status.
                  in: query
                  name: resolved
                  type: boolean
                - description: Return only reports created by the given account id.
                  in: query
                  name: account_id
                  type: string
                - description: Return only reports that target the given account id.
                  in: query
                  name: target_account_id
                  type: string
                - description: Return only reports *OLDER* than the given max ID. The report with the specified ID will not be included in the response.
                  in: query
                  name: max_id
                  type: string
                - description: Return only reports *NEWER* than the given since ID. The report with the specified ID will not be included in the response. This parameter is functionally equivalent to min_id.
                  in: query
                  name: since_id
                  type: string
                - description: Return only reports *NEWER* than the given min ID. The report with the specified ID will not be included in the response. This parameter is functionally equivalent to since_id.
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: Number of reports to return. If more than 100 or less than 1, will be clamped to 100.
                  in: query
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: Array of reports.
                    schema:
                        items:
                            $ref: '#/definitions/adminReport'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: View user moderation reports.
            tags:
                - admin
    /api/v1/admin/reports/{id}:
        get:
            operationId: adminReportGet
            parameters:
                - description: The id of the report.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The requested report.
                    schema:
                        $ref: '#/definitions/adminReport'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: View user moderation report with the given id.
            tags:
                - admin
    /api/v1/admin/reports/{id}/resolve:
        post:
            consumes:
                - application/json
                - application/xml
                - multipart/form-data
            operationId: adminReportResolve
            parameters:
                - description: The id of the report.
                  in: path
                  name: id
                  required: true
                  type: string
                - description: Optional admin comment on the action taken in response to this report. Useful for providing an explanation about what action was taken (if any) before the report was marked as resolved. This will be visible to the user that created the report!
                  example: The reported account was suspended.
                  in: formData
                  name: action_taken_comment
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The resolved report.
                    schema:
                        $ref: '#/definitions/adminReport'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Mark a report as resolved.
            tags:
                - admin
    /api/v1/admin/rules:
        get:
            description: The rules will be returned in order (sorted by Order ascending).
            operationId: rules
            produces:
                - application/json
            responses:
                "200":
                    description: An array with all the rules for the local instance.
                    schema:
                        items:
                            $ref: '#/definitions/instanceRule'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: View instance rules, with IDs.
            tags:
                - admin
    /api/v1/admin/rules/{id}:
        get:
            operationId: adminRuleGet
            parameters:
                - description: The id of the rule.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The requested rule.
                    schema:
                        $ref: '#/definitions/instanceRule'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: View instance rule with the given id.
            tags:
                - admin
    /api/v1/apps:
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                The registered application can be used to obtain an application token.
                This can then be used to register a new account, or (through user auth) obtain an access token.

                The parameters can also be given in the body of the request, as JSON, if the content-type is set to 'application/json'.
                The parameters can also be given in the body of the request, as XML, if the content-type is set to 'application/xml'.
            operationId: appCreate
            parameters:
                - description: The name of the application.
                  in: formData
                  name: client_name
                  required: true
                  type: string
                  x-go-name: ClientName
                - description: |-
                    Where the user should be redirected after authorization.

                    To display the authorization code to the user instead of redirecting to a web page, use `urn:ietf:wg:oauth:2.0:oob` in this parameter.
                  in: formData
                  name: redirect_uris
                  required: true
                  type: string
                  x-go-name: RedirectURIs
                - description: |-
                    Space separated list of scopes.

                    If no scopes are provided, defaults to `read`.
                  in: formData
                  name: scopes
                  type: string
                  x-go-name: Scopes
                - description: A URL to the web page of the app (optional).
                  in: formData
                  name: website
                  type: string
                  x-go-name: Website
            produces:
                - application/json
            responses:
                "200":
                    description: The newly-created application.
                    schema:
                        $ref: '#/definitions/application'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            summary: Register a new application on this instance.
            tags:
                - apps
    /api/v1/blocks:
        get:
            description: |-
                The next and previous queries can be parsed from the returned Link header.
                Example:

                ```
                <https://example.org/api/v1/blocks?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/blocks?limit=80&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````
            operationId: blocksGet
            parameters:
                - description: 'Return only blocked accounts *OLDER* than the given max ID. The blocked account with the specified ID will not be included in the response. NOTE: the ID is of the internal block, NOT any of the returned accounts.'
                  in: query
                  name: max_id
                  type: string
                - description: 'Return only blocked accounts *NEWER* than the given since ID. The blocked account with the specified ID will not be included in the response. NOTE: the ID is of the internal block, NOT any of the returned accounts.'
                  in: query
                  name: since_id
                  type: string
                - description: 'Return only blocked accounts *IMMEDIATELY NEWER* than the given min ID. The blocked account with the specified ID will not be included in the response. NOTE: the ID is of the internal block, NOT any of the returned accounts.'
                  in: query
                  name: min_id
                  type: string
                - default: 40
                  description: Number of blocked accounts to return.
                  in: query
                  maximum: 80
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    headers:
                        Link:
                            description: Links to the next and previous queries.
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/account'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:blocks
            summary: Get an array of accounts that requesting account has blocked.
            tags:
                - blocks
    /api/v1/bookmarks:
        get:
            description: Get an array of statuses bookmarked in the instance
            operationId: bookmarksGet
            produces:
                - application/json
            responses:
                "200":
                    description: Array of bookmarked statuses
                    headers:
                        Link:
                            description: Links to the next and previous queries.
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/status'
                        type: array
                "401":
                    description: unauthorized
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:bookmarks
            tags:
                - bookmarks
    /api/v1/custom_emojis:
        get:
            operationId: customEmojisGet
            produces:
                - application/json
            responses:
                "200":
                    description: Array of custom emojis.
                    schema:
                        items:
                            $ref: '#/definitions/emoji'
                        type: array
                "401":
                    description: unauthorized
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:custom_emojis
            summary: Get an array of custom emojis available on the instance.
            tags:
                - custom_emojis
    /api/v1/favourites:
        get:
            description: |-
                The next and previous queries can be parsed from the returned Link header.
                Example:

                ```
                <https://example.org/api/v1/favourites?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/favourites?limit=80&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````
            operationId: favouritesGet
            parameters:
                - default: 20
                  description: Number of statuses to return.
                  in: query
                  name: limit
                  type: integer
                - description: Return only favourited statuses *OLDER* than the given favourite ID. The status with the corresponding fave ID will not be included in the response.
                  in: query
                  name: max_id
                  type: string
                - description: Return only favourited statuses *NEWER* than the given favourite ID. The status with the corresponding fave ID will not be included in the response.
                  in: query
                  name: min_id
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    headers:
                        Link:
                            description: Links to the next and previous queries.
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/status'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:favourites
            summary: Get an array of statuses that the requesting account has favourited.
            tags:
                - favourites
    /api/v1/featured_tags:
        get:
            description: 'THIS ENDPOINT IS CURRENTLY NOT FULLY IMPLEMENTED: it will always return an empty array.'
            operationId: getFeaturedTags
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        items:
                            type: object
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: Get an array of all hashtags that you currently have featured on your profile.
            tags:
                - featured_tags
    /api/v1/follow_requests:
        get:
            description: |-
                The next and previous queries can be parsed from the returned Link header.
                Example:

                ```
                <https://example.org/api/v1/follow_requests?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/follow_requests?limit=80&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````
            operationId: getFollowRequests
            parameters:
                - description: 'Return only follow requesting accounts *OLDER* than the given max ID. The follow requester with the specified ID will not be included in the response. NOTE: the ID is of the internal follow request, NOT any of the returned accounts.'
                  in: query
                  name: max_id
                  type: string
                - description: 'Return only follow requesting accounts *NEWER* than the given since ID. The follow requester with the specified ID will not be included in the response. NOTE: the ID is of the internal follow request, NOT any of the returned accounts.'
                  in: query
                  name: since_id
                  type: string
                - description: 'Return only follow requesting accounts *IMMEDIATELY NEWER* than the given min ID. The follow requester with the specified ID will not be included in the response. NOTE: the ID is of the internal follow request, NOT any of the returned accounts.'
                  in: query
                  name: min_id
                  type: string
                - default: 40
                  description: Number of follow requesting accounts to return.
                  in: query
                  maximum: 80
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    headers:
                        Link:
                            description: Links to the next and previous queries.
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/account'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:follows
            summary: Get an array of accounts that have requested to follow you.
            tags:
                - follow_requests
    /api/v1/follow_requests/{account_id}/authorize:
        post:
            description: Accept a follow request and put the requesting account in your 'followers' list.
            operationId: authorizeFollowRequest
            parameters:
                - description: ID of the account requesting to follow you.
                  in: path
                  name: account_id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: Your relationship to this account.
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:follows
            summary: Accept/authorize follow request from the given account ID.
            tags:
                - follow_requests
    /api/v1/follow_requests/{account_id}/reject:
        post:
            operationId: rejectFollowRequest
            parameters:
                - description: ID of the account requesting to follow you.
                  in: path
                  name: account_id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: Your relationship to this account.
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:follows
            summary: Reject/deny follow request from the given account ID.
            tags:
                - follow_requests
    /api/v1/instance:
        get:
            operationId: instanceGetV1
            produces:
                - application/json
            responses:
                "200":
                    description: Instance information.
                    schema:
                        $ref: '#/definitions/instanceV1'
                "406":
                    description: not acceptable
                "500":
                    description: internal error
            summary: View instance information.
            tags:
                - instance
        patch:
            consumes:
                - multipart/form-data
            description: This requires admin permissions on the instance.
            operationId: instanceUpdate
            parameters:
                - allowEmptyValue: true
                  description: Title to use for the instance.
                  in: formData
                  maximum: 40
                  name: title
                  type: string
                - allowEmptyValue: true
                  description: Username of the contact account. This must be the username of an instance admin.
                  in: formData
                  name: contact_username
                  type: string
                - allowEmptyValue: true
                  description: Email address to use as the instance contact.
                  in: formData
                  name: contact_email
                  type: string
                - allowEmptyValue: true
                  description: Short description of the instance.
                  in: formData
                  maximum: 500
                  name: short_description
                  type: string
                - allowEmptyValue: true
                  description: Longer description of the instance.
                  in: formData
                  maximum: 5000
                  name: description
                  type: string
                - allowEmptyValue: true
                  description: Terms and conditions of the instance.
                  in: formData
                  maximum: 5000
                  name: terms
                  type: string
                - description: Thumbnail image to use for the instance.
                  in: formData
                  name: thumbnail
                  type: file
                - description: Image description of the submitted instance thumbnail.
                  in: formData
                  name: thumbnail_description
                  type: string
                - description: Header image to use for the instance.
                  in: formData
                  name: header
                  type: file
            produces:
                - application/json
            responses:
                "200":
                    description: The newly updated instance.
                    schema:
                        $ref: '#/definitions/instance'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - admin
            summary: Update your instance information and/or upload a new avatar/header for the instance.
            tags:
                - instance
    /api/v1/instance/peers:
        get:
            operationId: instancePeersGet
            parameters:
                - default: open
                  description: |-
                    Comma-separated list of filters to apply to results. Recognized filters are:
                      - `open` -- include peers that are not suspended or silenced
                      - `suspended` -- include peers that have been suspended.

                    If filter is `open`, only instances that haven't been suspended or silenced will be returned.

                    If filter is `suspended`, only suspended instances will be shown.

                    If filter is `open,suspended`, then all known instances will be returned.

                    If filter is an empty string or not set, then `open` will be assumed as the default.
                  in: query
                  name: filter
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: |-
                        If no filter parameter is provided, or filter is empty, then a legacy, Mastodon-API compatible response will be returned. This will consist of just a 'flat' array of strings like `["example.com", "example.org"]`, which corresponds to domains this instance peers with.

                        If a filter parameter is provided, then an array of objects with at least a `domain` key set on each object will be returned.

                        Domains that are silenced or suspended will also have a key `suspended_at` or `silenced_at` that contains an iso8601 date string. If one of these keys is not present on the domain object, it is open. Suspended instances may in some cases be obfuscated, which means they will have some letters replaced by `*` to make it more difficult for bad actors to target instances with harassment.

                        Whether a flat response or a more detailed response is returned, domains will be sorted alphabetically by hostname.
                    schema:
                        items:
                            $ref: '#/definitions/domain'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            tags:
                - instance
    /api/v1/instance/rules:
        get:
            description: The rules will be returned in order (sorted by Order ascending).
            operationId: rules
            produces:
                - application/json
            responses:
                "200":
                    description: An array with all the rules for the local instance.
                    schema:
                        items:
                            $ref: '#/definitions/instanceRule'
                        type: array
                "400":
                    description: bad request
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            summary: View instance rules (public).
            tags:
                - instance
    /api/v1/lists:
        get:
            operationId: lists
            produces:
                - application/json
            responses:
                "200":
                    description: Array of all lists owned by the requesting user.
                    schema:
                        items:
                            $ref: '#/definitions/list'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:lists
            summary: Get all lists for owned by authorized user.
            tags:
                - lists
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: listCreate
            parameters:
                - description: Title of this list.
                  example: Cool People
                  in: formData
                  name: title
                  required: true
                  type: string
                  x-go-name: Title
                - default: list
                  description: |-
                    RepliesPolicy for this list.
                    followed = Show replies to any followed user
                    list = Show replies to members of the list
                    none = Show replies to no one
                  example: list
                  in: formData
                  name: replies_policy
                  type: string
                  x-go-name: RepliesPolicy
            produces:
                - application/json
            responses:
                "200":
                    description: The newly created list.
                    schema:
                        $ref: '#/definitions/list'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:lists
            summary: Create a new list.
            tags:
                - lists
    /api/v1/lists/{id}:
        delete:
            operationId: listDelete
            parameters:
                - description: ID of the list
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: list deleted
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:lists
            summary: Delete a single list with the given ID.
            tags:
                - lists
        get:
            operationId: list
            parameters:
                - description: ID of the list
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: Requested list.
                    schema:
                        $ref: '#/definitions/list'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:lists
            summary: Get a single list with the given ID.
            tags:
                - lists
        put:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: listUpdate
            parameters:
                - description: ID of the list
                  example: Cool People
                  in: path
                  name: id
                  required: true
                  type: string
                  x-go-name: Title
                - description: Title of this list.
                  example: Cool People
                  in: formData
                  name: title
                  type: string
                  x-go-name: RepliesPolicy
                - description: |-
                    RepliesPolicy for this list.
                    followed = Show replies to any followed user
                    list = Show replies to members of the list
                    none = Show replies to no one
                  example: list
                  in: formData
                  name: replies_policy
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The newly updated list.
                    schema:
                        $ref: '#/definitions/list'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:lists
            summary: Update an existing list.
            tags:
                - lists
    /api/v1/lists/{id}/accounts:
        delete:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: removeListAccounts
            parameters:
                - description: ID of the list
                  in: path
                  name: id
                  required: true
                  type: string
                - description: Array of accountIDs to modify. Each accountID must correspond to an account that the requesting account follows.
                  in: formData
                  items:
                    type: string
                  name: account_ids
                  required: true
                  type: array
            produces:
                - application/json
            responses:
                "200":
                    description: list accounts updated
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:lists
            summary: Remove one or more accounts from the given list.
            tags:
                - lists
        get:
            description: |-
                The returned Link header can be used to generate the previous and next queries when scrolling up or down a timeline.

                Example:

                ```
                <https://example.org/api/v1/list/01H0W619198FX7J54NF7EH1NG2/accounts?limit=20&max_id=01FC3GSQ8A3MMJ43BPZSGEG29M>; rel="next", <https://example.org/api/v1/list/01H0W619198FX7J54NF7EH1NG2/accounts?limit=20&min_id=01FC3KJW2GYXSDDRA6RWNDM46M>; rel="prev"
                ````
            operationId: listAccounts
            parameters:
                - description: ID of the list
                  in: path
                  name: id
                  required: true
                  type: string
                - description: Return only list entries *OLDER* than the given max ID. The account from the list entry with the specified ID will not be included in the response.
                  in: query
                  name: max_id
                  type: string
                - description: Return only list entries *NEWER* than the given since ID. The account from the list entry with the specified ID will not be included in the response.
                  in: query
                  name: since_id
                  type: string
                - description: Return only list entries *IMMEDIATELY NEWER* than the given min ID. The account from the list entry with the specified ID will not be included in the response.
                  in: query
                  name: min_id
                  type: string
                - default: 40
                  description: 'Number of accounts to return. If set to 0 explicitly, all accounts in the list will be returned, and pagination headers will not be used. This is a workaround for Mastodon API peculiarities: https://docs.joinmastodon.org/methods/lists/#query-parameters.'
                  in: query
                  maximum: 80
                  minimum: 0
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: Array of accounts.
                    headers:
                        Link:
                            description: Links to the next and previous queries.
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/account'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:lists
            summary: Page through accounts in this list.
            tags:
                - lists
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: addListAccounts
            parameters:
                - description: ID of the list
                  in: path
                  name: id
                  required: true
                  type: string
                - description: Array of accountIDs to modify. Each accountID must correspond to an account that the requesting account follows.
                  in: formData
                  items:
                    type: string
                  name: account_ids
                  required: true
                  type: array
            produces:
                - application/json
            responses:
                "200":
                    description: list accounts updated
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:lists
            summary: Add one or more accounts to the given list.
            tags:
                - lists
    /api/v1/markers:
        get:
            description: Get timeline markers by name
            operationId: markersGet
            parameters:
                - description: Timelines to retrieve.
                  in: query
                  items:
                    enum:
                        - home
                        - notifications
                    type: string
                  name: timeline
                  type: array
            produces:
                - application/json
            responses:
                "200":
                    description: Requested markers
                    schema:
                        $ref: '#/definitions/markers'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:statuses
            tags:
                - markers
        post:
            consumes:
                - multipart/form-data
            description: Update timeline markers by name
            operationId: markersPost
            parameters:
                - description: Last status ID read on the home timeline.
                  in: formData
                  name: home[last_read_id]
                  type: string
                - description: Last notification ID read on the notifications timeline.
                  in: formData
                  name: notifications[last_read_id]
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: Requested markers
                    schema:
                        $ref: '#/definitions/markers'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "409":
                    description: conflict (when two clients try to update the same timeline at the same time)
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:statuses
            tags:
                - markers
    /api/v1/media/{id}:
        get:
            operationId: mediaGet
            parameters:
                - description: id of the attachment
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The requested media attachment.
                    schema:
                        $ref: '#/definitions/attachment'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:media
            summary: Get a media attachment that you own.
            tags:
                - media
        put:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                You must own the media attachment, and the attachment must not yet be attached to a status.

                The parameters can also be given in the body of the request, as JSON, if the content-type is set to 'application/json'.
                The parameters can also be given in the body of the request, as XML, if the content-type is set to 'application/xml'.
            operationId: mediaUpdate
            parameters:
                - description: id of the attachment to update
                  in: path
                  name: id
                  required: true
                  type: string
                - allowEmptyValue: true
                  description: Image or media description to use as alt-text on the attachment. This is very useful for users of screenreaders! May or may not be required, depending on your instance settings.
                  in: formData
                  name: description
                  type: string
                - allowEmptyValue: true
                  default: 0,0
                  description: 'Focus of the media file. If present, it should be in the form of two comma-separated floats between -1 and 1. For example: `-0.5,0.25`.'
                  in: formData
                  name: focus
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The newly-updated media attachment.
                    schema:
                        $ref: '#/definitions/attachment'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:media
            summary: Update a media attachment.
            tags:
                - media
    /api/v1/notification/{id}:
        get:
            operationId: notification
            produces:
                - application/json
            responses:
                "200":
                    description: Requested notification.
                    schema:
                        $ref: '#/definitions/notification'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:notifications
            summary: Get a single notification with the given ID.
            tags:
                - notifications
    /api/v1/notifications:
        get:
            description: |-
                The notifications will be returned in descending chronological order (newest first), with sequential IDs (bigger = newer).

                The next and previous queries can be parsed from the returned Link header.
                Example:

                ```
                <https://example.org/api/v1/notifications?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/notifications?limit=80&since_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````
            operationId: notifications
            parameters:
                - description: Return only notifications *OLDER* than the given max notification ID. The notification with the specified ID will not be included in the response.
                  in: query
                  name: max_id
                  type: string
                - description: Return only notifications *newer* than the given since notification ID. The notification with the specified ID will not be included in the response.
                  in: query
                  name: since_id
                  type: string
                - description: Return only notifications *immediately newer* than the given since notification ID. The notification with the specified ID will not be included in the response.
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: Number of notifications to return.
                  in: query
                  name: limit
                  type: integer
                - in: query
                  items:
                    type: string
                  name: exclude_types
                  type: array
            produces:
                - application/json
            responses:
                "200":
                    description: Array of notifications.
                    headers:
                        Link:
                            description: Links to the next and previous queries.
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/notification'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:notifications
            summary: Get notifications for currently authorized user.
            tags:
                - notifications
    /api/v1/notifications/clear:
        post:
            description: Will return an empty object `{}` to indicate success.
            operationId: clearNotifications
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        type: object
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:notifications
            summary: Clear/delete all notifications for currently authorized user.
            tags:
                - notifications
    /api/v1/polls/{id}:
        get:
            operationId: poll
            parameters:
                - description: Target poll ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The requested poll.
                    schema:
                        $ref: '#/definitions/poll'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: View poll with given ID.
            tags:
                - polls
    /api/v1/polls/{id}/vote:
        post:
            operationId: pollVote
            parameters:
                - description: Target poll ID.
                  in: path
                  name: id
                  required: true
                  type: string
                - description: Poll choice indices on which to vote.
                  in: formData
                  items:
                    type: integer
                  name: choices
                  required: true
                  type: array
            produces:
                - application/json
            responses:
                "200":
                    description: The updated poll with user vote choices.
                    schema:
                        $ref: '#/definitions/poll'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "422":
                    description: unprocessable entity
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: Vote with choices in the given poll.
            tags:
                - polls
    /api/v1/preferences:
        get:
            description: |-
                Example:

                ```

                {
                "posting:default:visibility": "public",
                "posting:default:sensitive": false,
                "posting:default:language": "en",
                "reading:expand:media": "default",
                "reading:expand:spoilers": false,
                "reading:autoplay:gifs": false
                }

                ````
            operationId: preferencesGet
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        type: object
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: Return an object of user preferences.
            tags:
                - preferences
    /api/v1/reports:
        get:
            description: |-
                The reports will be returned in descending chronological order (newest first), with sequential IDs (bigger = newer).

                The next and previous queries can be parsed from the returned Link header.

                Example:

                ```
                <https://example.org/api/v1/reports?limit=20&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/reports?limit=20&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````
            operationId: reports
            parameters:
                - description: If set to true, only resolved reports will be returned. If false, only unresolved reports will be returned. If unset, reports will not be filtered on their resolved status.
                  in: query
                  name: resolved
                  type: boolean
                - description: Return only reports that target the given account id.
                  in: query
                  name: target_account_id
                  type: string
                - description: Return only reports *OLDER* than the given max ID. The report with the specified ID will not be included in the response.
                  in: query
                  name: max_id
                  type: string
                - description: Return only reports *NEWER* than the given since ID. The report with the specified ID will not be included in the response. This parameter is functionally equivalent to min_id.
                  in: query
                  name: since_id
                  type: string
                - description: Return only reports *NEWER* than the given min ID. The report with the specified ID will not be included in the response. This parameter is functionally equivalent to since_id.
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: Number of reports to return. If less than 1, will be clamped to 1. If more than 100, will be clamped to 100.
                  in: query
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: Array of reports.
                    schema:
                        items:
                            $ref: '#/definitions/report'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:reports
            summary: See reports created by the requesting account.
            tags:
                - reports
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: reportCreate
            parameters:
                - description: ID of the account to report.
                  example: 01GPE75FXSH2EGFBF85NXPH3KP
                  in: formData
                  name: account_id
                  required: true
                  type: string
                  x-go-name: AccountID
                - description: IDs of statuses to attach to the report to provide additional context.
                  example:
                    - 01GPE76N4SBVRZ8K24TW51ZZQ4
                    - 01GPE76WN9JZE62EPT3Q9FRRD4
                  in: formData
                  items:
                    type: string
                  name: status_ids
                  type: array
                  x-go-name: StatusIDs
                - description: The reason for the report. Default maximum of 1000 characters.
                  example: Anti-Blackness, transphobia.
                  in: formData
                  name: comment
                  type: string
                  x-go-name: Comment
                - default: false
                  description: If the account is remote, should the report be forwarded to the remote admin?
                  example: true
                  in: formData
                  name: forward
                  type: boolean
                  x-go-name: Forward
                - default: other
                  description: |-
                    Specify if the report is due to spam, violation of enumerated instance rules, or some other reason.
                    Currently only 'other' is supported.
                  example: other
                  in: formData
                  name: category
                  type: string
                  x-go-name: Category
                - description: IDs of rules on this instance which have been broken according to the reporter.
                  example:
                    - 01GPBN5YDY6JKBWE44H7YQBDCQ
                    - 01GPBN65PDWSBPWVDD0SQCFFY3
                  in: formData
                  items:
                    type: string
                  name: rule_ids
                  type: array
                  x-go-name: RuleIDs
            produces:
                - application/json
            responses:
                "200":
                    description: The created report.
                    schema:
                        $ref: '#/definitions/report'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:reports
            summary: Create a new user report with the given parameters.
            tags:
                - reports
    /api/v1/reports/{id}:
        get:
            operationId: reportGet
            parameters:
                - description: ID of the report
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The requested report.
                    schema:
                        $ref: '#/definitions/report'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:reports
            summary: Get one report with the given id.
            tags:
                - reports
    /api/v1/statuses:
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                The parameters can also be given in the body of the request, as JSON, if the content-type is set to 'application/json'.
                The parameters can also be given in the body of the request, as XML, if the content-type is set to 'application/xml'.
            operationId: statusCreate
            parameters:
                - description: |-
                    Text content of the status.
                    If media_ids is provided, this becomes optional.
                    Attaching a poll is optional while status is provided.
                  in: formData
                  name: status
                  type: string
                  x-go-name: Status
                - description: |-
                    Array of Attachment ids to be attached as media.
                    If provided, status becomes optional, and poll cannot be used.

                    If the status is being submitted as a form, the key is 'media_ids[]',
                    but if it's json or xml, the key is 'media_ids'.
                  in: formData
                  items:
                    type: string
                  name: media_ids
                  type: array
                  x-go-name: MediaIDs
                - $ref: '#/definitions/pollRequest'
                  description: Poll to include with this status.
                  in: formData
                  name: poll
                  x-go-name: Poll
                - description: ID of the status being replied to, if status is a reply.
                  in: formData
                  name: in_reply_to_id
                  type: string
                  x-go-name: InReplyToID
                - description: Status and attached media should be marked as sensitive.
                  in: formData
                  name: sensitive
                  type: boolean
                  x-go-name: Sensitive
                - description: |-
                    Text to be shown as a warning or subject before the actual content.
                    Statuses are generally collapsed behind this field.
                  in: formData
                  name: spoiler_text
                  type: string
                  x-go-name: SpoilerText
                - description: Visibility of the posted status.
                  in: formData
                  name: visibility
                  type: string
                  x-go-name: Visibility
                - description: |-
                    ISO 8601 Datetime at which to schedule a status.
                    Providing this parameter will cause ScheduledStatus to be returned instead of Status.
                    Must be at least 5 minutes in the future.
                  in: formData
                  name: scheduled_at
                  type: string
                  x-go-name: ScheduledAt
                - description: ISO 639 language code for this status.
                  in: formData
                  name: language
                  type: string
                  x-go-name: Language
                - description: Content type to use when parsing this status.
                  in: formData
                  name: content_type
                  type: string
                  x-go-name: ContentType
                - description: This status will be federated beyond the local timeline(s).
                  in: query
                  name: federated
                  type: boolean
                  x-go-name: Federated
                - description: This status can be boosted/reblogged.
                  in: query
                  name: boostable
                  type: boolean
                  x-go-name: Boostable
                - description: This status can be replied to.
                  in: query
                  name: replyable
                  type: boolean
                  x-go-name: Replyable
                - description: This status can be liked/faved.
                  in: query
                  name: likeable
                  type: boolean
                  x-go-name: Likeable
            produces:
                - application/json
            responses:
                "200":
                    description: The newly created status.
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: Create a new status.
            tags:
                - statuses
    /api/v1/statuses/{id}:
        delete:
            description: |-
                The deleted status will be returned in the response. The `text` field will contain the original text of the status as it was submitted.
                This is useful when doing a 'delete and redraft' type operation.
            operationId: statusDelete
            parameters:
                - description: Target status ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The status that was just deleted.
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: Delete status with the given ID. The status must belong to you.
            tags:
                - statuses
        get:
            operationId: statusGet
            parameters:
                - description: Target status ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The requested status.
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: View status with the given ID.
            tags:
                - statuses
    /api/v1/statuses/{id}/bookmark:
        post:
            operationId: statusBookmark
            parameters:
                - description: Target status ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The status.
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: Bookmark status with the given ID.
            tags:
                - statuses
    /api/v1/statuses/{id}/context:
        get:
            description: The returned statuses will be ordered in a thread structure, so they are suitable to be displayed in the order in which they were returned.
            operationId: statusContext
            parameters:
                - description: Target status ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: Status context object.
                    schema:
                        $ref: '#/definitions/statusContext'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: Return ancestors and descendants of the given status.
            tags:
                - statuses
    /api/v1/statuses/{id}/favourite:
        post:
            operationId: statusFave
            parameters:
                - description: Target status ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The newly faved status.
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: Star/like/favourite the given status, if permitted.
            tags:
                - statuses
    /api/v1/statuses/{id}/favourited_by:
        get:
            operationId: statusFavedBy
            parameters:
                - description: Target status ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        items:
                            $ref: '#/definitions/account'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: View accounts that have faved/starred/liked the target status.
            tags:
                - statuses
    /api/v1/statuses/{id}/mute:
        post:
            description: |-
                Target status must belong to you or mention you.

                Status thread mutes and unmutes are idempotent. If you already mute a thread, muting it again just means it stays muted and you'll get 200 OK back.
            operationId: statusMute
            parameters:
                - description: Target status ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The now-muted status.
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request; you're not part of the target status thread
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:mutes
            summary: Mute a status's thread. This prevents notifications from being created for future replies, likes, boosts etc in the thread of which the target status is a part.
            tags:
                - statuses
    /api/v1/statuses/{id}/pin:
        post:
            description: |-
                You can only pin original posts (not reblogs) that you authored yourself.

                Supported privacy levels for pinned posts are public, unlisted, and private/followers-only,
                but only public posts will appear on the web version of your profile.
            operationId: statusPin
            parameters:
                - description: Target status ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The status.
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: Pin a status to the top of your profile, and add it to your Featured ActivityPub collection.
            tags:
                - statuses
    /api/v1/statuses/{id}/reblog:
        post:
            description: |-
                If the target status is rebloggable/boostable, it will be shared with your followers.
                This is equivalent to an ActivityPub 'Announce' activity.
            operationId: statusReblog
            parameters:
                - description: Target status ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The boost of the status.
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: Reblog/boost status with the given ID.
            tags:
                - statuses
    /api/v1/statuses/{id}/reblogged_by:
        get:
            operationId: statusBoostedBy
            parameters:
                - description: Target status ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        items:
                            $ref: '#/definitions/account'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: View accounts that have reblogged/boosted the target status.
            tags:
                - statuses
    /api/v1/statuses/{id}/unbookmark:
        post:
            operationId: statusUnbookmark
            parameters:
                - description: Target status ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The status.
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: Unbookmark status with the given ID.
            tags:
                - statuses
    /api/v1/statuses/{id}/unfavourite:
        post:
            operationId: statusUnfave
            parameters:
                - description: Target status ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The unfaved status.
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: Unstar/unlike/unfavourite the given status.
            tags:
                - statuses
    /api/v1/statuses/{id}/unmute:
        post:
            description: |-
                Target status must belong to you or mention you.

                Status thread mutes and unmutes are idempotent. If you already unmuted a thread, unmuting it again just means it stays unmuted and you'll get 200 OK back.
            operationId: statusUnmute
            parameters:
                - description: Target status ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The now-unmuted status.
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request; you're not part of the target status thread
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:mutes
            summary: Unmute a status's thread. This reenables notifications for future replies, likes, boosts etc in the thread of which the target status is a part.
            tags:
                - statuses
    /api/v1/statuses/{id}/unpin:
        post:
            operationId: statusUnpin
            parameters:
                - description: Target status ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The status.
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: Unpin one of your pinned statuses.
            tags:
                - statuses
    /api/v1/statuses/{id}/unreblog:
        post:
            operationId: statusUnreblog
            parameters:
                - description: Target status ID.
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: The unboosted status.
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
                "406":
                    description: not acceptable
                "500":
                    description: internal server error
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: Unreblog/unboost status with the given ID.
            tags:
                - statuses
    /api/v1/streaming:
        get:
            description: |-
                The scheme used should *always* be `wss`. The streaming basepath can be viewed at `/api/v1/instance`.

                On a successful connection, a code `101` will be returned, which indicates that the connection is being upgraded to a secure websocket connection.

                As long as the connection is open, various message types will be streamed into it.

                GoToSocial will ping the connection every 30 seconds to check whether the client is still receiving.

                If the ping fails, or something else goes wrong during transmission, then the connection will be dropped, and the client will be expected to start it again.
            operationId: streamGet
            parameters:
                - description: Access token for the requesting account.
                  in: query
                  name: access_token
                  required: true
                  type: string
                - description: |-
                    Type of stream to request.

                    Options are:

                    `user`: receive updates for the account's home timeline.
                    `public`: receive updates for the public timeline.
                    `public:local`: receive updates for the local timeline.
                    `hashtag`: receive updates for a given hashtag.
                    `hashtag:local`: receive local updates for a given hashtag.
                    `list`: receive updates for a certain list of accounts.
                    `direct`: receive updates for direct messages.
                  in: query
                  name: stream
                  required: true
                  type: string
                - description: |-
                    ID of the list to subscribe to.
                    Only used if stream type is 'list'.
                  in: query
                  name: list
                  type: string
                - description: |-
                    Name of the tag to subscribe to.
                    Only used if stream type is 'hashtag' or 'hashtag:local'.
                  in: query
                  name: tag
                  type: string
            produces:
                - application/json
            responses:
                "101":
                    description: ""
                    schema:
                        properties:
                            event:
                                description: |-
                                    The type of event being received.

                                    `update`: a new status has been received.
                                    `notification`: a new notification has been received.
                                    `delete`: a status has been deleted.
                                    `filters_changed`: not implemented.
                                enum:
                                    - update
                                    - notification
                                    - delete
                                    - filters_changed
                                type: string
                            payload:
                                description: |-
                                    The payload of the streamed message.
                                    Different depending on the `event` type.

                                    If present, it should be parsed as a string.

                                    If `event` = `update`, then the payload will be a JSON string of a status.
                                    If `event` = `notification`, then the payload will be a JSON string of a notification.
                                    If `event` = `delete`, then the payload will be a status ID.
                                example: '{"id":"01FC3TZ5CFG6H65GCKCJRKA669","created_at":"2021-08-02T16:25:52Z","sensitive":false,"spoiler_text":"","visibility":"public","language":"en","uri":"https://gts.superseriousbusiness.org/users/dumpsterqueer/statuses/01FC3TZ5CFG6H65GCKCJRKA669","url":"https://gts.superseriousbusiness.org/@dumpsterqueer/statuses/01FC3TZ5CFG6H65GCKCJRKA669","replies_count":0,"reblogs_count":0,"favourites_count":0,"favourited":false,"reblogged":false,"muted":false,"bookmarked":fals…//gts.superseriousbusiness.org/fileserver/01JNN207W98SGG3CBJ76R5MVDN/header/original/019036W043D8FXPJKSKCX7G965.png","header_static":"https://gts.superseriousbusiness.org/fileserver/01JNN207W98SGG3CBJ76R5MVDN/header/small/019036W043D8FXPJKSKCX7G965.png","followers_count":33,"following_count":28,"statuses_count":126,"last_status_at":"2021-08-02T16:25:52Z","emojis":[],"fields":[]},"media_attachments":[],"mentions":[],"tags":[],"emojis":[],"card":null,"poll":null,"text":"a"}'
                                type: string
                            stream:
                                items:
                                    enum:
                                        - user
                                        - public
                                        - public:local
                                        - hashtag
                                        - hashtag:local
                                        - list
                                        - direct
                                    type: string
                                type: array
                        type: object
                "400":
                    description: bad request
                "401":
                    description: unauthorized
            schemes:
                - wss
            security:
                - OAuth2 Bearer:
                    - read:streaming
            summary: Initiate a websocket connection for live streaming of statuses and notifications.
            tags:
                - streaming
    /api/v1/timelines/home:
        get:
            description: |-
                The statuses will be returned in descending chronological order (newest first), with sequential IDs (bigger = newer).

                The returned Link header can be used to generate the previous and next queries when scrolling up or down a timeline.

                Example:

                ```
                <https://example.org/api/v1/timelines/home?limit=20&max_id=01FC3GSQ8A3MMJ43BPZSGEG29M>; rel="next", <https://example.org/api/v1/timelines/home?limit=20&min_id=01FC3KJW2GYXSDDRA6RWNDM46M>; rel="prev"
                ````
            operationId: homeTimeline
            parameters:
                - description: Return only statuses *OLDER* than the given max status ID. The status with the specified ID will not be included in the response.
                  in: query
                  name: max_id
                  type: string
                - description: Return only statuses *newer* than the given since status ID. The status with the specified ID will not be included in the response.
                  in: query
                  name: since_id
                  type: string
                - description: Return only statuses *immediately newer* than the given since status ID. The status with the specified ID will not be included in the response.
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: Number of statuses to return.
                  in: query
                  name: limit
                  type: integer
                - default: false
                  description: Show only statuses posted by local accounts.
                  in: query
                  name: local
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: Array of statuses.
                    headers:
                        Link:
                            description: Links to the next and previous queries.
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/status'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: See statuses/posts by accounts you follow.
            tags:
                - timelines
    /api/v1/timelines/list/{id}:
        get:
            description: |-
                The statuses will be returned in descending chronological order (newest first), with sequential IDs (bigger = newer).

                The returned Link header can be used to generate the previous and next queries when scrolling up or down a timeline.

                Example:

                ```
                <https://example.org/api/v1/timelines/list/01H0W619198FX7J54NF7EH1NG2?limit=20&max_id=01FC3GSQ8A3MMJ43BPZSGEG29M>; rel="next", <https://example.org/api/v1/timelines/list/01H0W619198FX7J54NF7EH1NG2?limit=20&min_id=01FC3KJW2GYXSDDRA6RWNDM46M>; rel="prev"
                ````
            operationId: listTimeline
            parameters:
                - description: ID of the list
                  in: path
                  name: id
                  required: true
                  type: string
                - description: Return only statuses *OLDER* than the given max status ID. The status with the specified ID will not be included in the response.
                  in: query
                  name: max_id
                  type: string
                - description: Return only statuses *NEWER* than the given since status ID. The status with the specified ID will not be included in the response.
                  in: query
                  name: since_id
                  type: string
                - description: Return only statuses *NEWER* than the given since status ID. The status with the specified ID will not be included in the response.
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: Number of statuses to return.
                  in: query
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: Array of statuses.
                    headers:
                        Link:
                            description: Links to the next and previous queries.
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/status'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
            security:
                - OAuth2 Bearer:
                    - read:lists
            summary: See statuses/posts from the given list timeline.
            tags:
                - timelines
    /api/v1/timelines/public:
        get:
            description: |-
                The statuses will be returned in descending chronological order (newest first), with sequential IDs (bigger = newer).

                The returned Link header can be used to generate the previous and next queries when scrolling up or down a timeline.

                Example:

                ```
                <https://example.org/api/v1/timelines/public?limit=20&max_id=01FC3GSQ8A3MMJ43BPZSGEG29M>; rel="next", <https://example.org/api/v1/timelines/public?limit=20&min_id=01FC3KJW2GYXSDDRA6RWNDM46M>; rel="prev"
                ````
            operationId: publicTimeline
            parameters:
                - description: Return only statuses *OLDER* than the given max status ID. The status with the specified ID will not be included in the response.
                  in: query
                  name: max_id
                  type: string
                - description: Return only statuses *NEWER* than the given since status ID. The status with the specified ID will not be included in the response.
                  in: query
                  name: since_id
                  type: string
                - description: Return only statuses *NEWER* than the given since status ID. The status with the specified ID will not be included in the response.
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: Number of statuses to return.
                  in: query
                  name: limit
                  type: integer
                - default: false
                  description: Show only statuses posted by local accounts.
                  in: query
                  name: local
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: Array of statuses.
                    headers:
                        Link:
                            description: Links to the next and previous queries.
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/status'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: See public statuses/posts that your instance is aware of.
            tags:
                - timelines
    /api/v1/timelines/tag/{tag_name}:
        get:
            description: |-
                The statuses will be returned in descending chronological order (newest first), with sequential IDs (bigger = newer).

                The returned Link header can be used to generate the previous and next queries when scrolling up or down a timeline.

                Example:

                ```
                <https://example.org/api/v1/timelines/tag/example?limit=20&max_id=01FC3GSQ8A3MMJ43BPZSGEG29M>; rel="next", <https://example.org/api/v1/timelines/tag/example?limit=20&min_id=01FC3KJW2GYXSDDRA6RWNDM46M>; rel="prev"
                ````
            operationId: tagTimeline
            parameters:
                - description: Return only statuses *OLDER* than the given max status ID. The status with the specified ID will not be included in the response.
                  in: query
                  name: max_id
                  type: string
                - description: Return only statuses *newer* than the given since status ID. The status with the specified ID will not be included in the response.
                  in: query
                  name: since_id
                  type: string
                - description: Return only statuses *immediately newer* than the given since status ID. The status with the specified ID will not be included in the response.
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: Number of statuses to return.
                  in: query
                  maximum: 40
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: Array of statuses.
                    headers:
                        Link:
                            description: Links to the next and previous queries.
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/status'
                        type: array
                "400":
                    description: bad request
                "401":
                    description: unauthorized
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: See public statuses that use the given hashtag (case insensitive).
            tags:
                - timelines
    /api/v1/user/password_change:
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                The parameters can also be given in the body of the request, as JSON, if the content-type is set to 'application/json'.
                The parameters can also be given in the body of the request, as XML, if the content-type is set to 'application/xml'.
            operationId: userPasswordChange
            parameters:
                - description: User's previous password.
                  in: formData
                  name: old_password
                  required: true
                  type: string
                  x-go-name: OldPassword
                - description: |-
                    Desired new password.
                    If the password does not have high enough entropy, it will be rejected.
                    See https://github.com/wagslane/go-password-validator
                  in: formData
                  name: new_password
                  required: true
                  type: string
                  x-go-name: NewPassword
            produces:
                - application/json
            responses:
                "200":
                    description: Change successful
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "406":
                    description: not acceptable
                "500":
                    description: internal error
            security:
                - OAuth2 Bearer:
                    - write:user
            summary: Change the password of authenticated user.
            tags:
                - user
    /api/v2/instance:
        get:
            operationId: instanceGetV2
            produces:
                - application/json
            responses:
                "200":
                    description: Instance information.
                    schema:
                        $ref: '#/definitions/instanceV2'
                "406":
                    description: not acceptable
                "500":
                    description: internal error
            summary: View instance information.
            tags:
                - instance
    /nodeinfo/2.0:
        get:
            description: 'See: https://nodeinfo.diaspora.software/schema.html'
            operationId: nodeInfoGet
            produces:
                - application/json; profile="http://nodeinfo.diaspora.software/ns/schema/2.0#"
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/nodeinfo'
            summary: Returns a compliant nodeinfo response to node info queries.
            tags:
                - nodeinfo
    /users/{username}/collections/featured:
        get:
            description: |-
                The response will contain an ordered collection of Note URIs in the `items` property.

                It is up to the caller to dereference the provided Note URIs (or not, if they already have them cached).

                HTTP signature is required on the request.
            operationId: s2sFeaturedCollectionGet
            produces:
                - application/activity+json
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/swaggerFeaturedCollection'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
            summary: Get the featured collection (pinned posts) for a user.
            tags:
                - s2s/federation
    /users/{username}/outbox:
        get:
            description: |-
                Note that the response will be a Collection with a page as `first`, as shown below, if `page` is `false`.

                If `page` is `true`, then the response will be a single `CollectionPage` without the wrapping `Collection`.

                HTTP signature is required on the request.
            operationId: s2sOutboxGet
            parameters:
                - description: Username of the account.
                  in: path
                  name: username
                  required: true
                  type: string
                - default: false
                  description: Return response as a CollectionPage.
                  in: query
                  name: page
                  type: boolean
                - description: Minimum ID of the next status, used for paging.
                  in: query
                  name: min_id
                  type: string
                - description: Maximum ID of the next status, used for paging.
                  in: query
                  name: max_id
                  type: string
            produces:
                - application/activity+json
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/swaggerCollection'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
            summary: Get the public outbox collection for an actor.
            tags:
                - s2s/federation
    /users/{username}/statuses/{status}/replies:
        get:
            description: |-
                Note that the response will be a Collection with a page as `first`, as shown below, if `page` is `false`.

                If `page` is `true`, then the response will be a single `CollectionPage` without the wrapping `Collection`.

                HTTP signature is required on the request.
            operationId: s2sRepliesGet
            parameters:
                - description: Username of the account.
                  in: path
                  name: username
                  required: true
                  type: string
                - description: ID of the status.
                  in: path
                  name: status
                  required: true
                  type: string
                - default: false
                  description: Return response as a CollectionPage.
                  in: query
                  name: page
                  type: boolean
                - default: false
                  description: Return replies only from accounts other than the status owner.
                  in: query
                  name: only_other_accounts
                  type: boolean
                - description: Minimum ID of the next status, used for paging.
                  in: query
                  name: min_id
                  type: string
            produces:
                - application/activity+json
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/swaggerCollection'
                "400":
                    description: bad request
                "401":
                    description: unauthorized
                "403":
                    description: forbidden
                "404":
                    description: not found
            summary: Get the replies collection for a status.
            tags:
                - s2s/federation
schemes:
    - https
    - http
securityDefinitions:
    OAuth2 Application:
        flow: application
        scopes:
            write:accounts: grants write access to accounts
        tokenUrl: https://example.org/oauth/token
        type: oauth2
    OAuth2 Bearer:
        authorizationUrl: https://example.org/oauth/authorize
        flow: accessCode
        scopes:
            admin: grants admin access to everything
            admin:accounts: grants admin access to accounts
            read: grants read access to everything
            read:accounts: grants read access to accounts
            read:blocks: grant read access to blocks
            read:custom_emojis: grant read access to custom_emojis
            read:favourites: grant read access to favourites
            read:follows: grant read access to follows
            read:lists: grant read access to lists
            read:media: grant read access to media
            read:mutes: grant read access to mutes
            read:notifications: grants read access to notifications
            read:search: grant read access to searches
            read:statuses: grants read access to statuses
            read:streaming: grants read access to streaming api
            read:user: grants read access to user-level info
            write: grants write access to everything
            write:accounts: grants write access to accounts
            write:blocks: grants write access to blocks
            write:follows: grants write access to follows
            write:lists: grants write access to lists
            write:media: grants write access to media
            write:mutes: grants write access to mutes
            write:statuses: grants write access to statuses
            write:user: grants write access to user-level info
        tokenUrl: https://example.org/oauth/token
        type: oauth2
swagger: "2.0"