Projects

A project groups the business’s docs, tables and contacts around one piece of work, such as “Juniper Dental rebrand” or “Bookkeeping 2026”. Every doc goes in one.

Use the project the owner named. Otherwise list them and pick the one the work belongs to, or create one named after the job.

How to use it

What find_tools sends with these tools, word for word:

Projects group the owner’s docs, tables and contacts, and every doc goes in one. Use the project the owner named; else list them and pick the one the work belongs to, or create one named after the job.

Tools

Tool	What it does	Owner’s yes
projects.list	Every project in the workspace	No
projects.activity	Recent changes across the workspace	No
projects.create	Create a project	No
projects.update	Rename a project or change its description	Checked

list

projects.list · Every project in the workspace.

Owner’s yes: No. Nothing of the owner’s changes.

Input	Type	Required	Limits
offset	whole number	no	0 or more

Returns:

{
  items: {
    id: string;
    organizationId: string;
    name: string;
    description: string;
    createdByUserId: string | null;
    updatedByUserId: string | null;
    createdAt: string;
    updatedAt: string;
  }[];
  nextOffset: number | null;
}

activity

projects.activity · Recent changes across the workspace.

Owner’s yes: No. Nothing of the owner’s changes.

Input	Type	Required	Limits
offset	whole number	no	0 or more

Returns:

{
  items: WorkspaceActivityItem[];
  nextOffset: number | null;
}

create

projects.create · Create a project.

Owner’s yes: No. It makes something new.
Your work: listed on Home.

Input	Type	Required	Limits
name	text	yes	1–120 characters
description	text	no	up to 4,000 characters, default “”

Returns:

{
  name: string;
  description: string;
  id: string;
  createdAt: string;
  organizationId: string;
  createdByUserId: string | null;
  updatedByUserId: string | null;
  updatedAt: string;
} | {
  id: string;
  organizationId: string;
  name: string;
  description: string;
  createdByUserId: string | null;
  updatedByUserId: string | null;
  createdAt: string;
  updatedAt: string;
}

update

projects.update · Rename a project or change its description.

Owner’s yes: Checked. It changes what’s there.
Your work: listed on Home.

Input	Type	Required	Limits
projectId	id	yes
name	text	yes	1–120 characters
description	text	yes	up to 4,000 characters

Returns:

{
  id: string;
  organizationId: string;
  name: string;
  description: string;
  createdByUserId: string | null;
  updatedByUserId: string | null;
  createdAt: string;
  updatedAt: string;
}

Types

Named types in the results above.

type WorkspaceActivityItem = {
  id: string;
  kind: "question" | "thesis" | "company" | "comment" | "member" | "chat" | "project" | "annotation" | "dataset" | "investment";
  title: string;
  summary: string;
  occurredAt: string;
  actorName: string | null;
  projectId: string | null;
  projectName: string | null;
  target: {
    type: "page" | "workspace" | "company" | "project";
    id: string;
  } | {
    type: "dataset";
    id: string;
    projectId?: string;
  } | {
    type: "chat";
    id: string;
    projectId: string;
  };
  private: boolean;
}