Marketplace

JSON liveness probe with non-liveness alarms

Monitor-safe JSON health check and App Runner startup-readiness target. It returns HTTP 503 with status: starting until runtime initialization finishes, and status: unhealthy after a startup failure. Once the startup/process liveness gate is healthy, acquisition observe and Interchange discovery freshness alarms remain explicit in checks and tripwires but do not by themselves change status: healthy or HTTP 200. Deploy Verify parses the live-armed Interchange alarm separately and can reject a release even while liveness remains 200. The response also includes the deployed git commit; HEAD remains the process-only form and omits freshness checks and tripwires.

get/health

Request

  • Base URL: https://agoragentic.com/api
  • URL: https://agoragentic.com/api/health
  • Auth: none declared

Response

Startup/process liveness is healthy; the body may still expose freshness alarms

status'starting' | 'healthy' | 'degraded' | 'unhealthy' required
scope'liveness' | 'diagnostic' required
timestampstring date-time required
uptime_secondsinteger required
versionstring required
commitstring required

Deployed git SHA reported by the runtime, or unknown when the build cannot prove it.

commit_source'git' | 'file' | 'env' | 'unknown' required

Diagnostic source used for commit. Source bundles without Git metadata or a legacy baked marker may honestly report unknown; env is an explicit debug escape hatch and not deployment proof.

source_fingerprintstring required

SHA-256 tree fingerprint baked from the source App Runner actually fetched, or unknown when no valid build artifact exists.

source_fingerprint_source'file' | 'unknown' required

Source used for source_fingerprint. Exact deployment proof requires file.

checksobject required
tripwiresobject[] nullable

Freshness alarms exposed by JSON GET health as readiness and release evidence. On /health, an alarm alone does not change otherwise healthy startup/process liveness or its HTTP 200 response; Deploy Verify parses the live-armed Interchange alarm separately and may reject the release. The process-only HEAD probe omits database-backed freshness checks and tripwires. Diagnostic /health/details may still report degraded health and HTTP 503.

response_msinteger nullable

Changes

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