Skip to main content
API Explorer|API Explorer
Infrastructure/Lifecycle
GETLifecycleSince 1.0SynchronousAuth Required

ListLifecycleEvents

List lifecycle audit events

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Query Parameters

Request Inputs

Query Parameters

  • componentUuidString

    Filter by component UUID

  • eventTypeString

    Filter by event type

  • startTimeString

    Filter events after this time

  • endTimeString

    Filter events before this time

  • limitInteger

    Maximum number of events to return

    Example: 0

Responses

200 OK

On success, this API returns the following response structure.

  • itemsList

    List of lifecycle events

    Example: (nested array)

    • idString

      Unique identifier of the lifecycle event

      Example: evt-001-abc

    • agentIdString

      UUID of the agent this event belongs to

      Example: agent-abc123-def456

    • eventTypeString

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

      Example: upgrade

    • fromStatusString

      Previous status before the event occurred

      Example: online

    • toStatusString

      New status after the event was processed

      Example: upgrading

    • versionString

      Agent version associated with this event

      Example: 1.5.0

    • operatorString

      Account or system that initiated the event

      Example: admin

    • reasonString

      Reason or context for the event

      Example: scheduled upgrade

    • occurredAtString

      Occurred at

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

  • totalInteger

    Total number of matching events

    Example: 100

  • limitInteger

    Limit used in this response

    Example: 20

  • offsetInteger

    Offset used in this response

    Example: 40

Endpoint

GET/api/v1/lifecycle/events

/api/v1/lifecycle/events

Operation ID

ListLifecycleEvents

Permalink

Request Example

curl -X GET '{host}/api/v1/lifecycle/events' -H 'Authorization: Bearer {token}'

Response Example

200
{"items": [{"id": "evt-001-abc", "agentId": "agent-abc123-def456", "eventType": "upgrade", "fromStatus": "online", "toStatus": "upgrading", "version": "1.5.0", "operator": "admin", "reason": "scheduled upgrade"}], "total": 100, "limit": 20, "offset": 40}

Change History

This API has no change history records yet.

View all change history