---
title: "Publish an explicitly saved source and manifest for one-time preparation. Returns pending/building until verified; does not run the task"
method: POST
path: "/environments/{name}"
tags: ["environments"]
---

# Publish an explicitly saved source and manifest for one-time preparation. Returns pending/building until verified; does not run the task

`POST /environments/{name}`

## Request

- Base URL: `https://www.dench.com/api/v1`
- URL: `https://www.dench.com/api/v1/environments/{name}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Publish an explicitly saved source and manifest for one-time preparation. Returns pending/building until verified; does not run the task.

## Path parameters

- `name` string, required

## Request body

- object
  - `manifest` object, required
    - `version` 1, required
    - `name` string, required
    - `purpose` string, required
    - `files` string[], required
    - `prepare` string[], required
    - `verify` string[], required
    - `env` object
    - `secretEnv` object
    - `secretFiles` object[]
      - `path` string, required
      - `secret` string, required
      - `mutable` boolean
    - `statePaths` string[]
    - `portable` boolean
  - `uploadId` string, required
  - `storageId` string, required
  - `sha256` string, required

## Response `200`

Successful response

- unknown

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `404`: Operation or resource not found
- `500`: Server error

---

[API](https://skmtc.dev/dench/apis/dench-api.md) - [All operations](https://skmtc.dev/dench/apis/dench-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dench/apis/dench-api/revisions/4a145b38f19c?raw)