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 } }