Skip to main content

Projects

Projects provide data isolation and access control to collections of resources within an organization. Every recording, device, and event belongs to one Project.

info

Projects are currently in beta. Contact us at [email protected] for early access.

What can you do with Projects?

Projects enable you to organize data and control access within your organization.

  • Separate production and development workflows
  • Organize data by team or customer
  • Share subsets of data with specific members

Creating a Project

Every organization starts with a single Project. Admins of enterprise organizations can create additional Projects from the Projects page.

When creating a new Project:

  1. All data remains available under existing Projects.
  2. Members retain their current access to Projects.
warning

Before creating a second Project, ensure all programmatic uploads specify a Project or existing device. See below.

Access control

Admins can assign members to Projects via the Members page.

  • Members with the user role can only see and access Projects they are assigned to.
  • Members with the admin role can access all Projects.
  • API Keys can access all Projects.

Projects are isolated. Data in one Project cannot be accessed from or moved to another Project.

Associating data

We recommend always providing a Project ID when interacting with Foxglove programmatically. For organizations with multiple Projects, a Project ID is required when creating devices or uploading recordings without an existing device.

Project IDs can be found on the Projects page.

API requests

Endpoints that create or list Project scoped resources accept a projectId field to specify the Project. See API docs for more information.

Self-hosted Primary Sites

Providing a foxglove_project_id record in object metadata or a projectId in MCAP metadata associates the upload with a Project. See Site docs for more information.

Self-hosted Primary Sites support Projects as of version 0.0.69.

Web and desktop apps

Uploading files and creating devices from the Foxglove dashboard automatically associates them with the current Project.

Project vs Organization scoped resources

Every device, event, and recording belongs to a single Project. Data in one Project cannot be accessed from another Project.

Resources at the organization level work across all Projects.

ResourceProjectOrganization
Devices
Events
Recordings
API Keys
Custom Properties
Extensions
Layouts
Sites
Webhooks