Skip to content

Gateway

Gateway-level operational endpoints. These reflect the health and status of the API gateway itself rather than any backend service. No authentication is required.

Operations

Gateway health check

Request

Returns the operational status of the API gateway (KrakenD) itself. Use this endpoint for infrastructure liveness probes and uptime monitoring.

This is a KrakenD built-in endpoint — it reflects the gateway process status, not any upstream backend service. Authentication is not required.

curl -i -X GET \
  https://developers.forms.app/_mock/apis/v1/health

Responses

The gateway is up and running.

Bodyapplication/json
statusstring

Always "ok" when the gateway is healthy.

Value:"ok"
nowstring

Current gateway time as a Go time string.

agentsobject

Status of any registered async agents (empty object when none are configured).

Response
{
  "status": "ok",
  "now": "2024-03-15 10:30:00.000000000 +0000 UTC m=+3600.123",
  "agents": {}
}