Skip to main content
API Explorer|API Explorer
Infrastructure/Agents
GETAgentSince 1.0SynchronousAuth Required

GetLifecycleEvents

Retrieve the lifecycle event history for a specific agent

Execution Availability

Try It Out

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

Path Parameters

Query Parameters

Request Inputs

Path Parameters

  • uuidStringRequired

    UUID of the agent whose lifecycle events to retrieve

Query Parameters

  • limitInteger

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

    Example: 0

Responses

200 OK

On success, this API returns the following response structure.

  • itemsList

    Collection of result items

    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 lifecycle events for the agent

    Example: 200

Endpoint

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

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

Operation ID

GetLifecycleEvents

Permalink

Request Example

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

Response Example

200
{
  "items": [
    {}
  ],
  "total": 200
}

Change History

This API has no change history records yet.

View all change history