Projects and Organizations

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

Use an organization for the team

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

Add Projects

Create projects for different applications, products, or customer environments.

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.

⌘I

Concepts

Glossary

Understanding the Hierarchy

Organizations

Projects

Instances

Structuring Your Workspace

Using Different API Keys

What’s Next?

Environments Guide

Providers

​Understanding the Hierarchy

​Organizations

​Projects

​Instances

​Structuring Your Workspace

​Using Different API Keys

​What’s Next?

Environments Guide

Providers

Understanding the Hierarchy

Organizations

Projects

Instances

Structuring Your Workspace

Using Different API Keys

What’s Next?