> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List Projects

> List all projects for the authenticated user

Returns all projects owned by the authenticated user.

## Authentication

Requires a valid Bearer token.

## Response

<ResponseField name="projects" type="array">
  List of project objects.

  <Expandable title="Project object">
    <ResponseField name="id" type="string" required>
      Unique project identifier (UUID).
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Project name.
    </ResponseField>

    <ResponseField name="description" type="string">
      Project description.
    </ResponseField>

    <ResponseField name="repo_url" type="string">
      Linked repository URL.
    </ResponseField>

    <ResponseField name="created_at" type="string" required>
      ISO 8601 timestamp.
    </ResponseField>

    <ResponseField name="updated_at" type="string" required>
      ISO 8601 timestamp.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "projects": [
      {
        "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
        "name": "my-project",
        "description": "A web application",
        "repo_url": "https://github.com/user/repo",
        "created_at": "2025-01-15T10:30:00Z",
        "updated_at": "2025-01-15T10:30:00Z"
      }
    ]
  }
  ```
</ResponseExample>

## Errors

| Status | Description                             |
| ------ | --------------------------------------- |
| `401`  | Unauthorized — missing or invalid token |