> ## Documentation Index > Fetch the complete documentation index at: https://docs.together.ai/llms.txt > Use this file to discover all available pages before exploring further. # List endpoint 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. ## OpenAPI ````yaml GET /projects/{projectId}/endpoints/{id}/events openapi: 3.1.0 info: title: Together APIs description: The Together REST API. See https://docs.together.ai for more details. version: 2.0.0 termsOfService: https://www.together.ai/terms-of-service contact: name: Together Support url: https://www.together.ai/contact license: name: MIT url: https://github.com/togethercomputer/openapi/blob/main/LICENSE servers: - url: https://api.together.ai/v1 description: Default environment for APIs - url: https://api-inference.together.ai/v2 description: Optimized environment for inference security: - bearerAuth: [] paths: /projects/{projectId}/endpoints/{id}/events: get: tags: - EndpointService summary: List endpoint events description: >- 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. operationId: EndpointService_ListEndpointEvents parameters: - name: projectId in: path required: true schema: description: Project identifier. type: string - name: id in: path required: true schema: description: Endpoint identifier. type: string - name: limit in: query schema: type: integer description: Maximum number of events to return. Max 500, defaults to 50. - name: after in: query schema: type: string description: Cursor from a previous endpoint event list response. - name: types in: query schema: type: array items: type: string description: >- Event types to include, such as `deployment.scaled` or `condition.set`. Combined with other filters using AND. - name: minLevel in: query schema: enum: - LEVEL_DEBUG - LEVEL_INFO - LEVEL_WARN - LEVEL_ERROR type: string description: Minimum severity. Omit to disable severity filtering. - name: since in: query schema: type: string format: date-time description: Return only events at or after this time. - name: until in: query schema: type: string format: date-time description: Return only events strictly before this time. - name: deploymentIds in: query schema: type: array items: type: string description: >- 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`. - name: sourceKinds in: query schema: type: array items: enum: - SOURCE_KIND_ENDPOINT - SOURCE_KIND_DEPLOYMENT type: string description: >- Resource kinds whose events should be included. Omit to include both endpoint- and deployment-scoped events. - name: subjectId in: query schema: type: string description: >- ID of a subject associated with the event, such as a rollout. Combined with other filters using AND. responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/DE.ListEndpointEventsResponse' default: description: Default error response content: application/json: schema: $ref: '#/components/schemas/ErrorData' servers: - url: https://api.together.ai/v2 components: schemas: DE.ListEndpointEventsResponse: type: object description: Endpoint and deployment lifecycle events, ordered newest first. required: - data - object properties: data: type: array items: $ref: '#/components/schemas/DE.EndpointEvent' description: Events for the endpoint, newest first. next_cursor: type: string description: Cursor for the next page. Null if there are no more results. object: const: list description: Object type. Always `list`. ErrorData: type: object required: - error properties: error: type: object properties: message: type: string nullable: false type: type: string nullable: false param: type: string nullable: true default: null code: type: string nullable: true default: null required: - type - message DE.EndpointEvent: type: object required: - id - createdAt - level - type - source - sourceKind - endpointId properties: id: type: string description: Output only. Unique event identifier. createdAt: type: string description: Output only. Event creation time. format: date-time level: enum: - LEVEL_DEBUG - LEVEL_INFO - LEVEL_WARN - LEVEL_ERROR type: string description: Output only. Severity level. type: type: string description: >- Output only. Stable event type, such as `endpoint.updated`, `deployment.created`, `deployment.scaled`, `condition.set`, or `pod.log`. message: type: string description: >- Output only. Human-readable description of the event. Short and stable; not structured data. source: type: string description: Output only. Service, cluster, or controller that emitted the event. sourceKind: enum: - SOURCE_KIND_ENDPOINT - SOURCE_KIND_DEPLOYMENT type: string description: >- Output only. Whether this row describes the endpoint or one of its deployments. endpointId: type: string description: Output only. The endpoint this event belongs to. Always set. deploymentId: type: string description: >- Output only. Deployment associated with the event when `sourceKind` is `SOURCE_KIND_DEPLOYMENT`. subjectId: type: string description: >- Output only. ID of the event's subject, such as a rollout, shadow target, or condition type. name: type: string description: >- Resource name at the time of the event. Populated by: deployment.created, deployment.deleted, endpoint.created, endpoint.deleted paths: type: array items: type: string description: >- Field-mask paths that were modified. Populated by: deployment.updated, endpoint.updated oldReplicas: type: integer description: 'Replica-count transition. Populated by: deployment.scaled' newReplicas: type: integer description: New replica count for a `deployment.scaled` event. version: type: integer description: >- Target version. Populated by `target.created`; the target ID is carried in `subjectId`. status: type: string description: >- Condition status for `condition.set` and `cluster_condition.set`: `True`, `False`, or `Unknown`. The condition type is carried in `subjectId`. reason: type: string description: >- Stable condition reason, such as `AllReplicasReady`, `ReplicasProgressing`, or `ApplySuccessful`. clusterId: type: string description: ID of the cluster associated with a cluster-scoped event. serviceType: type: string description: >- Deployment subservice associated with the event, such as `model-deployment` or `speculator-deployment`. replicaId: type: string description: >- Opaque replica identity associated with a `pod.*` event, stable for grouping events from the same replica. containerName: type: string description: >- Stable public component label associated with a replica event, such as `engine`, `model-download`, or `sidecar`. logExcerpt: type: string description: >- 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: type: string description: >- Opaque node handle for correlating replica failures on the same node. Omitted when the replica is unscheduled or the node is unknown. description: >- One endpoint- or deployment-scoped entry in an endpoint's combined audit and lifecycle feed. securitySchemes: bearerAuth: type: http scheme: bearer x-bearer-format: bearer x-default: default ````