GET /v2/projects

List projects

Returns a paginated list of projects accessible to the authenticated user. Results can be filtered by status and searched by name or repository. Items are ordered by most recently updated.

Requires authentication. Send a bearer token in the Authorization header. Tokens are scoped per workspace.

Query parameters

per_page integer optional: Number of items per page. Max 100, defaults to 20.
page integer optional: Page number to retrieve. Defaults to 1.
status string optional: Filter by documentation status: live, building, or draft.
q string optional: Full-text search across project name and repository slug.

Responses

200 OK — A paginated list of projects.

401 Unauthorized — Missing or invalid bearer token.

422 Unprocessable — An invalid query parameter was supplied.

Response schema

200 · application/json

data array<Project>: The list of projects for the authenticated account.
data[].id string: Unique project identifier, prefixed with prj_.
data[].name string: Human-readable project name.
data[].repository string: Connected repository in owner/name form.
data[].status enum: One of live, building, draft.
meta object: Pagination metadata: page, per_page, total.

Overview Create a project

Request

curl https://api.repodocs.dev/v2/projects \
  -H "Authorization: Bearer $REPODOCS_TOKEN" \
  -G \
  -d per_page=20 \
  -d status=live

const res = await fetch(
  "https://api.repodocs.dev/v2/projects?per_page=20&status=live",
  { headers: { Authorization: `Bearer ${process.env.REPODOCS_TOKEN}` } }
);

const { data } = await res.json();

import requests

res = requests.get(
    "https://api.repodocs.dev/v2/projects",
    headers={"Authorization": f"Bearer {token}"},
    params={"per_page": 20, "status": "live"},
)

projects = res.json()["data"]

req, _ := http.NewRequest("GET",
    "https://api.repodocs.dev/v2/projects?status=live", nil)
req.Header.Set("Authorization", "Bearer "+token)

resp, err := http.DefaultClient.Do(req)

$response = Http::withToken($token)
    ->get('https://api.repodocs.dev/v2/projects', [
        'per_page' => 20,
        'status'   => 'live',
    ]);

$projects = $response->json('data');

Response example

{
  "data": [
    {
      "id": "prj_8Fk2Lq",
      "name": "acme-backend",
      "repository": "acme/backend",
      "stack": "NestJS",
      "status": "live",
      "docs_url": "https://acme-backend.repodocs.dev",
      "created_at": "2026-01-12T09:24:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 8
  }
}