Skip to main content
ZStack
Infrastructure/Agents

GetLifecycleEvents

Retrieve the lifecycle event history for a specific agent

GET/api/v1/agents/{uuid}/lifecycle-events

Operation ID

GetLifecycleEvents

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

Path Parameters

  • uuid
    StringRequired

    UUID of the agent whose lifecycle events to retrieve

Query Parameters

  • limit
    Integer

    Maximum number of events to return Maximum number of events to return

    Example: 0

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • items
    List

    Collection of result items

    Example: (nested array)

    • id
      String

      Unique identifier of the lifecycle event

      Example: evt-001-abc

    • agentId
      String

      UUID of the agent this event belongs to

      Example: agent-abc123-def456

    • eventType
      String

      Type of lifecycle event (start, stop, upgrade, crash)

      Example: upgrade

    • fromStatus
      String

      Previous status before the event occurred

      Example: online

    • toStatus
      String

      New status after the event was processed

      Example: upgrading

    • version
      String

      Agent version associated with this event

      Example: 1.5.0

    • operator
      String

      Account or system that initiated the event

      Example: admin

    • reason
      String

      Reason or context for the event

      Example: scheduled upgrade

    • occurredAt
      String

      Occurred at

      Example: 2026-01-15T08:00:00Z

  • total
    Integer

    Total number of lifecycle events for the agent

    Example: 200