Skip to main content
POST
Update server log collector
Required permissions: server.collectLogs. Personal keys are capped by their owner’s current team role. Supply an Idempotency-Key for this action. An accepted request may continue asynchronously; poll the returned ID. See request conventions and automation workflows. MCP clients use the task-oriented tool catalogue.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string
required
Required string length: 1 - 255

Path Parameters

serverId
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Queue the pinned collector shipped with this Towbar release. Inspect the returned generation until terminal setup status. Accepted work continues asynchronously; poll its ID. An idempotent replay returns 200.

replayed
boolean
required
serverId
string
required
desiredState
required
Allowed value: "enabled"
status
required
Allowed value: "failed"
generation
null | string
required
version
null | string
required
lastReportAt
null | string
required
lastIngestedAt
null | string
required
errorMessage
null | string
required
supportedContainers
number
required
unsupportedContainers
number
required
queueBytes
number
required
droppedRecords
number
required
localization
object
required
Last modified on October 15, 2026