---
title: "List Token Events For User"
method: GET
path: "/v2/auth/token-events"
tags: ["Auth Service (v2)"]
---

# List Token Events For User

`GET /v2/auth/token-events`

List the calling user's OAuth connection audit events, newest first.

Backs the frontend "your connection dropped, reconnect" surface. Scoped to
the authenticated user + org; both come from the auth context, never from
request input.

## Query parameters

- `provider_id` string, nullable — Filter to one OAuth provider
- `limit` integer — Max events to return

## Response `200`

Successful Response

- TokenEventSummary[]
  - `id` string, required
  - `provider_id` string, required
  - `agent_id` string, nullable
  - `event_type` string, required
  - `reason` string, nullable
  - `source` string, nullable
  - `provider_account_label` string, nullable
  - `scopes` string[]
  - `detail` object, nullable
  - `acknowledged_at` string, date-time, nullable
  - `created_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/langchain-ai/apis/langsmith-deployment-control-plane-api.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith-deployment-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith-deployment-control-plane-api/versions/a0cd098699b4/schema)