Skip to main content
What you’ll learn:
  • How organizations and projects are structured
  • How to organize your deployments

​
Understanding the Hierarchy

Metorial uses a hierarchy to organize your work: 
Organization
└── Project(s)
    └── Instance(s)
        └── Provider Deployments
        └── API Keys
        └── Provider Auth Configs

​
Organizations

An organization is your top-level workspace - typically representing your company, team, or personal account.

​
Projects

A project is a container for related work - typically representing an application or product.

​
Instances

An instance represents an environment within a project (e.g., Development, Production).

​
Structuring Your Workspace

1

Use an organization for the team

Keep team-level settings, members, and shared access under the organization.
2

Add Projects

Create projects for different applications, products, or customer environments.Create additional projects in Metorial

​
Using Different API Keys

Projects and Instances are isolated - use different API keys for different projects: 
// Project A
let metorialA = new Metorial({
    apiKey: process.env.METORIAL_PROJECT_A_KEY
});

// Project B
let metorialB = new Metorial({
    apiKey: process.env.METORIAL_PROJECT_B_KEY
});

import os
from metorial import Metorial

# Project A
metorial_a = Metorial(api_key=os.getenv("METORIAL_PROJECT_A_KEY"))

# Project B
metorial_b = Metorial(api_key=os.getenv("METORIAL_PROJECT_B_KEY"))

​
What’s Next?

Environments Guide

Learn about development vs production instances.

Providers

Manage provider deployments within your projects.