Skip to main content

Environments

Use the Environments API to define incident groups based on incident properties such as source, severity, or alert data, allowing your team to focus on the incidents relevant to their role.

Environments

Authentication

All BigPanda APIs require Bearer Token Authorization in the call headers.

This API uses the User API Key type of Authorization token.

BigPanda recommends adding Authentication headers only in the secure tool you use to make API calls.

Environments requirements

Environment names must be unique.

If no filter is specified when creating an environment, all incidents will be included in the environment.

Example 1. Create an environment
curl --request POST \
     --url https://api.bigpanda.io/resources/v2.0/environments \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json' \
     --data '{
        "name": "Platform Team",
        "description": "Environment is owned by the Platform team.",
        "environment_group_id": "6696265c4c28e11e591e2cr36",
        "roles": [{
          "id": "768abaae85f1e3ceb4d61n45",
          "name": "Admin"
        }],
        "read_only_roles": [{
          "id": "668abaaf85f1e3ceb4d61nl7",
          "name": "Viewer (Read-only)"
        }],
        "filter": "region = AW*"
      }'
curl --request POST \
     --url https://eu-api.bigpanda.io/resources/v2.0/environments \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json' \
     --data '{
        "name": "Platform Team",
        "description": "Environment is owned by the Platform team.",
        "environment_group_id": "6696265c4c28e11e591e2cr36",
        "roles": [{
          "id": "768abaae85f1e3ceb4d61n45",
          "name": "Admin"
        }],
        "read_only_roles": [{
          "id": "668abaaf85f1e3ceb4d61nl7",
          "name": "Viewer (Read-only)"
        }],
        "filter": "region = AW*"
      }'


Example 2. Retrieve an environment by ID
curl --request GET \
     --url https://api.bigpanda.io/resources/v2.0/environments/{id} \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json'
curl --request GET \
     --url https://eu-api.bigpanda.io/resources/v2.0/environments{id} \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json'


Example 3. Retrieve all environments
curl --request GET \
     --url https://api.bigpanda.io/resources/v2.0/environments \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json'
curl --request GET \
     --url https://eu-api.bigpanda.io/resources/v2.0/environments \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json'


Example 4. Update environment
curl --request PATCH \
     --url https://api.bigpanda.io/resources/v2.0/environments/${id} \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json' \
     --data '{
        "name": "UI Team",
        "description": "Environment is owned by the UI Team",
        "environment_group_id": "6696265c4c28e11e591e2mn6",
        "roles": [{
          "key": "768abaae85f1e3ceb4d61m92",
          "name": "Admin"
        }],
        "read_only_roles": [{
          "key": "668abaaf85f1e3ceb4d61mn6",
          "name": "Viewer (Read-only)"
        }],
        "filter": "region = AW*"
      }'
curl --request PATCH \
     --url https://eu-api.bigpanda.io/resources/v2.0/environments/${id} \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json' \
     --data '{
        "name": "UI Team",
        "description": "Environment is owned by the UI Team",
        "environment_group_id": "6696265c4c28e11e591e2mn6",
        "roles": [{
          "key": "768abaae85f1e3ceb4d61m92",
          "name": "Admin"
        }],
        "read_only_roles": [{
          "key": "668abaaf85f1e3ceb4d61mn6",
          "name": "Viewer (Read-only)"
        }],
        "filter": "region = AW*"
      }'


Example 5. Delete environment
curl --request DELETE \
     --url https://api.bigpanda.io/resources/v2.0/environments/${id} \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json'
 curl --request DELETE \
     --url https://eu-api.bigpanda.io/resources/v2.0/environments/${id} \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json'


Example 6. Create an environment group
curl --request POST \
     --url https://api.bigpanda.io/resources/v2.0/environments-groups \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json' \
     --data '{
        "name": "EnvGroupName"
      }'
curl --request POST \
     --url https://eu-api.bigpanda.io/resources/v2.0/environments-groups \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json' \
     --data '{
        "name": "EnvGroupName"
      }'


Example 7. Retrieve all environment groups
curl --request GET \
     --url https://api.bigpanda.io/resources/v2.0/environments-groups \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json'
curl --request GET \
     --url https://eu-api.bigpanda.io/resources/v2.0/environments-groups \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json'


Example 8. Update environment group
curl --request PUT \
     --url https://api.bigpanda.io/resources/v2.0/environments-groups/${id} \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json' \
     --data '{
      {
        "name": "koko13372",
        "environment_ids": [
          "66572522d88f17578d90ceb2",
          "665dd07429873a99abdf7543"
        ]     
      }'
curl --request PUT \
     --url https://eu-api.bigpanda.io/resources/v2.0/environments-groups/${id} \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json' \
     --data '{
      {
        "name": "koko13372",
        "isDefault": false,
        "environment_ids": [
          "66572522d88f17578d90ceb2",
          "665dd07429873a99abdf7543"
        ]     
      }'


Example 9. Delete environment group
curl --request DELETE \
     --url https://api.bigpanda.io/resources/v2.0/environments-groups/${id} \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json'
curl --request DELETE \
     --url https://eu-api.bigpanda.io/resources/v2.0/environments-groups/${id} \
     --header 'Authorization: Bearer <User API Key>' \
     --header 'Content-Type: application/json'