List the notifications of a notification request
const url = 'https://example.com/api/v1/notifications/requests/01890a5d-ac96-774b-bcce-b302099a8057/notifications?limit=20';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://example.com/api/v1/notifications/requests/01890a5d-ac96-774b-bcce-b302099a8057/notifications?limit=20' \ --header 'Authorization: Bearer <token>'The notifications waiting in the request of a source account, newest first, without the dismissed ones and those about deleted posts; a 404 when the list of requests does not show the request.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”The ID of a resource, a UUIDv7 in its canonical string form.
The account ID.
Query Parameters
Section titled “Query Parameters”An opaque pagination cursor. Clients pass it back unchanged and never parse it.
The next_cursor of the previous page; omitted for the first page.
The maximum number of items in the page.
Responses
Section titled “Responses”A page of notifications.
A page of notifications, newest first.
object
An opaque pagination cursor. Clients pass it back unchanged and never parse it.
A notification of something that happened to the authenticated user.
object
The ID of a resource, a UUIDv7 in its canonical string form.
The kind of a notification. account is the account that acted: the follower
(follow, follow_request), the followed account (follow_accepted), the author
(mention), the booster (boost), the account that favourited (favourite), or the
account that reacted with an emoji (reaction, whose reaction is the emoji; a reaction
with another emoji is another notification), or the account that quoted a post of the
user (quote, once the quote is approved or, from software without approvals, received).
status is the post that mention, boost, favourite, reaction, and poll_closed
are about, and for quote the post that quotes. reply_request, boost_request, and
quote_request tell that account replied to, boosted, or quoted the user’s status and
that it waits for the user’s approval (listInteractionRequests); interaction_accepted
and interaction_rejected tell that account, the author of status, approved or refused
the user’s reply to it, boost of it, or quote of it. moderation_notice comes from the instance and has no account; its
moderation_action is the action on the user’s account, with its kind, reason, and end.
report_resolved also comes from the instance: its report is the user’s report that
the moderators resolved, without how they resolved it. It is sent once per report, even
when the report is reopened and resolved again. appeal_decided also comes from the
instance: the moderators decided the user’s appeal, and its moderation_action is the
action with the appeal and the decision. hook_appeal_decided also comes from the
instance: a moderator upheld or overturned the user’s appeal of a post that the automated
review refused, and its hook_appeal is the appeal with its state; first-party clients only,
as the appeal is. It is sent once per appeal.
relationships_severed also comes from the instance: its relationship_severance tells
how many follows the user lost when the moderators suspended a server or a remote
account, whose account it carries for an account. It is sent once per suspension.
The moderator notifications come from the instance too: admin_report (an account
that had no open report was reported; report_id is the report) goes to the users
with the manage_reports permission, admin_sign_up (a registration awaits
approval; account is the new user’s account) to those with manage_accounts, and
admin_appeal (a user appealed an action; appeal_id is the appeal) to those with
manage_accounts, and admin_webhook_disabled (the server disabled a webhook that
answered 410 Gone or kept failing; it names none) to those with manage_webhooks, and
admin_hook_failing (calls of an external review keep failing; it names none) and
admin_hook_appeal (a user appealed a post that the automated review refused;
hook_appeal_id is the appeal) to those with manage_reports, and
admin_custom_emoji_request (a user requested a custom emoji or a new image of one;
custom_emoji_request is the request) to those with manage_custom_emojis, and
admin_domain_list_failing (three fetches in a row of a subscribed domain block list
failed; it names none) to those with manage_domains.
custom_emoji_request_decided also comes from the instance: an administrator approved
or rejected the user’s custom emoji request, which custom_emoji_request carries with
its state and the reason of a rejection.
The supporter notifications also come from the instance and tell of the user’s own
supporter subscription, which supporter_subscription carries as it is now:
supporter_payment_failed (a payment failed; the plan’s role stays until
grace_ends_at unless a payment succeeds), supporter_subscription_ended (the
subscription lost the plan’s role; end_reason says why), and supporter_plan_retired
(the administrators retired the plan; the subscription ends with its period). Each is
sent once per change of the subscription. A client must not lead from them to
subscribing or paying where it offers no way to subscribe.
account_moved tells that an account that the user followed (account) moved to another
one; its account_move carries the target and what became of the user’s follow. It is
sent once per move. admin_account_moved goes to the users with manage_accounts: an
account that the moderators limit moved, and the target does not get the limit; its
account_move carries the target, and it has no account. service_closure goes to every
local user when the closure of the service is announced, when its dates change, and when the
announcement is withdrawn; admin_service_closure_due goes to the users with
manage_service_closure once the closing date of the announcement in effect has passed, to
close the server; supporter_service_closure tells a subscriber that the announcement cancels
their supporter subscription at the end of its period, with its supporter_subscription.
Their service_closure says what they tell of, and they have no account.
voice_room_started tells that an account that the user follows (account, the host)
opened a voice chat room that the user sees, once per room; voice_room_invited that the
host or a co-host of a room (account) invited the user to it, once per invitation. Both
carry voice_room_id, and voice_room while the room is open and the user sees it.
admin_error_group tells the holders of manage_errors of a new error group or of a
resolved one that happened again, at most 10 times an hour for the whole server, with the
rest of the hour folded into one; its error_group says which, and it has no account.
The type status tells of a new post (status) of an account that the user subscribes to
(account, the author; subscribeAccount), once per post. It is not sent for a reply to
someone else’s post, a boost, an edit, or a post that the server fetched rather than received,
nor when the user gets a mention of the same post.
announcement goes to every local user once a server-wide announcement starts to show (its
publication, or the start of its window when that comes later), once per announcement; its
announcement carries it, and it has no account. Editing the announcement afterwards sends
nothing again, and the notification leaves the list and the unread count once the
announcement is withdrawn or its window ends.
auto_delete_limit comes from the instance: the server maximum of the automatic deletion of
old posts now binds the user (it was turned on or lowered, or the user lost the permission
keep_posts_longer), and after a grace period it deletes the user’s posts that their own
policy keeps. Its auto_delete_limit carries the maximum and when it starts to apply, and it
has no account. It is sent once per notice.
scheduled_status_failed comes from the instance: a post that the user scheduled could not be
published at its time, and its draft stays to fix and schedule again. Its
scheduled_status_failure carries the draft, why, and when it was to be published, while the
draft exists, and it has no account. It is sent once per schedule; a published scheduled post
sends nothing.
The event_* types tell of an event of the server (event_id, and event while the user
sees it). event_invited tells that account invited the user, once per invitation;
event_schedule_confirmed that the organizers fixed the date of an event whose date poll the
user answered or to which the user was invited, once per date; event_changed that the date,
the places, or the voice chat room of an event that the user answered going or maybe to, or was
invited to, changed, once per change (a change of the title or the description sends
nothing); event_cancelled that such an event was cancelled; event_reminder that an event
that the user answered going or maybe to starts soon, at each time before the start that the
user chose (getEventReminders), once per date and time, and never for a date that changed
since; event_started that it starts now, once per date; event_room_unavailable tells
the organizer that the voice chat room of the event cannot open; and event_board_posted
tells a user who answered going or maybe that account wrote a new post (status) on the
board of the event, once per post, but not when the post mentions the user, who gets the
mention instead. Their account is the organizer, except for event_invited and
event_board_posted. Each is sent only while the user sees the event, and an
event_board_posted only while the user reads its board.
When it happened.
Whether the user has read it: it is older than or at the marker’s last_read_id, or
it was marked read on its own (POST /notifications/{id}/read).
Schema: Account
object
The post that the notification is about, as the user sees it; omitted when the user may not see it.
Schema: Status
object
The user’s report that a report_resolved tells of; omitted without read:reports.
Schema: Report
object
The action on the user’s account that a moderation_notice tells of, or whose
appeal an appeal_decided tells of, with the appeal; first-party clients only.
Schema: ModerationAction
object
The report that an admin_report is about.
The appeal that an admin_appeal is about.
The appeal of a refused post that an admin_hook_appeal is about.
The user’s appeal of a refused post that a hook_appeal_decided tells of, with its state;
first-party clients only, and absent once the appeal is no longer kept.
Schema: OwnHookAppeal
object
The custom emoji request that an admin_custom_emoji_request or a
custom_emoji_request_decided is about, as it is now; absent when it no longer exists,
and without read:custom_emojis.
Schema: CustomEmojiRequest
object
The user’s supporter subscription that a supporter_payment_failed, a
supporter_subscription_ended, or a supporter_plan_retired is about, as it is now;
absent when it no longer exists, and without read:supporters.
Schema: SupporterSubscription
object
The follows that a relationships_severed tells of; omitted without read:follows.
Schema: RelationshipSeverance
object
Schema: AccountMove
object
Schema: ServiceClosureNotice
object
The emoji of a reaction; omitted for the other types.
Schema: ReactionEmoji
object
The voice chat room that a voice_room_started or a voice_room_invited is about.
The voice chat room that a voice_room_started or a voice_room_invited is about, while
it is open and the user sees it; omitted otherwise, and without read:voice.
Schema: VoiceRoom
object
The event that an event_* notification is about.
The event that an event_* notification is about, as the user sees it now; omitted when
the user no longer sees it, for the other types, and without read:events.
Schema: Event
object
What an admin_error_group tells of; omitted for the other types.
Schema: NotificationErrorGroup
object
The announcement that an announcement tells of, as the user sees it; omitted for the other types.
Schema: Announcement
object
What an auto_delete_limit tells of; omitted for the other types.
Schema: NotificationAutoDeleteLimit
object
The scheduled post that a scheduled_status_failed tells of, while its draft exists;
omitted otherwise and for the other types.
object
Example
{ "items": [ { "id": "01890a5d-ac96-774b-bcce-b302099a8057", "type": "follow", "report_id": "01890a5d-ac96-774b-bcce-b302099a8057", "appeal_id": "01890a5d-ac96-774b-bcce-b302099a8057", "hook_appeal_id": "01890a5d-ac96-774b-bcce-b302099a8057", "voice_room_id": "01890a5d-ac96-774b-bcce-b302099a8057", "event_id": "01890a5d-ac96-774b-bcce-b302099a8057" } ]}Headers
Section titled “Headers”The caching policy. Anonymous public GETs are cacheable by shared caches.
default
Section titled “default”An error, as an RFC 9457 problem document.
An RFC 9457 problem document. Besides about:blank, type is one of
/api/v1/problems/unauthenticated(401): the operation needs an access token and the request has none./api/v1/problems/invalid-token(401): the access token is malformed, unknown, expired, or revoked. Refresh it or sign in again./api/v1/problems/insufficient-scope(403): the access token lacks the scope thatWWW-Authenticatenames./api/v1/problems/first-party-only(403): the operation (password, two-factor authentication, passkeys, deleting the account) takes only the token of one of the server’s own clients, whatever its scopes./api/v1/problems/account-unavailable(403): the token is valid, but its user cannot use the app (registration pending or rejected, email unverified, the account deactivated or deleted, or a moderation action that disables its login). The user can still sign in to the server’s sign-in page, which says why./api/v1/problems/idempotency-key-reused(422): theIdempotency-Keywas sent to the operation with another request in the last 24 hours. Choose a new key for a new request./api/v1/problems/idempotency-key-in-use(409): the request with thisIdempotency-Keyis still being carried out. Send it again afterRetry-Afterfor its answer./api/v1/problems/blocking(409): the viewer blocks the account, which keeps them from following it. Unblock it first./api/v1/problems/federation-restricted(403): the instance’s federation mode (Instance.federation.mode) does not let the operation through: following a remote account or resolving one (off,outbound), or quoting a remote status (off,inbound)./api/v1/problems/media-too-large(413): the uploaded file is larger than the instance accepts./api/v1/problems/unsupported-media-format(415): the uploaded file is not in an accepted format or codec (such as HEVC video), or its declared type does not match its content./api/v1/problems/media-dimensions(422): the image is too wide or tall, or has too many pixels or frames; or the video has too many pixels or frames per second./api/v1/problems/media-too-long(422): the video or audio file is longer than the instance accepts./api/v1/problems/media-corrupt(422): the uploaded file cannot be read as a file of its format./api/v1/problems/media-attached(409): the media file is attached to a post and can no longer be changed on its own./api/v1/problems/too-many-streams(429): the user already has as many streams (GET /streaming) open as the server allows. Close one first./api/v1/problems/missing-permission(403): the user’s roles lack the permission that an admin operation needs./api/v1/problems/already-appealed(422): the user already appealed the moderation action or the refusal of a post; each is appealed once./api/v1/problems/appeal-window-closed(422): the time to appeal the moderation action or the refusal of a post has passed./api/v1/problems/not-appealable(422): the moderation action is a ban whose account is deleted, so it can no longer be appealed or overturned; or the decision of the automated review is not a refusal of the user’s post that is in force./api/v1/problems/appeal-decided(409): the appeal was already decided the other way./api/v1/problems/wrong-password(422): the password given to confirm the operation is not the user’s current password./api/v1/problems/deactivation-refused(409): the user’s own account cannot be deactivated now; the detail says why./api/v1/problems/export-in-progress(409): another data export of the user is being built. Wait for it to end./api/v1/problems/export-not-ready(409): the data export has no archive to download: it is being built, failed, or expired./api/v1/problems/import-in-progress(409): another import of the user is being carried out. Wait for it to finish./api/v1/problems/invalid-two-factor-code(422): the two-factor code is wrong, was already used, or is not a code./api/v1/problems/totp-setup-expired(422): the TOTP setup is unknown or expired. Start a new one./api/v1/problems/two-factor-enabled(409): the user already has two-factor authentication./api/v1/problems/two-factor-not-enabled(409): the user, or the account of an admin operation, has no two-factor authentication./api/v1/problems/invalid-passkey(422): the browser’s response to a passkey registration or confirmation does not verify, the passkey is registered already, or the passkey that confirms an operation is not one of the user’s./api/v1/problems/passkey-registration-expired(422): the passkey registration is unknown or expired. Start a new one./api/v1/problems/passkey-confirmation-expired(422): the confirmation with a passkey is unknown, expired, or used. Start a new one./api/v1/problems/too-many-passkeys(409): the user already has the most passkeys allowed. Remove one first./api/v1/problems/last-sign-in-method(409): the operation would leave the user no way to sign in: the password, the last passkey, or the last linked account when nothing else signs the user in./api/v1/problems/login-providers-only(403): registration and sign-in are limited to the login providers, so a password cannot be set and a passkey cannot be added./api/v1/problems/external-confirmation-expired(422): the confirmation with a linked login provider is unknown, expired, used, or for another operation. Start a new one./api/v1/problems/login-provider-unavailable(422): the login provider is unknown or disabled, does not allow links, or the user links no account at it./api/v1/problems/login-provider-linked(409): the user links an account at the login provider already./api/v1/problems/too-many-oauth-apps(409): the user already has the most OAuth apps allowed (25). Delete one first./api/v1/problems/oauth-app-registration-disabled(403): the server does not let users register OAuth apps./api/v1/problems/public-oauth-app(409): the OAuth app is public and has no secret./api/v1/problems/oauth-app-disabled(409): an administrator disabled the OAuth app./api/v1/problems/invalid-custom-emoji(422): a custom emoji breaks a rule;reasonsays which./api/v1/problems/invalid-webhook(422): a webhook breaks a rule;reasonsays which./api/v1/problems/invalid-relay(422): a relay cannot be registered, joined, left, or deleted;reasonsays why./api/v1/problems/invalid-theme(422): the theme’s token set breaks a rule; the problem lists every reason intheme_errors(PUT /admin/theme/draft,POST /admin/theme/publish,POST /admin/theme/restore)./api/v1/problems/invalid-brand(422): the brand image breaks a rule;brand_errorsays why (/admin/instance/brand/...)./api/v1/problems/service-closure-state(409): the state of the service closure does not allow the operation: withdrawing an announcement when none is in effect, announcing the closure of a server that is closed already (/admin/closure/announcement), or closing a server whose closure is not announced or whosecloses_athas not come (POST /admin/closure/close)./api/v1/problems/service-closing(409): the closure of the service is announced, which stops new registrations and supporter subscriptions: approving a pending registration (/admin/registrations/{id}/approve) or starting a supporter checkout (POST /supporter/checkout)./api/v1/problems/service-closed(403): the server is closed. A closed server serves only the operations with which the users take their data away: their own account and preferences (verify_credentials,/preferences,/accounts/password,/two_factor,/passkeysread), the exports (/exports,/csv_exports), their sessions (/sessions,/authorized_apps),GET /instance,GET /instance/health,GET /instance/documents,POST /client_errors, and the administrators’ operations that follow the closure (/admin/closure,/admin/queue,/admin/jobs). Every other operation, the streaming endpoint included, is refused with this problem; signing in and resetting a password stay available outside the client API./api/v1/problems/too-many-domain-mutes(422): the user already mutes the most domains allowed. Unmute one first./api/v1/problems/too-many-keyword-filters(422): the user already has the most keyword filters allowed. Delete one first./api/v1/problems/too-many-filter-keywords(422): the words would pass the most a keyword filter, or all the user’s filters together, may have. Remove some first./api/v1/problems/too-many-lists(422): the user already has the most lists allowed. Delete one first./api/v1/problems/too-many-list-members(422): the list already has the most members allowed. Remove one first./api/v1/problems/not-followed(422): only an account that the user follows (whose follow request was accepted) can be added to a list./api/v1/problems/follows-hidden(403): the account’sfollows_visibilitykeeps its follows and followers lists from the viewer (/accounts/{id}/following,/accounts/{id}/followers). Its counts stay on the account./api/v1/problems/too-many-followed-tags(422): the user already follows the most hashtags allowed (100). Unfollow one first./api/v1/problems/too-many-featured-tags(422): the user asked to feature more hashtags than allowed (10)./api/v1/problems/invalid-alias(422): the handle or URL of an alias leads to no account’s actor, or to the user itself./api/v1/problems/too-many-aliases(422): the user already has the most aliases allowed (5). Remove one first./api/v1/problems/role-managed-by-plan(409): the role is the role of a supporter plan: only its subscriptions grant and revoke it, and its permissions and position change from the plan (PATCH /admin/supporter_plans/{id}). Its badge changes as any role’s./api/v1/problems/breaks-supporter-roles(409): the change would put a staff role (one with a moderation or server permission) at or below the role of a supporter plan./api/v1/problems/supporters-unavailable(409): the supporter program needs a payment provider in the deployment’s configuration and a server that sends email./api/v1/problems/live-subscriptions(409): subscriptions to the supporter plans go on; retire the plans and wait for the subscriptions to end before disabling the program./api/v1/problems/invalid-supporter-plan(422): a supporter plan breaks a rule;reasonsays which./api/v1/problems/supporter-plan-retired(409): the supporter plan is retired and does not change any more./api/v1/problems/subscription-ended(409): the subscription has ended already./api/v1/problems/supporter-ineligible(422): the user may not subscribe to a supporter plan: not a local user, the primary email address is not verified, or the account is restricted./api/v1/problems/supporter-subscribed(409): the user has a subscription that goes on already; change its plan instead./api/v1/problems/supporter-plan-unavailable(422): the supporter plan takes no subscriptions: hidden, retired, not ready, or of another currency./api/v1/problems/supporter-subscription-state(409): the subscription’s state does not allow the operation./api/v1/problems/supporter-same-plan(422): the subscription has that plan and interval already./api/v1/problems/supporter-payment-failed(402): the payment of a change of plan failed, or the card needs an authentication that the change cannot ask for. The plan stays and nothing was charged; update the card and try again./api/v1/problems/supporter-payment-processing(409): the payment of a change of plan has not settled. The plan stays, and moves if the payment succeeds./api/v1/problems/supporter-tip-amount(422): the amount of the tip is not one of the amounts ofGET /instance/tip_amounts./api/v1/problems/supporter-tip-pending(409): another start of a tip of the user’s runs at the same time; try again./api/v1/problems/tips-unavailable(409): the tips need the supporter program enabled on the configured payment provider, which takes one-time payments./api/v1/problems/invalid-tip-amounts(422): the amounts of the tips break a rule;reasonsays which./api/v1/problems/voice-not-eligible(403): the user may not host voice chat rooms./api/v1/problems/voice-not-host(403): only the host of the voice chat room may do this./api/v1/problems/voice-room-full(409): the voice chat room holds as many people as the server allows./api/v1/problems/voice-too-many-rooms(409): as many voice chat rooms are open as the server allows./api/v1/problems/voice-hosting-elsewhere(409): the user hosts another open voice chat room; leave it first, choosing the next host or ending it./api/v1/problems/voice-host-must-choose(409): the host leaves a room with other participants; choose the next host or end the room./api/v1/problems/voice-invalid-next-host(422): the next host is not a participant of the room who may host rooms./api/v1/problems/voice-conflict(409): the room changed meanwhile; try again./api/v1/problems/voice-unavailable(503): the server could not prepare the connection to the room./api/v1/problems/invites-not-allowed(403): the user may not create invites of their own now: the instance settinginvite_creatorsand the user’s roles do not let them, the account is suspended or limited, its registration is not approved, or the registration isclosed. Itsreasonsays which./api/v1/problems/too-many-invites(409): the user already holds as many usable invites as the instance settingmember_invite_max_activeallows. Revoke one or wait for one to expire or be used up./api/v1/problems/registration-closed(409): the registration mode isclosed, which takes no invite./api/v1/problems/target-outranks-actor(403): the admin operation on an account needs the user to rank above the account: the highestpositionamong the user’s roles must be above that of every role of the account, so it refuses a higher or equal rank and the user’s own account./api/v1/problems/last-administrator(409): the operation would leave the instance without an administrator. Make another user an administrator first./api/v1/problems/account-moved(403): the user’s account moved to another account, so it cannot post, boost, react, follow, or vote. Cancel the move first (DELETE /accounts/move)./api/v1/problems/posting-restricted(403): a moderation action keeps the user’s account from posting: a post, an article, a post on an event’s board, an edit, or a boost. The user appeals it from Account status in the settings (/settings/account/statusof the web client)./api/v1/problems/interaction-restricted(403): a moderation action keeps the user’s account from interacting: following, favouriting, boosting, reacting, replying, quoting, or voting in a poll. The user appeals it as a posting restriction./api/v1/problems/current-session(409): the browser that asks cannot sign itself out throughDELETE /sessions/{id}; signing out ends it./api/v1/problems/account-not-moved(409): the user’s account has not moved, so there is no move to cancel./api/v1/problems/move-alias-missing(422): the account to move to does not list the user’s account among its aliases (alsoKnownAs). Add the alias on that account first./api/v1/problems/move-target-moved(422): the account to move to moved itself./api/v1/problems/move-target-unavailable(422): the account to move to is the user’s own, is not found, cannot be fetched from its server, or is suspended here./api/v1/problems/move-too-soon(422): the user’s account moved less than 30 days ago, also counting a canceled move;can_move_atsays from when it can move again./api/v1/problems/move-repeated(422): the user’s account moved to that account before, and it moves to an account once./api/v1/problems/maintenance(503): the server is under maintenance and answers every operation with this problem andRetry-After. Keep the tokens, show the maintenance, and retry afterRetry-After. Its members besides the standard ones, each present only when the operator set it:message, the administrators’ notice in plain text;until, when the maintenance is expected to end (RFC 3339); andstatus_page_url, the instance’s status page./api/v1/problems/custom-emoji-request-conflict(409): a request for a custom emoji is not in the state the operation needs, or was decided meanwhile./api/v1/problems/email-already-verified(409): the primary email address is already confirmed, so no confirmation mail is sent./api/v1/problems/hook-decision-not-overridable(409): the decision of a decision hook had no effect, or is arejectoflocal.status, which goes through its appeal./api/v1/problems/report-not-forwardable(409): the report cannot be forwarded to the target’s server: it came from another server, is about a local account or a voice chat room, or its target is gone./api/v1/problems/status-rejected(422): the server’s automated review refused the post and nothing was posted. The problem carrieshook_decision_idandappeal_deadline; the user may appeal (POST /hook_decisions/{id}/appeal)./api/v1/problems/profile-rejected(422): the server’s automated review refused the change of the profile, which stays as it was. It cannot be appealed; the user may change the profile and save it again./api/v1/problems/email-not-suppressed(409): the email address of the account is not suppressed, so there is nothing to lift./api/v1/problems/invalid-login-provider(422): a login provider breaks a rule;reasonsays which./api/v1/problems/invalid-role(422): a role change breaks a rule;reasonsays which./api/v1/problems/translation-failed(503): no translation provider returned a usable translation; asking again may work./api/v1/problems/translation-limit(429): a monthly limit on translated characters is reached, until the next month in UTC./api/v1/problems/translation-unavailable(422): no translation provider may receive the post./api/v1/problems/translation-unsupported-language(422): the translation providers do not translate the language./api/v1/problems/voice-already-invited(409): the account is already invited to the room./api/v1/problems/voice-cannot-speak(403): the participant may not speak in the room./api/v1/problems/voice-invalid-invitee(422): the account cannot be invited to the room./api/v1/problems/voice-invalid-participant(422): the account is not a participant that the operation can act on./api/v1/problems/voice-not-host-or-cohost(403): the operation is for the host and the co-hosts of the room./api/v1/problems/voice-too-many-cohosts(409): the room has as many co-hosts as it can./api/v1/problems/event-not-eligible(403): the user may not create events./api/v1/problems/event-not-organizer(403): the operation is for the organizer and the co-organizers of the event./api/v1/problems/event-organizer-only(403): the operation is for the organizer of the event./api/v1/problems/event-closed(409): the event was cancelled, or has started for an answer./api/v1/problems/event-full(409): the attendees who answergoingreached the capacity./api/v1/problems/event-voice-unavailable(422): the event cannot be held in a voice chat room: the voice chat is off, or its organizer may not host rooms./api/v1/problems/event-already-invited(409): the account is already invited to the event./api/v1/problems/event-invalid-invitee(422): the account cannot be invited to the event./api/v1/problems/event-invalid-coorganizer(422): the account cannot co-organize the event./api/v1/problems/event-too-many-coorganizers(409): the event has as many co-organizers as it can./api/v1/problems/event-not-attending(422): the account does not answergoingormaybe./api/v1/problems/event-attendee-organizes(422): the account organizes or co-organizes the event, so it always sees the places and is not approved or revoked./api/v1/problems/event-board-not-reader(403): the user sees the event but does not read its board: the user neither organizes it nor answersgoingormaybe./api/v1/problems/event-board-not-writer(403): the event’sboard_writersdo not let the user post on its board./api/v1/problems/event-board-closed(409): the board of the event is read-only: the event was cancelled, or 7 days have passed since its end (it is writable for the 7 days after the end)./api/v1/problems/event-unscheduled(409): the event polls its date and has none yet./api/v1/problems/event-scheduled(409): the date of the event was confirmed, so its date poll takes no more candidates, answers, or confirmations./api/v1/problems/event-last-candidate(409): the last candidate of a date poll cannot be withdrawn./api/v1/problems/search-unavailable(404): the server has no search engine, so posts cannot be searched (Instance.full_text_search.available)./api/v1/problems/search-failed(503): the search engine could not answer. Only the search of posts is affected; try again later./api/v1/problems/single-user-mode(404): the server is a one-person server (Instance.single_user), which does not offer the operation: the local and federated timelines, the suggestions of accounts, invites, the review of registrations, and the sign-up blocks. It works again when the server stops being one./api/v1/problems/single-user-requires-one-account(422): the instance settingsingle_usercan be turned on only while the server has exactly one local account;detailsays how many it has.
object
A URI that identifies the problem type, stable for clients to branch on.
It is about:blank when the problem means no more than its HTTP status.
A short summary of the problem type, localized from Accept-Language.
The HTTP status code.
An explanation of this occurrence, localized from Accept-Language.
The request ID (the X-Request-Id response header), for reporting the problem.
The member of the request that a 422 is about, by its name in the request: a property of
the JSON body by its path (display_name, fields[].name, poll.options[1]), a form
field, a query parameter, or a header (Idempotency-Key). detail then says what is
wrong with its value without naming it, for the client to show beside that field. Absent
when the problem is not about one member.
Example generated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "request_id": "example", "field": "example"}Headers
Section titled “Headers”The locale of title and detail.
Always no-store; problems are never cached.
The Bearer challenge of a 401 or a 403 insufficient_scope (RFC 6750 §3), with
error and, for insufficient_scope, the scope the operation needs.
The seconds to wait before retrying, on a 429 (for translation-limit, until the next
month in UTC) and on a 503 of the streaming endpoint.
For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt