POST /oauth/downgrade

Required authentication: Application
Supported formats: json

Downgrades the scope of the OAuth grant identified by the submitted grant_id.

If the scope of the grant is read_write, it will change to read. If the scope was already read, the grant object is returned unchanged (read is the lowest permission scope).

Downgraded grants cannot be upgraded later, this change is permanent.

This method is designed to allow your application to proactively relinquish rights to a user’s account if you no longer need read_write scope.

Parameter Type Atn Details
grant_id UUID The grant_id for the OAuth grant to downgrade.

Example Requests

Downgrade an OAuth grant

POST https://api.scryfall.com/oauth/downgrade
Host: api.scryfall.com
Content-Type: application/json
Authorization: Bearer cs-ExampleSecret

{
  "grant_id": "39fd91e0-897e-4d9c-91b2-69a9ee4b0829"
}

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8

{
  "object": "oauth_grant",
  "grant_id": "39fd91e0-897e-4d9c-91b2-69a9ee4b0829",
  "created_at": "2022-05-26T13:29:02-04:00",
  "scope": "read",
  "revoked": false,
  "account": {
    "object": "scryfall_account",
    "id": "6952a77a-14a3-4fac-b397-3e27f41547ec",
    "username": "amoeboi",
    "display_name": "Amoeboid Changeling",
    "twitter": "wizards_magic",
    "verified": false,
    "supporter": false
  }
}