Introducing Agents.·Read
Getting StartedKey ConceptsHow-to GuidesCLITrickest SDKMCPSandbox SDKAPI ReferenceChangelog
Get the current session (whoami)

Get the current session (whoami)

Validates the caller's credential and returns the user. Browser cookie sessions return user metadata only and refresh transparently. With an Authorization: Token or Bearer header, the agent/CLI whoami response also includes that supplied token.

GET/api/auth/session

Request

curl
curl -X GET https://trickest.io/api/auth/session \
  -H "Authorization: Token $TRICKEST_TOKEN"

Responses

200The authenticated user and token expiry
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
PreviousAudit-logsRequest an audit log exportAuthNextRefresh the session tokens