Projects and Organizations

Organizations and projects help you structure your work in Metorial and manage access to resources.

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)
        └── Server Deployments
        └── API Keys
        └── OAuth Sessions

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).

Creating Your Workspace

1. First-Time Setup

   When you sign up, you’ll create your first organization and project.

2. Add Projects

   Create additional projects for different applications.

   

Using Different API Keys

Projects and Instances are isolated - use different API keys for different projects:

TypeScript

// 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
});

What’s Next?

Environments Guide

Learn about development vs production instances.

Server Deployments

Create deployments within your projects.