REST API Error Codes
Any 4xx/5xx response contains JSON in this shape:
{ "code": "UNKNOWN_CHANNEL", "message": "Channel not found"}Rely on code — it’s a stable machine-readable identifier. message is a human hint localised to the client and may change.
Categories
Section titled “Categories”Most codes share a prefix that tells you what went wrong:
UNKNOWN_*— Object not foundMAX_*— Limit exceededCANNOT_*— Action forbidden in the current contextINVALID_*— Invalid dataMISSING_*— Required field or permission missing
All codes
Section titled “All codes”GENERAL_ERRORUNKNOWN_CHANNELUNKNOWN_GUILDUNKNOWN_INVITEUNKNOWN_MEMBERUNKNOWN_MESSAGEUNKNOWN_ROLEUNKNOWN_USERUNKNOWN_EMOJIUNKNOWN_PACKUNKNOWN_STICKERUNKNOWN_WEBHOOKUNKNOWN_FAVORITE_MEMEEXPLICIT_CONTENT_CANNOT_BE_SENTMAX_GUILDSMAX_FRIENDSMAX_PINS_PER_CHANNELMAX_GUILD_ROLESMAX_WEBHOOKSMAX_EMOJISMAX_STICKERSMAX_PACKSMAX_REACTIONSMAX_GUILD_CHANNELSMAX_CATEGORY_CHANNELSMAX_INVITESMAX_ANIMATED_EMOJISMAX_GUILD_MEMBERSMAX_WEBHOOKS_PER_GUILDRATE_LIMITEDSLOWMODE_RATE_LIMITEDCAPTCHA_REQUIREDINVALID_CAPTCHAUNAUTHORIZEDUSER_BANNED_FROM_GUILDUSER_IP_BANNED_FROM_GUILDMISSING_ACCESSCANNOT_EXECUTE_ON_DMCANNOT_EDIT_OTHER_USER_MESSAGECANNOT_SEND_EMPTY_MESSAGECANNOT_SEND_MESSAGES_TO_USERCANNOT_SEND_MESSAGES_IN_NON_TEXT_CHANNELCOMMUNICATION_DISABLEDMISSING_PERMISSIONSINVALID_FORM_BODYCANNOT_MODIFY_SYSTEM_WEBHOOKTWO_FACTOR_REQUIREDFRIEND_REQUEST_BLOCKEDCANNOT_SEND_FRIEND_REQUEST_TO_BLOCKED_USERBOTS_CANNOT_HAVE_FRIENDSCANNOT_SEND_FRIEND_REQUEST_TO_SELFALREADY_FRIENDSTWO_FA_NOT_ENABLEDMISSING_ACLIP_BANNEDUSER_NOT_IN_VOICECANNOT_MODIFY_VOICE_STATEVOICE_CHANNEL_FULLACCOUNT_DISABLEDACCOUNT_SCHEDULED_FOR_DELETIONINVALID_PHONE_NUMBERPHONE_ALREADY_USEDPHONE_VERIFICATION_REQUIREDINVALID_PHONE_VERIFICATION_CODEPHONE_RATE_LIMIT_EXCEEDEDSMS_MFA_NOT_ENABLEDSMS_MFA_REQUIRES_TOTPPHONE_REQUIRED_FOR_SMS_MFAINVALID_WEBAUTHN_CREDENTIALWEBAUTHN_CREDENTIAL_LIMIT_REACHEDUNKNOWN_WEBAUTHN_CREDENTIALPASSKEY_AUTHENTICATION_FAILEDPASSKEYS_DISABLEDGUILD_VERIFICATION_REQUIREDACCOUNT_SUSPICIOUS_ACTIVITYPREMIUM_PURCHASE_BLOCKEDPREMIUM_REQUIREDHARVEST_ON_COOLDOWNHARVEST_EXPIREDHARVEST_FAILEDHARVEST_NOT_READYUNKNOWN_HARVESTCHANNEL_INDEXINGAUDIT_LOG_INDEXINGUNKNOWN_GIFT_CODEGIFT_CODE_ALREADY_REDEEMEDPAYMENT_ERRORWEBHOOK_VERIFICATION_ERRORUSER_OWNS_GUILDSFEATURE_TEMPORARILY_DISABLEDINVITES_DISABLEDGUILD_DISALLOWS_UNCLAIMED_ACCOUNTSTEMPORARY_INVITE_REQUIRES_PRESENCEMAX_GROUP_DM_RECIPIENTSMAX_GROUP_DMSNOT_FRIENDS_WITH_USERINVALID_CHANNEL_TYPENSFW_CONTENT_AGE_RESTRICTEDFILE_SIZE_TOO_LARGECANNOT_REPORT_OWN_MESSAGECANNOT_REPORT_YOURSELFCANNOT_REPORT_OWN_GUILDREPORT_BANNEDMAX_BOOKMARKSMAX_PACK_EXPRESSIONSMAX_FAVORITE_MEMESCANNOT_SHRINK_RESERVED_SLOTSMEDIA_METADATA_ERRORNO_ACTIVE_CALLCALL_ALREADY_EXISTSINVALID_CHANNEL_TYPE_FOR_CALLUNCLAIMED_ACCOUNT_RESTRICTEDINVALID_CLIENTINVALID_REQUESTINVALID_SCOPEUNSUPPORTED_RESPONSE_TYPEINVALID_GRANTACCESS_DENIEDINVALID_TOKENSUDO_MODE_REQUIREDINVALID_SUDO_TOKENINSTANCE_VERSION_MISMATCHINVALID_HANDOFF_CODEHANDOFF_CODE_EXPIREDNO_ACTIVE_SUBSCRIPTIONUNKNOWN_VOICE_REGIONUNKNOWN_VOICE_SERVERUNKNOWN_REPORTREPORT_ALREADY_RESOLVEDTEST_HARNESS_DISABLEDTEST_HARNESS_FORBIDDENEMAIL_SERVICE_NOT_TESTABLEINVALID_FLAGS_FORMATINVALID_ACLS_FORMATACLS_MUST_BE_NON_EMPTYUNKNOWN_USER_FLAGUNKNOWN_SUSPICIOUS_FLAGINVALID_SUSPICIOUS_FLAGS_FORMATNO_PENDING_DELETIONINVALID_TIMESTAMPINVALID_BOT_FLAGCANNOT_TRANSFER_OWNERSHIP_TO_BOTBOT_USER_AUTH_ENDPOINT_ACCESS_DENIEDBOT_USER_AUTH_SESSION_CREATION_DENIEDINVALID_SYSTEM_FLAGMISSING_OAUTH_FIELDSDELETION_FAILEDPROCESSING_FAILEDUPDATE_FAILEDCREATION_FAILEDINVALID_DSA_REPORT_TARGETINVALID_DSA_TICKETINVALID_DSA_VERIFICATION_CODEPACK_ACCESS_DENIEDINVALID_PACK_TYPEBAD_GATEWAYGATEWAY_TIMEOUTSERVICE_UNAVAILABLE