# Refresh access token

Exchanges a refresh token for a new access and refresh token pair.

Endpoint: POST /auth/refresh
Version: 1.0

## Request fields (application/x-www-form-urlencoded):

  - `refresh_token` (string)
    The refresh token you got from a previous request
    Example: "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJDYjZZbGdHeWNrR3JjWWRxcmNFcUphdW5IRTVfdk5ZMTFjUVIwdHlmX3RvIn0.eyJqdGkiOiI2OTNiYjhiMS0yZjhjLTQzOGYtYjViNy1jY2RlNDRkYmZhNWMiLCJleHAiOjE2MDY4MTY4MTEsIm5iZiI6MCwiaWF0IjoxNjA2NzMwNDExLCJpc3MiOiJodHRwczovL3Nzby1zdGcuc2ltYWNhbi5jb20vYXV0aC9yZWFsbXMvc2ltYWNhbl90cmFuc3BvcnRfY2xvdWQiLCJhdWQiOiJhdXRoLWFwaSIsInN1YiI6IjRlNTBjOWNkLTQ4OGEtNDdiOS05MDU4LWNlYTIzMGRiZTNiYSIsInR5cCI6IlJlZnJlc2giLCJhenAiOiJhdXRoLWFwaSIsImF1dGhfdGltZSI6MCwic2Vzc2lvbl9zdGF0ZSI6IjljMjkzMWNkLWU1NjMtNDhjNS05YTUxLWFiMGE4ODNlYWI5YyIsInJlc291cmNlX2FjY2VzcyI6e30sInNjb3BlIjoiIn0.j1XcwIZhfcMj8nCvCOyEXEPiVMvnarpvayEDsCNfZhTWQviH6aTT69BLjM_D-hRipfiQPjiSFjujVwYCT5iFAXnQgV0CjBvb8CO1acxU5lY283ckhHF9cmKm5BxwtBCgj30ELDRSDUvYT_J4fAZU05GXkZQtCGSkZS-Ab8J45it4_EFv_k-mi7fpzrQkLM8LhqUJL90DmQRbbheaEdaZ4CUVwhQRIiX0NKJLvpOB2Ne8CS2eZc2g4TwJknqdg_1UUjkgvUPA-Z1qVYAel9ASygNDn4LYrnrlxZ3bvXw1vXk71l06KGi3vZMt33ipzrucAJuP8_I2lMrERnT57nZCqg"

