Skip to main content

environment

Fetch a single environment by its identifier.

environment(
organizationId: ID!
id: ID!
): Environment

Arguments

environment.organizationId ● ID! non-null scalar {#organization-id}

Your organization's unique identifier.

environment.id ● ID! non-null scalar {#id}

The environment's unique identifier.

Type

Environment object

A deployment target within a project where blueprint components become live infrastructure.

Each project can have multiple environments (e.g., staging, production). When you deploy to an environment, every component in the project's blueprint is realized as an Instance -- a running piece of cloud infrastructure with its own configuration, state, and cost data.

Environments inherit tags from their parent project. You can also set environment-scoped tags that cascade down to all instances within the environment. Defaults let you pre-assign resources (like a shared VPC or DNS zone) so that new instances automatically receive them.

Before deleting an environment, all instances must be decommissioned. Use the deletable field to check for blocking constraints.