---
title: "Reads a lambda"
method: GET
path: "/lambdas/{privateKey}"
tags: ["Lambdas"]
---

# Reads a lambda

`GET /lambdas/{privateKey}`

## Request

- Base URL: `https://genhttp.dev/api/v1`
- URL: `https://genhttp.dev/api/v1/lambdas/{privateKey}`
- Auth: none declared

Its keys and tier, its newest version and the one online, until when it stays online and is kept, and where it answers.

## Path parameters

- `privateKey` string, required

## Response `200`

The lambda

- LambdaResponse: A lambda, as whoever holds its editor key sees it.
  - `PublicKey` string: Names its address below the hosting domain. Not a secret; its owner may change it.
  - `PrivateKey` string: The editor key, which authorizes every call about the lambda. Treat it like a password.
  - `Tier` string: `Free`, `Premium` or `Demo`, assigned by the operator. Decides its limits, whether it is kept online while nobody uses it, and whether it may answer at a domain of its own.
  - `Created` string, date-time: When it was created
  - `Modified` string, date-time: When something about it last changed: a save, a deployment, a setting
  - `ActiveVersion` integer, nullable: The version that is online; absent while nothing is
  - `LatestVersion` integer, nullable: The newest version saved, which may be ahead of the one online
  - `PublicUrl` string: Its address below the hosting domain, named after its public key: `https://quiz.genhttp.run/`. While it answers at a domain of its own, this address sends its visitors on to the domain.
  - `EditorPath` string: Where its editor is on this site: `/editor/{privateKey}`. Holds the editor key.
  - `DeployedAt` string, date-time, nullable: When the version online went online; absent while nothing is
  - `DeployedUntil` string, date-time, nullable: When it is taken offline unless it is visited or edited before then - each visit and each edit moves this on. Absent while it is offline, and for a tier that keeps it online.
  - `KeptUntil` string, date-time, nullable: When it is deleted unless it is visited or edited before then. Absent for a tier that keeps it.
  - `Domain` string, nullable: The domain of its own it is configured to answer at, whether or not its tier lets it
  - `DomainServed` boolean: Whether it answers at that domain: it has one, and its tier includes it
  - `Address` string: Where to link to it: its domain while that is served, `publicUrl` otherwise
  - `View` string: How its editor opens for somebody who has not chosen a view of their own: `Full` or `Simple`
  - `GitPath` string: Where it is cloned with git and pushed to, on this site. The versions are the commits of `main`, the features the other branches. Holds the editor key, like the editor's path.

## Other responses

- `204`: A response containing no body
- `404`: No lambda has this editor key. A key that never existed and the key of a deleted lambda are answered alike.

---

[API](https://skmtc.dev/genhttp/apis/genhttp-lambda-api.md) · [All operations](https://skmtc.dev/genhttp/apis/genhttp-lambda-api/llms.txt) · [OpenAPI document](https://skmtc.dev/genhttp/apis/genhttp-lambda-api/revisions/8b36699e03df?raw)