## Response 200 fields (application/json):

  - `access_token` (string)
    Access token to be used as Bearer Authentication
    Example: "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJDYjZZbGdHeWNrR3JjWWRxcmNFcUphdW5IRTVfdk5ZMTFjUVIwdHlmX3RvIn0.eyJqdGkiOiI1MzIyMWJmZC1lN2JkLTQzMTgtODhhMS1hZWNhNDgwOGQ1ODgiLCJleHAiOjE2MDY3MzQwMTEsIm5iZiI6MCwiaWF0IjoxNjA2NzMwNDExLCJpc3MiOiJodHRwczovL3Nzby1zdGcuc2ltYWNhbi5jb20vYXV0aC9yZWFsbXMvc2ltYWNhbl90cmFuc3BvcnRfY2xvdWQiLCJhdWQiOiJhdXRoLWFwaSIsInN1YiI6IjRlNTBjOWNkLTQ4OGEtNDdiOS05MDU4LWNlYTIzMGRiZTNiYSIsInR5cCI6IkJlYXJlciIsImF6cCI6ImF1dGgtYXBpIiwiYXV0aF90aW1lIjowLCJzZXNzaW9uX3N0YXRlIjoiOWMyOTMxY2QtZTU2My00OGM1LTlhNTEtYWIwYTg4M2VhYjljIiwiYWNyIjoiMSIsImFsbG93ZWQtb3JpZ2lucyI6W10sInJlc291cmNlX2FjY2VzcyI6e30sInNjb3BlIjoiIiwibmFtZSI6ImFwaS1kZW1vLWFjY291bnRAc2ltYWNhbi5jb20gYXBpLWRlbW8tYWNjb3VudEBzaW1hY2FuLmNvbSIsInByZWZlcnJlZF91c2VybmFtZSI6ImFwaS1kZW1vLWFjY291bnRAc2ltYWNhbi5jb20iLCJnaXZlbl9uYW1lIjoiYXBpLWRlbW8tYWNjb3VudEBzaW1hY2FuLmNvbSIsImZhbWlseV9uYW1lIjoiYXBpLWRlbW8tYWNjb3VudEBzaW1hY2FuLmNvbSIsImVtYWlsIjoiYXBpLWRlbW8tYWNjb3VudEBzaW1hY2FuLmNvbSJ9.UhZo-Duy7EeeIZqdjgBJki3qr8bOJSqS-MBv8WEN3-GuZP2NiBTnK4MsmA8r9KxcijMXPTwJUHYoKi4h0elsiuRWythP3BwZfC_PzSDMNEAxNL4dTh6H671f3GlJfGVk74xJvaq1gDlaHIJ-2Z-HK_7zSqNv9lOUF8puyZ5esu_XIyxRPKbXkIuwbqSh_8eIt9tyP8og33JZ22srnT41f30k2bOuZWrAuZ-jw1Fx47aB7AMQRvFNjVidUI8L_TQXjA0oAeBsawC7PkYaBqsTl_xEihj4qbHlVTmYoSLZa19OLRSQsd6bLLK768Oatw-wLSeINcnkbP41OnMowBTSUQ"

  - `refresh_token` (string)
    Credential to be used to refresh access token
    Example: "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJDYjZZbGdHeWNrR3JjWWRxcmNFcUphdW5IRTVfdk5ZMTFjUVIwdHlmX3RvIn0.eyJqdGkiOiI2OTNiYjhiMS0yZjhjLTQzOGYtYjViNy1jY2RlNDRkYmZhNWMiLCJleHAiOjE2MDY4MTY4MTEsIm5iZiI6MCwiaWF0IjoxNjA2NzMwNDExLCJpc3MiOiJodHRwczovL3Nzby1zdGcuc2ltYWNhbi5jb20vYXV0aC9yZWFsbXMvc2ltYWNhbl90cmFuc3BvcnRfY2xvdWQiLCJhdWQiOiJhdXRoLWFwaSIsInN1YiI6IjRlNTBjOWNkLTQ4OGEtNDdiOS05MDU4LWNlYTIzMGRiZTNiYSIsInR5cCI6IlJlZnJlc2giLCJhenAiOiJhdXRoLWFwaSIsImF1dGhfdGltZSI6MCwic2Vzc2lvbl9zdGF0ZSI6IjljMjkzMWNkLWU1NjMtNDhjNS05YTUxLWFiMGE4ODNlYWI5YyIsInJlc291cmNlX2FjY2VzcyI6e30sInNjb3BlIjoiIn0.j1XcwIZhfcMj8nCvCOyEXEPiVMvnarpvayEDsCNfZhTWQviH6aTT69BLjM_D-hRipfiQPjiSFjujVwYCT5iFAXnQgV0CjBvb8CO1acxU5lY283ckhHF9cmKm5BxwtBCgj30ELDRSDUvYT_J4fAZU05GXkZQtCGSkZS-Ab8J45it4_EFv_k-mi7fpzrQkLM8LhqUJL90DmQRbbheaEdaZ4CUVwhQRIiX0NKJLvpOB2Ne8CS2eZc2g4TwJknqdg_1UUjkgvUPA-Z1qVYAel9ASygNDn4LYrnrlxZ3bvXw1vXk71l06KGi3vZMt33ipzrucAJuP8_I2lMrERnT57nZCqg"

  - `token_type` (string)
    Type of tokens supplied
    Example: "bearer"

  - `expires_in` (number)
    Expiration time for access token in seconds
    Example: "3600"

## Response 401 fields (application/json):

  - `error` (string)
    Example: "invalid_grant"

  - `error_description` (string)
    Example: "Refresh token expired"