Understanding Your Workspace

Every FoxNose setup is organized around three core building blocks: Organizations, Projects, and Environments. Understanding this hierarchy is the key to managing your applications effectively.

Here’s the basic structure:

Organization (e.g., Acme Corp)
└── Project (e.g., Support Agent)
    ├── Environment (e.g., Production)
    ├── Environment (e.g., Staging)
    └── Environment (e.g., Development)

1. Understanding Organization

The Organization is the top-level container. It holds all your projects and billing information. When you sign up, a personal organization is created for you.

• Contains: Projects
• Controls: Billing & Subscriptions

An organization is single-owner today: it is managed by the account that created it. Role-scoped API keys are the way to grant limited access to services and agents; team member invitations are on the roadmap.

2. Understanding Project

A Project contains all the data and configuration for a single application (e.g., your public website, a mobile app, or an internal knowledge base).

• Contains: Environments & a specific data region.
• Controls: The overall data architecture for one application.

When you create a project, you choose a geographic region where its data will be stored.

3. Understanding Environment

An Environment is a complete, isolated container for your project's data. Think of them as separate deployments of your application (production, staging, development). Each environment is assigned its own unique host, making all its APIs available on a distinct domain.

When you create a new environment, it starts empty. It does not automatically inherit data from other environments, ensuring a clean slate for testing or development.

• Contains: An independent set of your project's data.
• Controls: The content for a specific stage (live, testing, etc.).

By default, every new project comes with a Production environment. You can easily create more for development, testing, or previewing changes.

What Lives Inside an Environment

Below environments live Collections, Resources, and Revisions — the layers that hold and version your actual content. For the full hierarchy and how each piece fits together, see The FoxNose Data Model.

To start building, learn how to structure content in Collections, or follow the Quick Start to create your first project end to end.