Search
K
OAuth 2.0

Using client credentials

Use the token endpoint to retrieve an access token which can be used to authorize API
requests. This endpoint supports the Authorization Code grant, the Refresh Token grant and the Client Credentials grant.

post
/v6/authentication/oauth2/token{client_credentials}

Body

application/x-www-form-urlencoded
client_idstring

Application client ID.

Example:00000000-0000-0000-0000-000000000000

client_secretstring

Application client secret.

Example:00000000-0000-0000-0000-000000000000

grant_typestring

Identifies the grant type being used. For Authorization Code grant use authorization_code.

Example:authorization_code, refresh_token, client_credentials

scopestring

List of scopes to request to be granted to the access token. Can only be a subset of the scopes requested in the Authorize application request. When not passed, all the scopes will be requested.

Example:offline asset:read

Response

200 application/json

Successful response

access_tokenstring

Example:eyJh...NDcw

expires_ininteger

Example:3600

refresh_tokenstring

Example:c12e...b5dc

scopestring

Example:offline asset:read

token_typestring

Example:bearer

200 application/json

Using a refresh token

Use the token endpoint to retrieve an access token which can be used to authorize API
requests. This endpoint supports the Authorization Code grant, the Refresh Token grant and the Client Credentials grant.

post
/v6/authentication/oauth2/token{refresh}

Body

application/x-www-form-urlencoded
client_idstring

Application client ID.

Example:00000000-0000-0000-0000-000000000000

client_secretstring

Application client secret.

Example:00000000-0000-0000-0000-000000000000

grant_typestring

Identifies the grant type being used. For Authorization Code grant use authorization_code.

Example:authorization_code, refresh_token, client_credentials

refresh_tokenstring

Refresh token returned from the Retrieve token request.

Example:c11e...b5bc

Response

200 application/json

Successful response

access_tokenstring

Example:eyJh...NDcw

expires_ininteger

Example:3600

refresh_tokenstring

Example:c12e...b5dc

scopestring

Example:offline asset:read

token_typestring

Example:bearer

200 application/json

Retrieve scopes

Retrieve a JSON formatted overview of the existing scopes within Bynder and the required user permissions.

get
/v6/authentication/oauth2/scopes

Response

200 application/json

Successful response

groupsarray[object]
Show Child Parameters
200 application/json