Get Edge Function
Read one edge function of your active account's library, including its JavaScript source and build state. Poll it after uploading source to see the build finish: status moves from building to ready (with bundle_key and bundle_hash set) or failed.
Requires the endpoints:read permission on the active account. Not plan-gated.
Path parameters
fn_uuid string (uuid) Req
Response (200 OK)
{"edge_function": { … }} — the edge function object below.
The edge function object
uuid string (uuid)
The function's public id.
account_uuid string (uuid)
The account that owns the function.
name string
Display name, unique within the account (case-insensitive).
source string
The JavaScript source as last saved. Omitted while the function has no source (a new draft).
bundle_key string
Storage key of the compiled WebAssembly bundle. Omitted until a build succeeds, and cleared again when a later build fails. An
edge-function traffic-policy rule names the function by this key.bundle_hash string
SHA-256 (hex) of the compiled bundle. Present together with
bundle_key; an edge-function rule must carry both.entry string
The handler export the bundle runs.
default unless set.phase string
on_http_request (runs before the origin; a response with a non-zero status answers the request at the edge, status 0 lets it through) or on_http_response (transforms the origin's response).timeout_ms integer
Wall-clock budget of one invocation, in milliseconds (1–1000).
memory_mb integer
Memory ceiling of one invocation, in MiB (8–256).
status string
Build state:
draft (no source built yet), building, ready or failed. Only a ready function can be attached to an endpoint.disabled_by_plan boolean
true while the function is paused because the account's plan no longer includes edge_functions or the account is over its edge-function quota. A paused function can be viewed and deleted, but not edited, rebuilt or attached (409 quota_paused); it resumes when the account has room again.created_at, updated_at datetime
RFC 3339 UTC timestamps.
Deprecated: until the sunset this response also carries the legacy integer id and *_id fields. Don't use them; read uuid and the *_uuid fields.
Errors
401 Unauthorized
Missing or invalid auth.
403 Forbidden
No active account, not a member of it, or the caller lacks
endpoints:read.404 Not Found
edge function not found — unknown uuid, a function of another account, or a function that belongs to an application rather than the library. A path segment that is not a uuid doesn't match the route (404).500 Internal Server Error
failed to load edge function.Request
curl "https://api.ngris.com/v1/account/edge-functions/019b1f24-1a62-7d27-8411-538ed86e2a62" \
-H "X-API-KEY: <your_api_key>"
Response — 200 OK
{
"edge_function": {
"uuid": "019b1f24-1a62-7d27-8411-538ed86e2a62",
"account_uuid": "019b24b5-135e-7590-888e-e7cfa7e28ff3",
"name": "add-security-headers",
"source": "function readRequest() { … }\n…",
"bundle_key": "accounts/4821/edgefn/019b1f24-1a62-7d27-8411-538ed86e2a62/bundle.wasm",
"bundle_hash": "5f2c8e0b9a7d4c31e6f80a2b4d9c7e15a3f6b8d02c4e9a7f1b3d5c8e0a2f4b6d",
"entry": "default",
"phase": "on_http_response",
"timeout_ms": 50,
"memory_mb": 64,
"status": "ready",
"created_at": "2026-10-12T09:14:03Z",
"updated_at": "2026-10-12T09:14:41Z",
"disabled_by_plan": false
}
}