Projects are workspace containers within an organization that group related content and assets. Each project maintains its own set of components, content types, content, and assets.
The Project Object
URL-friendly project identifier
Environment label. Always an empty string; it cannot be set through the API.
Project settings including locales, platforms, and CDN configuration
Project dependencies with projectId and version
Project-level permissions and role configurations
Additional project metadata including createdBy and tags
Creation timestamp (ISO 8601 format)
Last update timestamp (ISO 8601 format)
Settings Object
Example Object
Project Structure
Projects contain the following resources:
- Collections - Organizational groups for components
- Components - View and layout components with versions
- Content Types - Schemas defining content structure
- Content - Actual content entries
- Assets - Media files and images
- Saved Searches - Reusable search configurations
- Packages - Versioned snapshots of components
Project Dependencies
Projects can depend on other projects, allowing you to share components and content types across projects. Dependencies are specified with a project ID and semantic version.
When a package is created, it snapshots the current project dependencies, ensuring consistent behavior across deployments.