Try the API in your browser

Every endpoint in the API Reference has a built-in console — click Try It! on any endpoint to call the live API directly from your browser, with no code required.

One-time setup

1. Register an application

If you haven't already, register a DeviantArt application to obtain a client_id (and, for confidential clients, a client_secret).

2. Whitelist the console's redirect URI

On your Applications page, add the following URI to your redirect whitelist:

https://deviantart.readme.io/oauth2-redirect

This is where the console returns the user after they authorize your app. Without it, the OAuth flow will be rejected with a non-whitelisted URI error.

Using the console

1. Open any endpoint in the API Reference.
2. In the right-hand panel, expand the Authentication section.
3. Enter your client_id and client_secret, then click Authorize to run the OAuth flow. You'll be redirected to DeviantArt to log in and approve the app, then returned to the console with an access token already in place.
4. Fill in any required path, query, or body parameters.
5. Click Try It!.

The response appears beneath the request, exactly as your client would receive it in production.

Public (PKCE) clients

Public clients don't have a real client_secret, but the console's authorize form requires something in that field. Enter any placeholder — 123 is fine — and the console will use PKCE to authenticate instead. The placeholder value is never sent to DeviantArt; it only satisfies the form's validation.

Notes

• The console honors whatever OAuth scopes your application is configured for. If a call returns unauthorized, double-check the app's scope list.
• Tokens issued through the console are real, full-strength access tokens — don't paste them into screenshots or share them.
• The redirect URI above is specific to this docs site. The console on another ReadMe-hosted project would use a different URI; only whitelist https://deviantart.readme.io/oauth2-redirect if you actually want to use this console.