---
title: "List projects in your organization"
method: GET
path: "/api/v1/projects"
tags: ["Projects"]
---

# List projects in your organization

`GET /api/v1/projects`

## Request

- Base URL: `https://getorquesta.com`
- URL: `https://getorquesta.com/api/v1/projects`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

For agent tokens (`oat_`), returns only the token's project.

## Response `200`

Project list.

- object
  - `projects` Project[], required
    - `id` string, uuid, required
    - `name` string, required
    - `slug` string
    - `description` string, nullable
    - `agentOnline` boolean
    - `agentLastSeen` string, date-time, nullable
    - `productionUrl` string, uri, nullable
    - `iconUrl` string, uri, nullable: Project icon: the published site's favicon, else the GitHub repo owner's avatar. Null when the project has neither.
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time

## Other responses

- `401`: Missing or invalid API key.
- `403`: Insufficient scope, revoked token, or project-scope mismatch.

---

[API](https://skmtc.dev/getorquesta/apis/orquesta-public-api.md) · [All operations](https://skmtc.dev/getorquesta/apis/orquesta-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getorquesta/apis/orquesta-public-api/revisions/7d27e0ae8324?raw)