Creating Collections

Collections can be created using the Bluebricks API, Command Line, or User Interface.

Overview

Collections organize infrastructure into clear units that match how teams actually work. You can create separate collections for projects, teams, or lifecycle stages such as development, staging, and production. Each collection provides the foundation for environments by holding shared settings and rules.

Example of creating a collection with AWS

Create a collection via the UI

1. Go to the Collections page

2. Click Create Collection

3. Enter a name for the collection

4. Select the cloud provider(s) to connect

   1. Haven't connected your cloud accounts yet? Learn how to connect your cloud

5. Configure any required settings, permissions, and secrets

6. Click Create to finalize the setup

Create a collection via the CLI

You can create a new collection using the Bluebricks CLI (refer to Bricks CLI Installation Guide if you haven't installed it yet):

bricks env create --name="Self-Hosted Orchestrator"

A successful creation will display a confirmation message with the new collection ID:

✓ `Self-Hosted Orchestrator` environment created successfully with ID: 42c9d5cf-cf9c-4783-ac1d-4d34140b9299

Create a collection via the API

You can also create a collection using a direct API call. First, you'll obtain a valid bearer token then make the API call to create a collection:

curl https://api.bluebricks.co/api/v1/collections \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_BEARER_TOKEN' \
  --data '{
    "name": "Self-Hosted Orchestrator",
    "description": "Collection for self-hosted orchestrator"
  }'

Replace YOUR_BEARER_TOKEN with your token.