---
title: "Takes the lambda offline"
method: POST
path: "/lambdas/{privateKey}/deployment/stop"
tags: ["Deployment"]
---

# Takes the lambda offline

`POST /lambdas/{privateKey}/deployment/stop`

## Request

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

From the next request on, its address answers that nothing is online. Its versions and its data are kept, and
any version can be deployed again. Nothing happens if it is offline already. The previews of its features are
not affected.

## Path parameters

- `privateKey` string, required

## Response `200`

The lambda, offline

- 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
- `403`: The lambda is a demo, which anybody may read and nobody may change. Create a lambda of your own from it instead: `POST /lambdas` with the demo's id as `template`.
- `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)