---
title: "Get environment"
method: GET
path: "/v1/projects/{project_id}/environments/{environment_id}"
tags: ["environments"]
---

# Get environment

`GET /v1/projects/{project_id}/environments/{environment_id}`

## Request

- Base URL: `https://api.connic.co`
- URL: `https://api.connic.co/v1/projects/{project_id}/environments/{environment_id}`
- Auth: HTTP bearer

Get one environment with its settings and what the caller can do in it.

Required permission: `environments.view`.

## Path parameters

- `project_id` string, uuid, required
- `environment_id` string, uuid, required

## Response `200`

Successful Response

- PublicEnvironmentResponse
  - `id` string, uuid, required
  - `project_id` string, uuid, required: Project the environment belongs to.
  - `name` string, required
  - `slug` string, required: URL-safe identifier derived from `name`, unique within the project.
  - `git_branch` string, nullable, required: Git branch this environment deploys from. Null when deployments come from CLI uploads.
  - `is_active` boolean, required: Whether the environment is active. Git pushes and pull request tests only target active environments.
  - `is_default` boolean, required: Whether this is the project's default environment. A project has exactly one.
  - `env_type` string, required: `standard` for regular environments, `test` for dev environments created by `connic dev`.
  - `is_ephemeral` boolean, required: True for dev environments that are deleted when their `connic dev` session ends.
  - `test_environment_id` string, uuid, nullable, required: Environment the test suite runs in for deploy gate and pull request tests. Null runs the tests in this environment.
  - `pr_testing_enabled` boolean, required: Whether the test suite runs for pull requests that target `git_branch`.
  - `deploy_gate_tests_enabled` boolean, required: Whether deployments run the test suite before activating. A failing case stops the deployment.
  - `log_retention_seconds` integer, nullable, required: How long run data is kept, in seconds. Null applies the plan's default retention.
  - `log_retention_max_seconds` integer, nullable, required: Longest retention the project's plan allows, in seconds. Null means no limit.
  - `redacted_keys` string[], required: Dot-separated JSON paths whose values are replaced with `[REDACTED]` in stored run data, traces and connector logs. A leading `*` matches at any depth, as in `*.password`.
  - `manual_deploy_group_ids` string[], nullable, required: Permission groups whose members can deploy to this environment manually. Null allows everyone with deploy permission; an empty list allows only the project owner.
  - `copy_from_group_ids` string[], nullable, required: Permission groups whose members can copy from this environment into other environments. Null allows everyone; an empty list allows only the project owner.
  - `can_copy_from` boolean, required: Whether the caller can use this environment as a copy source. Always false for dev environments.
  - `can_deploy` boolean, required: Whether the caller can deploy to this environment manually.
  - `can_use_dev_session` boolean, required: Whether the caller can run a `connic dev` session in this environment. Only dev environments allow it.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `deleted_at` string, date-time, nullable, required: Always null, because deleted environments are not returned.

## Other responses

- `401`: Missing or invalid API key.
- `403`: The API key lacks the required permission or access to the environment.
- `404`: The resource does not exist in this project.
- `422`: Validation Error
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/connic/apis/connic-api.md) · [All operations](https://skmtc.dev/connic/apis/connic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/connic/apis/connic-api/revisions/482932da5fbe?raw)