---
title: "List endpoint events"
method: GET
path: "/projects/{projectId}/endpoints/{id}/events"
tags: ["EndpointService"]
---

# List endpoint events

`GET /projects/{projectId}/endpoints/{id}/events`

Lists an endpoint's audit and lifecycle events newest first. The feed combines endpoint changes with provisioning, scaling, readiness, rollout, and other events from deployments under the endpoint.

## Path parameters

- `projectId` string, required — Project identifier.
- `id` string, required — Endpoint identifier.

## Query parameters

- `limit` integer — Maximum number of events to return. Max 10000, defaults to 50.
- `after` string — Cursor from a previous endpoint event list response.
- `types` string[] — Event types to include, such as `deployment.scaled` or `condition.set`. Combined with other filters using AND.
- `minLevel` 'LEVEL_DEBUG' | 'LEVEL_INFO' | 'LEVEL_WARN' | 'LEVEL_ERROR' — Minimum severity. Omit to disable severity filtering.
- `since` string, date-time — Return only events at or after this time.
- `until` string, date-time — Return only events strictly before this time.
- `deploymentIds` string[] — Deployment IDs whose events should be included. Every ID must belong to the endpoint. Supplying this filter excludes endpoint-scoped events unless `SOURCE_KIND_ENDPOINT` is also included in `sourceKinds`.
- `sourceKinds` string[] — Resource kinds whose events should be included. Omit to include both endpoint- and deployment-scoped events.
- `subjectId` string — ID of a subject associated with the event, such as a rollout. Combined with other filters using AND.

## Response `200`

OK

- DEListEndpointEventsResponse — Endpoint and deployment lifecycle events, ordered newest first.
  - `data` DEEndpointEvent[], required — Events for the endpoint, newest first.
    - `id` string, required — Output only. Unique event identifier.
    - `createdAt` string, date-time, required — Output only. Event creation time.
    - `level` 'LEVEL_DEBUG' | 'LEVEL_INFO' | 'LEVEL_WARN' | 'LEVEL_ERROR', required — Output only. Severity level.
    - `type` string, required — Output only. Stable event type, such as `endpoint.updated`, `deployment.created`, `deployment.scaled`, `condition.set`, or `pod.log`.
    - `message` string — Output only. Human-readable description of the event. Short and stable; not structured data.
    - `source` string, required — Output only. Service, cluster, or controller that emitted the event.
    - `sourceKind` 'SOURCE_KIND_ENDPOINT' | 'SOURCE_KIND_DEPLOYMENT', required — Output only. Whether this row describes the endpoint or one of its deployments.
    - `endpointId` string, required — Output only. The endpoint this event belongs to. Always set.
    - `deploymentId` string — Output only. Deployment associated with the event when `sourceKind` is `SOURCE_KIND_DEPLOYMENT`.
    - `subjectId` string — Output only. ID of the event's subject, such as a rollout, shadow target, or condition type.
    - `name` string — Resource name at the time of the event. Populated by: deployment.created, deployment.deleted, endpoint.created, endpoint.deleted
    - `paths` string[] — Field-mask paths that were modified. Populated by: deployment.updated, endpoint.updated
    - `oldReplicas` integer — Replica-count transition. Populated by: deployment.scaled
    - `newReplicas` integer — New replica count for a `deployment.scaled` event.
    - `version` integer — Target version. Populated by `target.created`; the target ID is carried in `subjectId`.
    - `status` string — Condition status for `condition.set` and `cluster_condition.set`: `True`, `False`, or `Unknown`. The condition type is carried in `subjectId`.
    - `reason` string — Stable condition reason, such as `AllReplicasReady`, `ReplicasProgressing`, or `ApplySuccessful`.
    - `clusterId` string — ID of the cluster associated with a cluster-scoped event.
    - `serviceType` string — Deployment subservice associated with the event, such as `model-deployment` or `speculator-deployment`.
    - `replicaId` string — Opaque replica identity associated with a `pod.*` event, stable for grouping events from the same replica.
    - `containerName` string — Stable public component label associated with a replica event, such as `engine`, `model-download`, or `sidecar`.
    - `logExcerpt` string — Short diagnostic log excerpt captured with a pod event, for example during a crash, out-of-memory termination, or image pull failure. This field is truncated and is not a streaming log API.
    - `nodeId` string — Opaque node handle for correlating replica failures on the same node. Omitted when the replica is unscheduled or the node is unknown.
  - `next_cursor` string — Cursor for the next page. Null if there are no more results.
  - `object` 'list', required — Object type. Always `list`.

## Other responses

- `default` — Default error response

---

[API](https://skmtc.net/together/apis/together-apis.md) · [All operations](https://skmtc.net/together/apis/together-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/together/together-apis/revisions/f26a23fab8e0/schema)