Skip to main content
Resend Docs

Search documentation

Type to search this documentation.

On this pageOverview

Revoke Grant

DELETE

/

oauth

/

grants

/

:oauth_grant_id

Node.js
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.oauthGrants.revoke(
  '650e8400-e29b-41d4-a716-446655440001',
);
Rust
use resend_rs::{Resend, Result};

#[tokio::main]
async fn main() -> Result<()> {
  let resend = Resend::new("re_xxxxxxxxx");

  let _data = resend
    .oauth
    .revoke("650e8400-e29b-41d4-a716-446655440001")
    .await?;

  Ok(())
}
cURL
curl -X DELETE 'https://api.resend.com/oauth/grants/650e8400-e29b-41d4-a716-446655440001' \
     -H 'Authorization: Bearer re_xxxxxxxxx'
CLI
resend oauth-grants revoke 650e8400-e29b-41d4-a716-446655440001
Response
{
  "object": "oauth_grant",
  "id": "650e8400-e29b-41d4-a716-446655440001",
  "revoked_at": "2026-04-08T00:11:13.110Z",
  "revoked_reason": "revoked_from_api"
}

Revoking a grant invalidates every access and refresh token issued under it. Any team API key can revoke any of the team’s grants. Returns 404 if the grant does not exist or was already revoked.

Node.js
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.oauthGrants.revoke(
  '650e8400-e29b-41d4-a716-446655440001',
);
Rust
use resend_rs::{Resend, Result};

#[tokio::main]
async fn main() -> Result<()> {
  let resend = Resend::new("re_xxxxxxxxx");

  let _data = resend
    .oauth
    .revoke("650e8400-e29b-41d4-a716-446655440001")
    .await?;

  Ok(())
}
cURL
curl -X DELETE 'https://api.resend.com/oauth/grants/650e8400-e29b-41d4-a716-446655440001' \
     -H 'Authorization: Bearer re_xxxxxxxxx'
CLI
resend oauth-grants revoke 650e8400-e29b-41d4-a716-446655440001
JSON
{
  "object": "oauth_grant",
  "id": "650e8400-e29b-41d4-a716-446655440001",
  "revoked_at": "2026-04-08T00:11:13.110Z",
  "revoked_reason": "revoked_from_api"
}

Was this page helpful?

⌘I

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu