Users.messages: untrash

Removes the specified message from the trash. Try it now or see an example.

Request

HTTP request

POST https://www.googleapis.com/gmail/v1/users/userId/messages/id/untrash

Parameters

Parameter name Value Description
Path parameters
id string The ID of the message to remove from Trash.
userId string The user's email address. The special value me can be used to indicate the authenticated user.

Authorization

This request requires authorization with at least one of the following scopes:

Scope
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify

For more information, see the authentication and authorization page.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a Users.messages resource in the response body.

Examples

Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).

Java

Uses the Java client library.

import com.google.api.services.gmail.Gmail;

import java.io.IOException;

// ...

public class MyClass {

  // ...

  /**
   * Remove the specified message from Trash.
   *
   * @param service Authorized Gmail API instance.
   * @param userId User's email address. The special value "me"
   * can be used to indicate the authenticated user.
   * @param msgId ID of Message to remove from trash.
   * @throws IOException
   */
  public static void untrashMessage(Gmail service, String userId, String msgId)
      throws IOException {
    service.users().messages().untrash(userId, msgId).execute();
    System.out.println("Message with id: " + msgId + " has been untrashed.");
  }

  // ...
}

Try it!

Use the APIs Explorer below to call this method on live data and see the response.