Sign in

v1

latestSwagger 2.0BSD 3-Clause2026-07-1720953437.1 KB
collectors

Get collector

Retrieve the specified collector metadata by the collector's id or name. You may also optionally specify a list of fields to include in the response.

get/collectors/{key}

Path parameters

keystring required

The id or name of the collector to retrieve.

Query parameters

fieldsstring[]

Comma-delimited list of field names to include in the response.

Response

Success, returns the specified collector's metadata.

idstring

The collector id.

namestring required

Should be unique.

currentGeneratorsobject[]

Generators assigned to this collector.

registeredtrue | false

Boolean. If false, means deregistered. Changed by the DEREGISTER command

status'Stopped' | 'Running' | 'Paused' | 'MissedHeartbeat'

The collector status.

lastHeartbeatstring

Timestamp at which the last heartbeat was sent.

lastModifiedAtstring

Timestamp of the collector's most recent modification.

createdBystring

Id of the User who created this Collector.

lastUpdatedBystring

Timestamp of the collector's most recent update.

descriptionstring

Describes this Collector; helps a user determine which Collectors they should assign to run their collection.

helpEmailstring

The email address where a user can go to get more help about the collector.

helpUrlstring

The url where a user can go to get more help about the collector.

hoststring

The host where the collector is installed.

ipAddressstring

The ipAddress where the collector is installed.