# Dataset Concepts

# Projects

Projects are the top-level organizer. Each project has its own datasets and API keys.

# Datasets

A dataset represents a single table of data, typically originating from one CSV file. Each dataset has:

  • A name and description
  • A schema (columns with types)
  • One or more uploads
  • A generated REST endpoint

# Uploads

An upload represents a single CSV file uploaded to a dataset. Uploads go through these statuses:

  • pending — Upload record created, waiting for file
  • processing — CSV is being parsed and ingested
  • ready — Data is available via the API
  • failed — Processing encountered an error

# Versions

Future versions of FireCSV will support dataset versioning, allowing you to update data while maintaining access to previous versions.