Introduction to Projects

  • Belongs to an Organization
  • Organizes related data together, like a “database” in an RDBMS
  • Contains one or more tables
  • Has configuration attributes like users, roles, read and write access, etc…
  • Needs to be referenced when ingesting and querying.

For example, in an organization you could have three different Projects, “Systems Monitoring”, “Stock Trading”, and “IOT” for 3 different sets of unrelated data. They can all co-exist in the same deployment.


Projects can be managed via the web user interface or the Project API.

An example of creating a project can be found in the quickstart.

Create a Project

To create a project, a call is made to the create project API.


  • an acccess_token from login
  • UUID of the organization where the project should be created
  • a name for the project

The organization UUID is specified in the path as well as in the request document.

The response will carry a UUID for the project. This will be needed for project operations, like creating tables.

    "uuid": "the-project-uuid",
    "name": "firstproject",
    "description": "stuff",
    "created": "2020-05-04T23:08:11.488083Z",
    "modified": "2020-05-04T23:08:11.488104Z",
    "org": "the-org-uuid-from-request"