Skip to main content
POST
/
token
/
company
Refresh Token
curl --request POST \
  --url https://stagingstores.xoxoday.com/chef/v1/oauth/token/company \
  --header 'Content-Type: application/json' \
  --data '
{
  "grant_type": "refresh_token",
  "refresh_token": "XXXXXXXXX",
  "client_id": "XXXXXXXXX",
  "client_secret": "XXXXXXXXX"
}
'
{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer",
  "expires_in": 1296000,
  "refresh_token": "dGhpcyBpcyBhIHJlZnJlc2ggdG9rZW4...",
  "access_token_expiry": 1718000000000,
  "refresh_token_expiry": 1720000000000
}

Documentation Index

Fetch the complete documentation index at: https://help-plum.xoxoday.com/llms.txt

Use this file to discover all available pages before exploring further.

📘 Learn how to manage your access and refresh tokens here.

Request Schema

PropertyTypeDescription
grant_typestringMust be "refresh_token" to indicate token regeneration.
refresh_tokenstringThe existing refresh token used to generate a new access token.
client_idstringClient ID provided to you for authentication.
client_secretstringClient secret used to authenticate and validate the refresh request.

Response Schema

PropertyTypeDescription
access_tokenstringNewly generated access token.
token_typestringType of token issued (bearer).
expires_innumberAccess token validity duration (in seconds).
refresh_tokenstringNew refresh token issued to the user.

Body

application/json
grant_type
enum<string>
required

Must be "refresh_token".

Available options:
refresh_token
refresh_token
string
required

The existing refresh token used to obtain a new access token.

client_id
string
required

Client ID provided to you for authentication.

client_secret
string
required

Client secret associated with the client ID.

Response

New tokens issued successfully.

access_token
string

Newly generated access token.

token_type
string
Example:

"bearer"

expires_in
integer

Access token validity in seconds.

refresh_token
string

New refresh token (old one is immediately invalidated).

access_token_expiry
number

Epoch timestamp (ms) when the access token expires.

refresh_token_expiry
number

Epoch timestamp (ms) when the refresh token expires.