---
title: "Takes a lambda offline without deleting it"
method: POST
path: "/admin/lambdas/{publicKey}/deployment/stop"
tags: ["Administration"]
---

# Takes a lambda offline without deleting it

`POST /admin/lambdas/{publicKey}/deployment/stop`

## Request

- Base URL: `https://genhttp.dev/api/v1`
- URL: `https://genhttp.dev/api/v1/admin/lambdas/{publicKey}/deployment/stop`
- Auth: none declared. Required headers: `X-Admin-Token`

Its history says the operator took it down. Its owner may deploy it again.

## Path parameters

- `publicKey` string, required

## Headers

- `X-Admin-Token` string, required

## Response `200`

The lambda afterwards

- LambdaOverviewResponse: What is left of a lambda after the operator acted on it.
  - `PublicKey` string: Its public key
  - `ActiveVersion` integer, nullable: The version online; absent while none is
  - `DeployedUntil` string, date-time, nullable: When it is taken offline unless it is used before then

## Other responses

- `204`: A response containing no body
- `401`: The token is missing.
- `403`: The token is wrong.
- `404`: No lambda has this public key.

---

[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)