---
title: "List projects"
method: GET
path: "/v2/teams/{team_id}/projects"
tags: ["v2", "Projects"]
---

# List projects

`GET /v2/teams/{team_id}/projects`

## Path parameters

- `team_id` union, required
  - string, uuid
  - string

## Query parameters

- `orderBy` 'updated_at' | 'created_at' | 'name'
- `desc` boolean
- `archived` boolean
- `name` string, nullable

## Response `200`

Success

- ProjectWithCounts[]
  - `id` union — Project ID
    - string, uuid
    - string
  - `team_id` union, required — Team ID
    - string, uuid
    - string
  - `name` string, required — Project name
  - `description` string, nullable — Optional description
  - `created_by` union, required — User ID who created the project
    - string, uuid
    - string
  - `created_at` string, date-time — Project created at
  - `updated_at` string, date-time — Project updated at
  - `is_archived` boolean — Grave marker for soft deletion
  - `team_wide_permission` 'read' | 'write', nullable — If set, all team members get this permission on docs in the project
  - `doc_count` integer — Number of docs in project
  - `thread_count` integer — Number of threads in project

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/5ea378187147/schema)