Skip to Content

APIs & SDKs

List User Events

Vercel SDK

GEThttps://api.vercel.com/v3/events

List User Events

Retrieves a list of "events" generated by the User on Vercel. Events are generated when the User performs a particular action, such as logging in, creating a deployment, and joining a Team (just to name a few). When the teamId parameter is supplied, then the events that are returned will be in relation to the Team that was specified.

Authentication

AuthorizationbearerToken

Default authentication mechanism


principalId

Timestamp to only include items created since then.

userId

Comma-delimited list of event "types" to filter the results by.

Optional
Optional
Optional
Optional

projectIds

Comma-delimited list of project IDs to filter the results by.

string
Optional
Optional
Optional

withPayload

The Team identifier to perform the request on behalf of.

Optional
Optional
Optional
Optional

events

array

Required

400One of the provided values in the request query is invalid.

200Successful response.

Array of events generated by the User.

403You do not have permission to access this resource.

401The request is not authorized.

This page is not in the current cross-link map.