---
title: "Projects Reference"
description: "Reference for Project availability, ownership, views, resources, limits, and lifecycle behavior."
canonical: https://y2.dev/docs/projects/reference/
---

Projects

# Projects Reference

Reference for Project availability, ownership, views, resources, limits, and lifecycle behavior.

## Availability and access

| Rule            | Behavior                                                                                    |
| --------------- | ------------------------------------------------------------------------------------------- |
| Minimum plan    | Lite                                                                                        |
| Workspace scope | The active workspace must match the Project workspace.                                      |
| Ownership       | Private by default. The owner can grant selected workspace members reader or editor access. |
| Write access    | Workspace write role and Project owner or editor access. Readers cannot write.              |
| Context policy  | `project_only`                                                                              |
| Elite audit     | Material changes include the workspace and acting user.                                     |

## Project fields

| Field               | Constraint or meaning                                        |
| ------------------- | ------------------------------------------------------------ |
| Name                | Required, up to 80 characters.                               |
| Objective           | Optional, up to 1,000 characters.                            |
| Instructions        | Optional, up to 8,000 characters.                            |
| Status              | `active` or `archived`.                                      |
| Default view        | Graph, Timeline, Situation, Reports, Evidence, or Knowledge. |
| Default time window | 24 hours, 7 days, 30 days, or custom.                        |
| Revision            | Used to reject conflicting settings updates.                 |

## Supported resource types

| Resource                  | Ownership check                                     |
| ------------------------- | --------------------------------------------------- |
| Investigation graph board | Same owner and workspace.                           |
| Profile                   | Same owner and workspace.                           |
| Report                    | Its profile must have the same owner and workspace. |
| Generated image           | Same owner and workspace.                           |

Resource roles are `knowledge`, `working`, `output`, and `primary_graph`.

## View and storage limits

- Persistent graphs: 250 nodes and 500 edges.
- Recent Project chat list: the app displays up to 12 threads.
- Project instructions: 8,000 characters.
- Graph title: 200 characters.
- Private knowledge accepts PDF, text, Markdown, Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, and CSV files up to 10 MB.
- PDFs must contain selectable text. Scanned pages requiring OCR are rejected.
- Private knowledge is capped at 100 documents per owner and workspace, 200 PDF pages, 2,000,000 extracted characters, and 512 indexed chunks per revision.
- Evidence attachments are separate from Project knowledge and use their own archive and integrity rules.

## Lifecycle

Archiving is reversible. Project resources, chat association, evidence history, graph state, and private knowledge remain stored. Active-only mutations reject archived Projects until restored.

Deleting an attached resource link does not delete the original report, profile, graph board, or image. Evidence pruning and knowledge-source deletion have separate confirmation and retention behavior in their respective views.