---
title: "POST /runner-configs/serverless-health-check"
method: POST
path: "/runner-configs/serverless-health-check"
tags: ["runner_configs::serverless_health_check"]
---

# POST /runner-configs/serverless-health-check

`POST /runner-configs/serverless-health-check`

## Query parameters

- `namespace` string, required

## Request body

- RunnerConfigsServerlessHealthCheckRequest
  - `headers` object
  - `url` string, required

## Response `200`

- union
  - object
    - `success` object, required
      - `version` string, required
  - object
    - `failure` object, required
      - `error` RunnerConfigsServerlessMetadataError, required — Wire-format envelope for serverless metadata errors. Surfaced to API clients with a stable `{message, details, metadata}` shape regardless of which internal `ServerlessMetadataError` variant produced it. `metadata.kind` discriminates the variant; per-variant fields live alongside `kind`.
        - `details` string, nullable
        - `message` string, required
        - `metadata` unknown

## Changes

- **2026-04-28** `04c60979f5e1` — 1 breaking, 4 info
  - the `oneOf[subschema #2]/failure/error` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - added the optional property `oneOf[subschema #2]/failure/error/details` to the response with the `200` status
  - added the optional property `oneOf[subschema #2]/failure/error/metadata` to the response with the `200` status
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7` from the `oneOf[subschema #2]/failure/error` response property `oneOf` list for the response status `200`
  - …1 more
- **2026-04-27** `9f9d35f0b74e` — 1 info
  - added the required property `oneOf[subschema #2]/failure/error/oneOf[subschema #7]/invalid_envoy_protocol_version/max_supported` to the response with the `200` status
- **2026-04-24** `02291fb9c7da` — 1 breaking, 1 info
  - added `subschema #5, subschema #7` to the `oneOf[subschema #2]/failure/error` response property `oneOf` list for the response status `200`
  - removed `subschema #5` from the `oneOf[subschema #2]/failure/error` response property `oneOf` list for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/rivet-dev/apis/rivet-api-public/changes/runner-configs/serverless-health-check/post.md)

---

[API](https://skmtc.dev/rivet-dev/apis/rivet-api-public.md) · [All operations](https://skmtc.dev/rivet-dev/apis/rivet-api-public/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rivet-dev/rivet-api-public/revisions/dbaccd9adeb0/schema)