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