API referenceNetworkingNetwork interfaces
Reap orphaned pod NICs (CNI liveness sweep)
Requires the nics:delete permission.
Action endpoint (creates nothing). The CNI / platform-cni posts the set of pod UIDs it still considers alive; any sub-interface or platform NIC tagged with a pod_uid absent from that set and older than the grace period is deleted. Returns the reaped NIC ids.
AuthorizationBearer <token>
An access token from this zone's POST /oauth/token, or a session token from POST /api/v1/auth/login. Send it as Authorization: Bearer <token>.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/v1/nics/heartbeat" \ -H "Content-Type: application/json" \ -d '{}'{ "reaped": [ "7df919c0-aaa8-4918-b96f-859f0401e607" ]}