---
title: "Environments"
method: POST
path: "/environments"
tags: ["Environments"]
---

# Environments

`POST /environments`

## Request

- Base URL: `https://example.app.liongard.com/api/v1`
- URL: `https://example.app.liongard.com/api/v1/environments`
- Auth: API key in header `X-ROAR-API-KEY`

Creates a single Liongard Environment. If you want to create a child environment, set the Parent Environment, if not set to null.

## Request body

- object
  - `Name` string, required
  - `Description` string, required
  - `Parent` string, nullable, required
  - `Tier` 'Core' | 'Essential': Defaults to Core, if not used

## Response `200`

- Environments
  - `ID` integer
  - `ServiceProviderID` integer
  - `Name` string
  - `ShortName` string
  - `Description` string
  - `Status` integer
  - `Visible` boolean
  - `ExpiresOn` string
  - `KeyRotation` integer
  - `Website` string
  - `Static` boolean
  - `CreatedOn` string
  - `UpdatedOn` string
  - `Tier` object
    - `Type` string
    - `CanDowngrade` boolean
    - `AssociatedInspectors` integer
  - `CreatedBy` object
    - `ID` integer
    - `FirstName` string
    - `LastName` string
    - `Username` string

---

[API](https://skmtc.dev/liongard/apis/liongard-v1-endpoints.md) - [All operations](https://skmtc.dev/liongard/apis/liongard-v1-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/liongard/apis/liongard-v1-endpoints/revisions/7efdc24166c1?raw)