ApiIdentityMe

Get the current identity

Returns the identity of the authenticated user. The identity ID is stable across every product in the Peridot ecosystem.

GET
/identity/me

Returns the identity of the authenticated user. The identity ID is stable across every product in the Peridot ecosystem.

Authorization

cookieAuth
peridot_access<token>

JWT access token set by /auth/google/callback or /auth/refresh

In: cookie

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/identity/me"
{  "id": "2f4b1c1e-8a6f-4d7a-9c3d-1a2b3c4d5e6f",  "createdAt": "2026-08-03T13:30:00.000Z"}

Rotate the refresh token POST

Rotates the refresh token and issues a fresh access token. The current `peridot_refresh` cookie is **invalidated** and replaced with a new one (rotation), so each refresh token can be used exactly once. - 401 if the refresh token is missing, expired, already rotated, or forged. - Rate limited to 10 requests / minute.

Get this specification GET

Returns the raw OpenAPI 3.0 document as `application/yaml`.