#Environments

---

#GET /{o}/{p}/environments

List environments

Auth: Bearer token required · Permission: catalog:read

Path parameters

Name	Type	Description
o	string
p	string

Responses

Status	Description	Schema
200	Environments	EnvironmentList

---

#POST /{o}/{p}/environments

Create an environment

Auth: Bearer token required · Permission: catalog:write

Path parameters

Name	Type	Description
o	string
p	string

Request body (application/json)

Field	Type	Description
name	string	(required)

Responses

Status	Description	Schema
201	Created environment	Environment
409	Environment already exists	Error

---

#DELETE /{o}/{p}/environments/{envName}

Delete an environment

Delete a non-default, empty environment. Refuses while the env still has entities, relationships, secrets, or action runs.

Auth: Bearer token required · Permission: catalog:write

Path parameters

Name	Type	Description
o	string
p	string
envName	string

Responses

Status	Description	Schema
200	Deletion result	Deleted
404	Environment not found	Error
409	Default env or env still has data	Error

#Schemas

#Deleted

Field	Type	Description
deleted	true	(required)
name	string	(required)

#Environment

Field	Type	Description
id	string(uuid)	(required)
name	string	(required)
isDefault	boolean	(required)
createdAt	string	(required)

#EnvironmentList

Type: Environment[]

#Error

Field	Type	Description
error	string	(required)
code	string