Skip to main content
Infrastructure/Agents
GETAgentSince 1.0SynchronousAuth Required

GetProbeHistory

Retrieve the historical probe results for a given agent

Execution Availability

Try It Out

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

Path Parameters

Request Inputs

Path Parameters

  • uuidStringRequired

    UUID of the agent whose probe history to retrieve

Responses

200 OK

On success, this API returns the following response structure.

  • itemsList

    Collection of result items

    Example: (nested array)

    • agentIdString

      UUID of the agent that performed the probe

      Example: agent-abc123-def456

    • timestampString

      Timestamp for this resource

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

    • detectedServicesList

      Detected services

      Example: (nested array)

      • serviceString

        Name of the detected service

        Example: nginx

      • confidenceLong

        Detection confidence score between 0 and 1

        Example: 0.95

      • evidenceList

        Evidence for this resource

        Example: item1,item2

      • recommendedConfigObject

        Recommended config

        • typeString

          Collector type identifier

          Example: prometheus

        • sourceString

          Data source path or URL for the collector

          Example: /var/log/app.log

        • parserString

          Parser to use for ingested data

          Example: json

        • pluginString

          Plugin identifier handling this collector

          Example: filebeat

        • endpointString

          Target endpoint to send collected data

          Example: http://loki:3100/loki/api/v1/push

        • varsLinkedHashMap

          Variable definitions for template rendering

          Example: (nested object)

    • probeTimeMsString

      Time taken to complete the probe in milliseconds

      Example: 1200

Endpoint

GET/api/v1/agents/{uuid}/probe/history

/api/v1/agents/{uuid}/probe/history

Operation ID

GetProbeHistory

Permalink

Request Example

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

Response Example

200
{
  "items": [
    {}
  ]
}

Change History

This API has no change history records yet.

View all change history