Generate experiences with Puck AI
Read docs
CloudAPI referencecloud-clientTypesPuckSession

PuckSession

Puck Auth is experimental and may change in a future release.

A Puck user signed in to your app with Puck Auth.

{
  "user": {
    "id": "user_123",
    "name": "Jane Doe",
    "email": "jane@example.com",
    "image": "https://www.example.com/me.png"
  },
  "expiresAt": "2026-10-30T12:00:00.000Z"
}

Params

ParamExampleTypeStatus
useruser: { id: "user_123" }ObjectRequired
expiresAtexpiresAt: "2026-10-30T12:00:00.000Z"StringRequired

user

The signed-in user.

ParamExampleTypeStatus
user.idid: "user_123"StringRequired
user.namename: "Jane Doe"StringRequired
user.emailemail: "jane@example.com"StringRequired
user.imageimage: "https://www.example.com/me.png"String | null-

user.id

The user’s id.

user.name

The user’s name.

user.email

The user’s email address.

user.image

The URL of the user’s image. Can be null or missing.

expiresAt

When the session ends, as an ISO timestamp.