Authentication Extras

Convert OAuth 1 access tokens to OAuth 2 access tokens

POST https://api.vimeo.com/oauth/authorize/vimeo_oauth1 Playground
Name Type Required Description
grant_type enum
  • vimeo_oauth1
Yes

Grant type. Must be set to "vimeo_oauth1".

token string Yes

OAuth 1 token

token_secret string Yes

OAuth 1 token secret

HTTP Status Code Explanation
200 OK

400 Bad Request

If the supplied token is invalid.

400 Bad Request

If the supplied token has unauthorized scopes.

Exchange an authorization code for an access token

POST https://api.vimeo.com/oauth/access_token Playground
Name Type Required Description
code string Yes

The authorization code received from the authorization server.

grant_type enum
  • authorization_code
Yes

Grant type. Must be "authorization_code".

redirect_uri string Yes

URI to redirect the user to. Must match the redirect URI from /oauth/authorize.

HTTP Status Code Explanation
200 OK

400 Bad Request

If an unsupported grant_type is used.

400 Bad Request

If the given authorization code is invalid.

400 Bad Request

If the provided redirect_uri does not match the URI to create the authorization code.

OAuth client authorization

For more information on how to utilize this, check out our authentication documentation, or see the "Client Credentials Grant" section of the OAuth spec.

POST https://api.vimeo.com/oauth/authorize/client Playground
Name Type Required Description
grant_type enum
  • client_credentials
Yes

Grant type. Must be set to client_credentials.

scope string Yes

This is a space-separated list of authentication scopes you want to access. Defaults to public.

Revoke the current access token

This allows for an app to notify that it is done with a token and it should be discarded.

DELETE https://api.vimeo.com/tokens Playground
HTTP Status Code Explanation
204 No Content

400 Bad Request

If you attempt this with an OAuth 1 token.

Verify an OAuth 2 token

GET https://api.vimeo.com/oauth/verify Playground
HTTP Status Code Explanation
200 OK

401 Unauthorized

If the provided token is not a valid OAuth 2 token.

Send Feedback