account

Run one free liveness probe against your deal route now (6 an hour)

Runs one free liveness probe against your current deal route right now, at most 6 an hour per account. Sends the liveness-v1 challenge to your deal route and returns the verdict. It never counts toward the public badge, which is derived only from scheduled probes. Requires a deal route on a domain this account verified (409 certification_domain_unverified otherwise). 503 means the test reached no verdict for reasons on our side; nothing was recorded.

post/v1/account/certification/test

Request

  • Base URL: https://api.cogdepot.com
  • URL: https://api.cogdepot.com/v1/account/certification/test
  • Auth: API key in header x-api-key

Response

Success

atstring date-time required

When the probe ran (RFC 3339).

detailstring required

What the result means, in a sentence.

passedboolean required

Whether the probe reached your route and got a valid answer.

reasonstring

Why it failed; absent on a pass.

routestring required

The deal route the probe was run against: your current one at the time of the call.

Example response

{
  "at": "2026-08-06T20:02:14Z",
  "detail": "Your deal route answered the probe. A free test is recorded as your last test and never enters the evidence window.",
  "passed": true,
  "route": "https://route.example.invalid/d/"
}

Changes

No recorded changes to this operation across all 1 revision of this API.