NOnotte
functions

Function Runtime Health

Changed on
get/functions/health

Request

  • Base URL
    https://api.notte.cc (the document declares no server; this is the origin it was published from)
  • Auth
    OAuth 2
    Password
    Token URL: token

Query parameters

sdk_generation'v19' | 'v110'

Headers

x-notte-request-originstring nullable
x-notte-sdk-versionstring nullable

Response

Successful Response

status'ok' | 'degraded' | 'unreachable' required

'ok' when the runtime reported itself, 'degraded' when it is alive but too old to describe itself (its image predates this endpoint), 'unreachable' when it did not answer.

reachableboolean required

Whether the runtime answered an HTTP request at all.

latency_msnumber nullable

Round trip to the runtime, null when unreachable.

python_versionstring nullable

Python the sandbox executes under, e.g. '3.12.0'.

stdlib_modulesstring[]

Standard-library modules the sandbox allows. Versionless: the Python version covers them.

reserved_env_namesstring[]

function_env names the platform owns, rejected at write time. Served here so a client validating secret names before pushing them does not have to vendor its own copy and watch it drift.

runtime_digeststring nullable

Digest of the reproducible contract - Python version, packages with their sources, allowed imports, reserved names - and nothing volatile, so it changes if and only if an environment built against it would now be wrong. Cache against it to detect a runner rebuild. Null unless status is 'ok', since a partial report is not a contract. Also returned as the response ETag.

sdk_generation'v19' | 'v110'
source_manifestobject nullable
runner_policy_versionstring nullable
runtime_lock_digeststring nullable
errorstring nullable

Why the probe failed, when it did.

Changes

  • 4d05dac78797Revision changes
    • breaking

      the response property const value v19 was removed for the status

    • warning

      added the new v110 enum value to the response property for the response status

    • warning

      added the new v19 enum value to the response property for the response status

    • info

      added the new optional query request parameter sdk_generation

    • info

      added the optional property to the response with the status

  • d52cb342f7ddRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status