aVenture APIEntity Maintenance

Get entity operating status signal

View as Markdown

Probes the current entity website and returns a read-only operating-status signal. Write auth required.

Authentication

AuthorizationBearer

User bearer token: Supabase or Clerk session JWT, Clerk OAuth access token, or Clerk personal API key

OR
X-API-Keystring

Admin API key for system-to-system write operations

Path parameters

entityIdstringRequiredformat: "uuid"
Canonical entity UUID

Response

OK
checkedAtdatetime
Instant when this live check completed.
confidenceenum
Classifier confidence for the verdict.
entityIdstringformat: "uuid"
Entity whose website was checked.
evidencelist of strings
Classifier evidence strings.
verdictenum
Classifier verdict for the current website.
cdnProviderenum or nullOptional
CDN or edge provider inferred from the probe.
currentOperatingStatusenum or nullOptional
Current persisted operating status.
httpStatusinteger or nullOptional
HTTP status observed at the final URL.
probedUrlstring or nullOptional
Entity website URL that was probed.
resolvedUrlstring or nullOptional
Final URL reached after redirects.
suggestedOperatingStatusenum or nullOptional
Suggested status when the signal is strong enough to propose one.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
406
Not Acceptable Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error