Skip to content
getgeolens.com
GeoLens Docs

Refresh

POST
/auth/refresh/
 
curl --request POST \
  --url https://example.com/auth/refresh/ \
  --header 'Content-Type: application/json' \
  --data '{ "refresh_token": "example" }'

Exchange a valid refresh token for a new access + refresh token pair.

Request Body required

Section titled “Request Body required ”
Media type application/json
RefreshRequest
object
refresh_token
required
Refresh Token
string
<= 512 characters
Example generated
{
  "refresh_token": "example"
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

Media type application/json
TokenResponse
object
access_token
required
Access Token

JWT access token for Authorization header

string
expires_in
required
Expires In

Seconds until the access token expires

integer
refresh_token
required
Refresh Token

Opaque token used to obtain a new access token

string
token_type
Token Type
string
default: bearer
Example 
{
  "token_type": "bearer"
}

400

Section titled “400 ”

Bad request — invalid query parameters or payload

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}

401

Section titled “401 ”

Unauthorized — missing or invalid credentials

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}

403

Section titled “403 ”

Forbidden — caller lacks access to this resource

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}

404

Section titled “404 ”

Not found

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}

422

Section titled “422 ”

Validation error

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}

500

Section titled “500 ”

Internal server error

ProblemDetail
object
detail
required
Detail
string
status
required
Status
integer
title
required
Title
string
type
Type
string
default: about:blank
Example 
{
  "type": "about:blank"
}