---
title: "Api Post Specification"
method: POST
path: "/api/v1/specification/"
tags: ["api"]
---

# Api Post Specification

`POST /api/v1/specification/`

## Request

- The document declares no server URL.
- Auth: none declared

## Request body

- BodyApiPostSpecificationApiV1SpecificationPost
  - `environment_description` string, nullable
  - `environment_name` string, nullable
  - `is_lockfile` boolean, nullable
  - `namespace` string, nullable
  - `specification` string

## Response `200`

Successful Response

- APIPostSpecification
  - `data` APIPostSpecificationData, required
    - `build_id` integer, required
  - `message` string, nullable
  - `status` 'ok' | 'error', required

## Other responses

- `422`: Validation Error

## Changes

- **2024-11-26** `da5794d6a672`: 2 breaking, 4 info
  - response property `message` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `status` response's property type changed from no type to `string` for status `200`
  - request property `environment_description` list-of-types was widened by adding types `null` to media type `application/json`
  - request property `environment_name` list-of-types was widened by adding types `null` to media type `application/json`
  - …2 more
- **2024-08-29** `72805cdb69bc`: 3 info
  - added the new optional request property `environment_description`
  - added the new optional request property `environment_name`
  - added the new optional request property `is_lockfile`
- **2024-03-15** `6642d3ed3fab`: 2 breaking, 3 warning, 1 info
  - request property `namespace` list-of-types was narrowed by removing types `null` from media type `application/json`
  - the `status` response's property type changed from `string` to no type for status `200`
  - removed the request property `environment_description`
  - removed the request property `environment_name`
  - …2 more

[Operation history](https://skmtc.dev/conda-incubator/apis/conda-store/changes/api/v1/specification/post.md)

---

[API](https://skmtc.dev/conda-incubator/apis/conda-store.md) - [All operations](https://skmtc.dev/conda-incubator/apis/conda-store/llms.txt) - [OpenAPI document](https://skmtc.dev/conda-incubator/apis/conda-store/revisions/1045c7d5b017?raw)