imap
IMAP Response Codes
Status responses and response codes returned by IMAP servers. Status responses (OK, NO, BAD, PREAUTH, BYE) indicate the outcome of commands or connection state; response codes appear in brackets within those responses to convey additional detail.
35 codes
· All codes 35 codes
- ALERT ALERT The human-readable text in the response contains a special alert that must be presented to the user. Servers use this for urgent notices that demand immediate attention.
- ALREADYEXISTS ALREADYEXISTS The operation failed because a mailbox with the specified name already exists. Returned in response to CREATE or RENAME when the target name is already in use.
- APPENDUID APPENDUID Reports the UIDVALIDITY and UID assigned to a message after a successful APPEND command. Defined by the UIDPLUS extension.
- AUTHENTICATIONFAILED AUTHENTICATIONFAILED Authentication failed because the credentials were rejected; the user exists but the password or token was wrong. Distinct from UNAVAILABLE, which indicates a transient server-side problem.
- AUTHORIZATIONFAILED AUTHORIZATIONFAILED Authentication succeeded but the authorisation step failed; the authenticated identity is not permitted to act as the requested authorisation identity.
- BAD BAD The client sent a command that the server cannot parse or that violates the protocol. As a tagged response, it indicates an error in the specific command; as an untagged response, it indicates a protocol error that may not be associated with any command.
- BADCHARSET BADCHARSET The SEARCH command failed because the requested charset is not supported. The response may include a parenthesised list of charsets the server does support.
- BYE BYE The server is about to close the connection. Sent either as a farewell on a client-initiated LOGOUT or when the server closes the connection due to an error or inactivity.
- CANNOT CANNOT The operation cannot be performed because of a permanent condition in the current state of the mailbox or server, and the request should not be retried without a change in state.
- CAPABILITY CAPABILITY Lists the server capabilities as part of a status response, allowing the client to learn supported extensions without issuing a separate CAPABILITY command.
- CLIENTBUG CLIENTBUG The operation failed because the client sent a syntactically valid but semantically incorrect command sequence. The client implementation has a defect that should be corrected.
- CONTACTADMIN CONTACTADMIN The operation failed for an administrative reason that the user cannot resolve themselves. The user should contact the server administrator for assistance.
- COPYUID COPYUID Reports the UIDVALIDITY and the source-to-destination UID mapping after a successful COPY command. Defined by the UIDPLUS extension.
- CORRUPTION CORRUPTION The server detected data corruption in the mailbox or message store that prevented the operation from completing. The problem requires server-side investigation and remediation.
- EXPIRED EXPIRED Authentication failed because the user's credentials or account have expired. The user must take action outside the IMAP session to renew access.
- EXPUNGEISSUED EXPUNGEISSUED One or more messages were expunged by another session while this command was executing, which may have caused sequence numbers to shift. The client should reconcile its local message list.
- INUSE INUSE The operation failed because a resource (such as a mailbox) is already in use by another session or process. The client may retry after the lock is released.
- LIMIT LIMIT The operation failed because a server-imposed limit was reached, such as a maximum number of connections, flags, or messages. The response text provides further detail.
- NO NO The requested operation failed. As an untagged response, it signals a warning; as a tagged response, it signals that the command did not succeed.
- NONEXISTENT NONEXISTENT The operation failed because the specified mailbox does not exist. Returned when a command targets a mailbox that has not been created.
- NOPERM NOPERM The authenticated user lacks the access rights required to perform the requested operation on the target mailbox or resource.
- OK OK The requested operation succeeded. As an untagged response, it conveys informational text and may include a response code; as a tagged response, it signals successful completion of the associated command.
- OVERQUOTA OVERQUOTA The operation failed because it would exceed the user's or mailbox's storage quota. The user must free space before the operation can succeed.
- PARSE PARSE The server encountered an error parsing the headers or structure of a message in the mailbox. The command completed, but the affected message may be inaccessible.
- PERMANENTFLAGS PERMANENTFLAGS Lists the flags that the client can set permanently on messages in the selected mailbox. If the list includes \*, the client may also create new keywords by setting them.
- PREAUTH PREAUTH The connection has already been authenticated by an external mechanism, and the client does not need to issue a LOGIN or AUTHENTICATE command. Only sent as an untagged greeting response.
- PRIVACYREQUIRED PRIVACYREQUIRED The operation cannot proceed over the current unencrypted or insufficiently secure connection. The client must establish a secure connection (e.g. via STARTTLS) before retrying.
- READ-ONLY READ-ONLY The mailbox was selected in read-only mode; flag changes and message deletions are not permitted. Returned in the OK response to a SELECT or EXAMINE command.
- READ-WRITE READ-WRITE The mailbox was selected in read-write mode; the client may modify flags and delete messages. Returned in the OK response to a SELECT command.
- SERVERBUG SERVERBUG The operation failed due to a server implementation defect. The client is not at fault and should report the issue to the server operator.
- TRYCREATE TRYCREATE The APPEND or COPY command failed because the target mailbox does not exist. The client may resolve this by creating the mailbox first and retrying.
- UIDNEXT UIDNEXT Reports the next unique identifier value that will be assigned to a new message in the mailbox. Clients may use this to detect new arrivals since the last session.
- UIDVALIDITY UIDVALIDITY Reports the unique identifier validity value for the selected mailbox. If this value changes between sessions, all cached UIDs for that mailbox must be discarded.
- UNAVAILABLE UNAVAILABLE The server is temporarily unable to authenticate the user, for instance because a back-end authentication service is down. The client may retry later.
- UNSEEN UNSEEN Reports the sequence number of the first unseen message in the mailbox. Clients may use this to position display to the first unread message.