Introducing Agents.·Read
Getting StartedKey ConceptsHow-to GuidesCLITrickest SDKMCPSandbox SDKAPI ReferenceChangelog
Refresh the session tokens

Refresh the session tokens

Exchanges a browser refresh-token cookie or CLI body refresh token for a new access/refresh JWT pair. Browser callers receive cookies; CLI body callers receive the pair in JSON. Rate limited.

POST/api/auth/token-refresh

Request

curl
curl -X POST https://trickest.io/api/auth/token-refresh \
  -H "Authorization: Token $TRICKEST_TOKEN"

Responses

200Browser cookies refreshed or CLI access/refresh tokens returned
400Bad Request – validation error or malformed input
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

401Unauthorized – missing or expired token
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

403Credential rejected by the authentication service
codeenumrequired

One of: UNAUTHORIZED, RATE_LIMITED, TEMPORARILY_UNAVAILABLE, TIMEOUT, INVALID_RESPONSE

messagestringrequired
traceIdstring
retryAfterinteger
retryAfterSecondsinteger
429Authentication rate limited; Retry-After may provide a bounded delay
codeenumrequired

One of: UNAUTHORIZED, RATE_LIMITED, TEMPORARILY_UNAVAILABLE, TIMEOUT, INVALID_RESPONSE

messagestringrequired
traceIdstring
retryAfterinteger
retryAfterSecondsinteger
500Internal Server Error
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

502Authentication service returned an invalid response
codeenumrequired

One of: UNAUTHORIZED, RATE_LIMITED, TEMPORARILY_UNAVAILABLE, TIMEOUT, INVALID_RESPONSE

messagestringrequired
traceIdstring
retryAfterinteger
retryAfterSecondsinteger
503Authentication service temporarily unavailable; credentials retained
codeenumrequired

One of: UNAUTHORIZED, RATE_LIMITED, TEMPORARILY_UNAVAILABLE, TIMEOUT, INVALID_RESPONSE

messagestringrequired
traceIdstring
retryAfterinteger
retryAfterSecondsinteger
504Authentication service timed out; credentials retained
codeenumrequired

One of: UNAUTHORIZED, RATE_LIMITED, TEMPORARILY_UNAVAILABLE, TIMEOUT, INVALID_RESPONSE

messagestringrequired
traceIdstring
retryAfterinteger
retryAfterSecondsinteger
PreviousAuthGet the current session (whoami)AuthNextStart CLI device authorization