---
title: "List Projects"
method: GET
path: "/v1/projects"
tags: ["projects"]
---

# List Projects

`GET /v1/projects`

## Request

- Base URL: `https://api.pioneer.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pioneer.ai/v1/projects`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/pioneer/apis/brain-api/docs/v1/projects/get.ts> (a function with typed inputs; its response is checked against the schema)

List projects visible to the caller.

Args:
    auth: Authenticated caller.
    service: Project service.

Returns:
    Visible projects and count.

## Response `200`

Successful Response

- ProjectListResponse: Response model for listing projects.
  - `success` boolean
  - `projects` ProjectResponse[], required
    - `id` string, required
    - `user_id` string, required
    - `name` string, required
    - `icon` string
    - `repo` string, nullable
    - `description` string, nullable
    - `active_model_id` string, nullable
    - `tag` string, nullable
    - `observations` string, nullable
    - `example` object, nullable
    - `team_id` string, required
    - `visibility` string
    - `adaptive_cadence` 'off' | 'daily' | 'weekly' | 'monthly': User-facing cadence preset for autonomous adaptive finetuning runs.
    - `autonomy_enabled` boolean
    - `created_at` string, required
    - `updated_at` string, required
    - `selected_model_id` string, nullable, required: Deprecated alias for active_model_id -- kept for backward compat.
  - `count` integer, required

## Changes

- **2026-09-24** `0e5e86e2bae5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pioneer/apis/brain-api/changes/v1/projects/get.md)

---

[API](https://skmtc.dev/pioneer/apis/brain-api.md) - [All operations](https://skmtc.dev/pioneer/apis/brain-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pioneer/apis/brain-api/revisions/0e5e86e2bae5?raw)