Sign in
latestOpenAPI 3.0.32026-08-227451,2751.8 MB

d0fc0114da66

LinkAgent

Enqueue an operator debug request for a Link Agent

Append an operator-issued debug request to the Agent's operator_debug_queue. The Agent picks it up on its next poll (≈ 10 s), executes idempotently, and acks via operator_debug_results on the following heartbeat. The api drops the queued entry on ack — callers watch operator_debug_results for the matching request_id to learn the outcome.

post/link/agents/{id}/operator-debug

Path parameters

idstring required

The ID of the agent to enqueue the debug request against.

Request body

request_idstring required

Opaque caller-supplied identifier (recommended: ULID). Agent dedupes by this value and surfaces it back on the ack.

action'dump-state' | 'redial-carriers' | 'redial-carrier' | 'force-peer-ca-refetch' | 'synthetic-dial' required

Discriminator. Each value maps to a typed sub-schema with that action's argument shape.

requested_atstring date-time required

When the api enqueued this request.

requested_bystring

Operator identifier (e.g. mabl user id). Audit-only — not used for authorization.

Response

Request enqueued. The Agent acks on its next heartbeat.