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

The grant type. Must be set to vimeo_oauth1.

token string Yes

The OAuth 1 token.

token_secret string Yes

The OAuth 1 token secret.

HTTP Status Code Explanation
200 OK

The tokens were converted.

400 Bad Request

The token is invalid.

400 Bad Request

The 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

The grant type. Must be set to authorization_code.

redirect_uri string Yes

The redirect URI. Must match the URI from /oauth/authorize.

HTTP Status Code Explanation
200 OK

The authorization code was exchanged.

400 Bad Request

The grant type is invalid.

400 Bad Request

The authorization code is invalid.

400 Bad Request

The redirect URI does not match the URI to create the authorization code.

OAuth client authorization

For information on utilizing OAuth client authorization, see our authentication documentation or the Client Credentials Grant section of the [OAuth spec](tools.ietf.org/html/draft-ietf-oauth-v2-31.

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

The grant type. Must be set to client_credentials.

scope string Yes

A space-separated list of the authentication scopes that you want to access. The default is public.

Revoke the current access token

This method enables an app to notify the API that it is done with a token and that the token can be discarded.

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

The token was revoked.

400 Bad Request

You cannot revoke access for an OAuth 1 token.

Verify an OAuth 2 token

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

The token was verified.

401 Unauthorized

The token is not a valid OAuth 2 token.

Send Feedback