Modifying message attributes
Prev | Appendix A. Simple Mail Access Protocol, Version 1 | Next

### Modifying message attributes

C: STORE 4 6-7 +FLAGS=DELETED
S: * FETCH 4 FLAGS=SEEN,DELETED
S: * FETCH 6 FLAGS=SEEN,DELETED
S: * FETCH 7 FLAGS=SEEN,DELETED
S: +OK STORE completed
C: STORE 4 "INTERNALDATE=Mon, 20 Jan 2003 18:43:09 -0500"
S: * FETCH 4 "INTERNALDATE=Mon, 20 Jan 2003 18:43:09 -0500"
S: +OK STORE completed

The `STORE` command updates attributes of existing messages. A list of message numbers, as whitespace-delimited words, follows the `STORE`. “`m`-`n`” designates messages #m through #n, inclusively.

One or more words follow the message number list; they specify which attributes to set. Attribute settings are generally specified as `name`=`value`. As is with the `FETCH` command, servers should ignore attributes they do not recognize. The following attributes are defined at this time:

FLAGS=`list`

  Sets the messages flags precisely to `list`, which is a comma-separated list of message flags. See “Reading message attributes” for a list of defined message flags.

+FLAGS=`list`

  Adds the flags in `list` to the messages' flags. Other flags, if they are set for a message, remain set.

-FLAGS=`list`

  Remove the flags in `list` from the messages' flags. Other flags, if they are set for a message, remain set.

KEYWORDS=`list`

  If the server's capability list includes “`KEYWORD`”, then set the keywords associated with the message to `list`, which is a comma-separated list of keywords. See “SMAP connection negotiation” for more information.

+KEYWORDS=`list`

  Adds keywords named in `list`, which is a comma-separated list of keywords, to the existing keywords already set for the message. Existing keywords remain unaffected.

-KEYWORDS=`list`

  Removes keywords named in `list`, which is a comma-separated list of keywords, from the list of existing keywords associated with this message.

INTERNALDATE=`date`

  Set the `INTERNALDATE` timestamp on a message to `date`, which is an RFC-2822 formatted date/time value. See “Reading message attributes” for more information on the `INTERNALDATE` attribute.

The server's response includes “`* FETCH`” single line replies that give the updated attributes of all affected messages. This is specifically needed when updating message flags, and is optional when updating `INTERNALDATE`s (there's not much point in echoing back the same timestamp).

Prev | Up | Next
Reading message contents | Home | ToC | More comments on concurrency