GCgc-ai
Projects

Create a project

Create a new project to group files, folders, and chats around a single matter (deal, vendor, or program).

With a user-scoped key, the caller is recorded as the project creator and granted admin access. With an org-scoped key, creatorId is null and the project defaults to non-access-controlled (org-wide).

post/projects

Request

Request body

namestring required

Project name (required, non-empty after trim)

descriptionstring nullable

Optional project description

custom_instructionsstring nullable

Optional custom instructions for chats in this project

is_access_controlledboolean

When true (default), the project is visible only to the creator and explicitly granted users. When false, any member of the organization can see it.

Example request

{
  "name": "Vendor: Acme MSA"
}

Response

Project created

idstring uuid required

Unique project identifier

namestring required

Project name

descriptionstring nullable required

Project description, or null if unset

custom_instructionsstring nullable required

Custom instructions injected into chats opened in this project

is_access_controlledboolean required

When true, only the creator and explicitly granted users can see the project. When false, any member of the organization can see it.

my_access_level'read' | 'write' | 'admin' | 'null' nullable required

Caller's access level on this project: admin (creator or explicitly granted admin), write, read, or null if the caller has no recorded grant. null is also returned for org-scoped keys, which carry no user identity.

created_atstring required

ISO 8601 creation timestamp

updated_atstring required

ISO 8601 last-update timestamp

Changes

No recorded changes to this operation across all 1 revision of this API.