---
title: "Using a refresh token"
url: "https://earlyaccess.developers.bynder.com/apis/o-auth-20-1/versions/09a25bc1-038b-40be-a677-10c314a6ec04/paths/v6-authentication-oauth2-token-refresh/post"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/o-auth-20-1/versions/09a25bc1-038b-40be-a677-10c314a6ec04.md

# Using a refresh token

`POST` `/v6/authentication/oauth2/token{refresh}`

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.

## Request body (required)

Content types: `application/x-www-form-urlencoded`

## Responses

- `200` - Successful response

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: OAuth 2.0
  version: 1.0.0
paths:
  /v6/authentication/oauth2/token{refresh}:
    post:
      description: >
        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.
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              properties:
                client_id:
                  description: Application client ID.
                  example: 00000000-0000-0000-0000-000000000000
                  type: string
                client_secret:
                  description: Application client secret.
                  example: 00000000-0000-0000-0000-000000000000
                  type: string
                grant_type:
                  description: Identifies the grant type being used. For Authorization Code grant
                    use **authorization_code**.
                  example:
                    - authorization_code
                    - refresh_token
                    - client_credentials
                  type: string
                refresh_token:
                  description: Refresh token returned from the Retrieve token request.
                  example: c11e...b5bc
                  type: string
              type: object
        required: true
      responses:
        "200":
          content:
            application/json:
              examples:
                example-1:
                  value:
                    access_token: eyJh...NDcw
                    expires_in: 3600
                    scope: offline asset:read
                    token_type: bearer
              schema:
                properties:
                  access_token:
                    example: eyJh...NDcw
                    type: string
                  expires_in:
                    example: 3600
                    type: integer
                  refresh_token:
                    example: c12e...b5dc
                    type: string
                  scope:
                    example: offline asset:read
                    type: string
                  token_type:
                    example: bearer
                    type: string
                type: object
          description: Successful response
      summary: Using a refresh token
      tags:
        - Token endpoint
```