API Reference

V2 Projects

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

List Projects

v2_projects.list(V2ProjectListParams**kwargs) -> SyncPaginatedCursor[V2ProjectListResponse]

GET/api/v2/projects

List projects in an organization. Requires organization_id or a project-scoped API key.

ParametersExpand Collapse

name: Optional[str]

organization_id: Optional[str]

page_size: Optional[int]

page_token: Optional[str]

ReturnsExpand Collapse

class V2ProjectListResponse: …

API response schema for a project.

id: str

The project’s unique identifier.

name: str

The project’s display name.

organization_id: str

The organization the project belongs to.

created_at: Optional[datetime]

Creation datetime

formatdate-time

is_default: Optional[bool]

Whether this project is the default project for its organization.

updated_at: Optional[datetime]

Update datetime

formatdate-time

List Projects

Python

HTTP

TypeScript

Python

Go

Java

C#

CLI Tool

import os
from llama_cloud import LlamaCloud

client = LlamaCloud(
    api_key=os.environ.get("LLAMA_CLOUD_API_KEY"),  # This is the default and can be omitted
)
page = client.v2_projects.list()
page = page.items[0]
print(page.id)

200 example

{
  "items": [
    {
      "id": "id",
      "name": "name",
      "organization_id": "organization_id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "is_default": true,
      "updated_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}

Returns Examples

200 example

{
  "items": [
    {
      "id": "id",
      "name": "name",
      "organization_id": "organization_id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "is_default": true,
      "updated_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "next_page_token": "next_page_token",
  "total_size": 0
}