diff --git a/DEVELOPERS.md b/DEVELOPERS.md
index e92a19bdc45..8dc4cc188d5 100644
--- a/DEVELOPERS.md
+++ b/DEVELOPERS.md
@@ -15,7 +15,7 @@
- [Installing packages](#installing-packages)
- [Development](#development)
- [Common Tasks](#common-tasks)
- - [Adding redirects](#adding-redirects)
+ - [Adding Redirects](#adding-redirects)
- [Finally](#finally)
- [Community Channels](#community-channels)
@@ -181,6 +181,8 @@ Then edit and visit any of the following sites:
- `/apps/www`: http://localhost:3000
- The main website.
+- `/apps/reference`: http://localhost:3010
+ - Reference Documentation.
- `/apps/temp-docs`: http://localhost:3001
- We are migrating the docs to a Next.js application.
- `/apps/temp-community-forum`: http://localhost:3002
@@ -194,6 +196,7 @@ The monorepo has a set of shared components under `/packages`:
- `/packages/common`: Common React code, shared between all sites.
- `/packages/config`: All shared config
+- `/packages/spec`: Generates documentation using spec files.
- `/packages/tsconfig`: Shared Typescript settings
### Installing packages
diff --git a/apps/reference/_api/intro.md b/apps/reference/_api/intro.md
index 5bd32acd56d..d10d6bd02c3 100644
--- a/apps/reference/_api/intro.md
+++ b/apps/reference/_api/intro.md
@@ -1,7 +1,7 @@
---
slug: /
sidebar_position: 1
-sidebar_label: Introduction
+sidebar_label: Supabase API
---
# Supabase API
diff --git a/apps/reference/_api/usage.mdx b/apps/reference/_api/usage.mdx
index 5f5bd57fa83..dffc811a487 100644
--- a/apps/reference/_api/usage.mdx
+++ b/apps/reference/_api/usage.mdx
@@ -5,7 +5,6 @@ title: Usage
-An isomorphic Javascript library for GoTrue.
@@ -14,50 +13,37 @@ An isomorphic Javascript library for GoTrue.
-## New user signup
-```js
-const { user, session, error } = await gotrue.signUp({
- email: 'example@email.com',
- password: 'example-password',
-})
+### Lists all organizations
+
+```
+/v1/organizations
```
-### Attributes
+### Creates an organization
-- param-signup-options
-
-- param-options
-
-
-
-### Notes
-
-- By default, the user will need to verify their email address before logging in. If you would like to change this, you can disable "Email Confirmations" by going to Authentication -> Settings on [app.supabase.com](https://app.supabase.com)
-- If "Email Confirmations" is turned on, a `user` is returned but `session` will be null
-- If "Email Confirmations" is turned off, both a `user` and a `session` will be returned
-- When the user confirms their email address, they will be redirected to localhost:3000 by default. To change this, you can go to Authentication -> Settings on [app.supabase.com](https://app.supabase.com)
-- If signUp() is called for an existing confirmed user:
- - If "Enable email confirmations" is enabled on the "Authentication" -> "Settings" page, an obfuscated / fake user object will be returned.
- - If "Enable email confirmations" is disabled, an error with a message "User already registered" will be returned.
-- To check if a user already exists, refer to getUser().
-
-
-### Examples
-
-
-
-#### Sign up with email
-
-```js
-const { user, session, error } = await supabase.auth.signUp({
- email: 'example@email.com',
- password: 'example-password',
-})
+```
+/v1/organizations
```
+
+### Gets all projects that belong to the authenticated user
+
+```
+/v1/projects
+```
+
+
+
+### Creates a project
+
+```
+/v1/projects
+```
+
+
diff --git a/apps/reference/_cli/intro.mdx b/apps/reference/_cli/intro.mdx
index e80457aeb6f..e11e387e866 100644
--- a/apps/reference/_cli/intro.mdx
+++ b/apps/reference/_cli/intro.mdx
@@ -2,7 +2,7 @@
id: intro
slug: /
sidebar_position: 1
-sidebar_label: Introduction
+sidebar_label: Supabase CLI
---
# Supabase CLI
diff --git a/apps/reference/_cli/usage.mdx b/apps/reference/_cli/usage.mdx
index 31c4666ddd0..9959e7dc443 100644
--- a/apps/reference/_cli/usage.mdx
+++ b/apps/reference/_cli/usage.mdx
@@ -12,7 +12,10 @@ Supabase CLI.
-## Manage your Edge Functions
+
+
+HTTP headers.
+`cacheControl`: string, the `Cache-Control: max-age=` seconds value.
+`contentType`: string, the `Content-Type` header value. Should be specified if using a `fileBody` that is neither `Blob` nor `File` nor `FormData`, otherwise will default to `text/plain;charset=UTF-8`.
+`upsert`: boolean, whether to perform an upsert.
+
+