Marketplace

Diagnostic platform health

Returns cached DB-backed counts plus x402 facilitator readiness/configuration details and the acquisition observe / Interchange discovery freshness alarms. Unlike the process-liveness contract at /health, this diagnostic endpoint may report status: degraded and return HTTP 503 when a diagnostic dependency is unhealthy. The response includes the deployed git commit; cache TTL defaults to 30 seconds via PLATFORM_HEALTH_DETAILS_CACHE_MS.

get/health/details

Request

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

Response

Detailed platform health

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.