Delete an email address for the authenticated user

DELETE

/user/emails

This endpoint is accessible with the user scope.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://api.github.com/user/emails' \
--header 'Content-Type: application/json' \
--data-raw '{
    "emails": [
        "octocat@github.com",
        "mona@github.com"
    ]
}'

Response Example

204 - Example 1

{}

Request

Body Params application/json

optional

One of

object

array[string]

string

Deletes one or more email addresses from your GitHub account. Must contain at least one email address. Note: Alternatively, you can pass a single email address or an array of emails addresses directly, but we recommend that you pass an object using the emails key.

Example:

{"emails":["octocat@github.com","mona@github.com"]}

emails

array[string]

required

Email addresses associated with the GitHub user account.

Examples

Responses

🟢204Response

application/json

Body

object {0}

🔵304304

🟠401401

🟠403403

🟠404404

🟠422422

Modified at 2023-08-15 02:59:30

Set primary email visibility for the authenticated user

List email addresses for the authenticated user