# list_projects

List projects in a workspace with their name, status, and linked object count.

Projects group related library objects (images, videos, models, etc.) into a shared  
collection. By default only active projects are returned; set filter.include\_archived  
to also include archived projects. Deleted projects are never returned.

## Parameters

| Parameter             | Type            | Default | Description                                                                          |
| --------------------- | --------------- | ------- | ------------------------------------------------------------------------------------ |
| workspace\_idrequired | string (uuid)   | —       | The user's workspace id.                                                             |
| filter                | QueryFilter     | —       | Query filters                                                                        |
| include\_archived     | boolean         | false   | When true, include archived projects alongside active ones. Defaults to active only. |
| pagination            | PaginationInput | —       | Parameters driving result pagination                                                 |
| limit                 | integer1–100    | 20      | Maximum number of results to return                                                  |
| cursor                | string          | —       | Cursor from which to return results                                                  |