eBay Trading APIVersion 1161

ReviseMyMessagesRequestType ( AbstractRequestType )

This call can be used to mark one or more messages as 'Read', to flag one or more messages, and/or to move one or more messages to another My Messages folder. Any of these actions can be applied on up to 10 messages with one call.

Call that uses ReviseMyMessagesRequestType:

Fields

AlertIDs ( MyMessagesAlertIDArrayType )


AlertIDs ( MyMessagesAlertIDArrayType ) [0..1]
Not used by any call.

This field is deprecated.
See the Field Index to learn which calls use AlertIDs.

Flagged ( boolean ) [0..1]
This boolean field is used to change the 'Flagged' status of the message(s) in the MessageIDs container. Including this field and setting its value to true will flag all messages in the MessageIDs container. Conversely, including this field and setting its value to false will unflag all messages in the MessageIDs container. The 'Flagged' status of a message can be retrieved by looking at the Message.Flagged boolean field of the GetMyMessages call response.

In each ReviseMyMessages call, at least one of the following fields must be specified in the request: Read, Flagged, and FolderID.

Note: Messages in the Sent folder of My Messages cannot be moved, marked as read, or flagged.
See the Field Index to learn which calls use Flagged.

FolderID ( long ) [0..1]
A unique identifier of My Messages folder. A FolderID value is supplied if the user want to move the message(s) in the MessageIDs container to a different folder. FolderID values can be retrieved with the GetMyMessages call with the DetailLevel value set to ReturnSummary.

In each ReviseMyMessages call, at least one of the following fields must be specified in the request: Read, Flagged, and FolderID.

Note: Messages in the Sent folder of My Messages cannot be moved, marked as read, or flagged.
See the Field Index to learn which calls use FolderID.

This container is used to specify up to 10 messages (specified with their MessageID values) on which to perform on or more actions. At least one MessageID value must be included in the request. MessageID values can be retrieved with the GetMyMessages call with the DetailLevel value set to ReturnHeaders.

Note: Messages in the Sent folder of My Messages cannot be moved, marked as read, or flagged.
See the Field Index to learn which calls use MessageIDs.

Read ( boolean ) [0..1]
This boolean field is used to change the 'Read' status of the message(s) in the MessageIDs container. Including this field and setting its value to true will mark all messages in the MessageIDs container as 'Read'. Conversely, including this field and setting its value to false will mark all messages in the MessageIDs container as 'Unread'. The 'Read' status of a message can be retrieved by looking at the Message.Read boolean field of the GetMyMessages call response.

In each ReviseMyMessages call, at least one of the following fields must be specified in the request: Read, Flagged, and FolderID.

Note: Messages in the Sent folder of My Messages cannot be moved, marked as read, or flagged.
See the Field Index to learn which calls use Read.