---
title: "List project context"
method: GET
path: "/websiteKnowledge"
tags: ["Project Context"]
---

# List project context

`GET /websiteKnowledge`

## Request

- Base URL: `https://api.cactal.ai/v1`
- URL: `https://api.cactal.ai/v1/websiteKnowledge`
- Auth: HTTP bearer

Lists the website’s private durable context entries: uploaded files and pasted text, each with a `title`, a generated `description`, and an `origin` of `upload` or `text`.

## Query parameters

- `websiteId` string, required

## Response `200`

Up to 25 context entries, newest first.

- object[]
  - `id` string, required
  - `title` string, required
  - `origin` 'upload' | 'text', required
  - `filename` string, required
  - `mimeType` 'application/pdf' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'text/plain' | 'text/markdown' | 'image/png' | 'image/jpeg' | 'image/webp' | 'image/svg+xml', required
  - `byteSize` integer, required
  - `description` string, required
  - `lineCount` integer, nullable, required
  - `colors` object[], nullable, required: Up to 8 representative colors sorted by share. `null` for files and for images that could not be analyzed.
    - `hex` string, required: Uppercase sRGB hex, exact for flat colors.
    - `share` number, nullable, required: Fraction of opaque pixels this color and its anti-aliasing cover. `null` for SVG, whose colors are read from the source instead of rendered.
    - `accent` boolean, required: Saturated enough to matter as an accent even at a small share.
  - `transparentShare` number, nullable, required: Fraction of the backdrop that shows through, weighting each pixel by its transparency: 0 for an opaque image, roughly the background area for a cutout, 0.5 for a uniform 50% overlay. `null` when unknown.
  - `translucentShare` number, nullable, required: Fraction of pixels with partial alpha (soft shadows, glows, fades, glass), excluding fully transparent and fully opaque pixels. `null` when unknown.
  - `createdAt` string, date-time, required

## Other responses

- `400`: Validation failed. The response `message` names the first invalid field.
- `401`: Missing, invalid, expired, or revoked API key.
- `403`: The authenticated principal lacks the required capability.
- `404`: The resource does not exist or is outside the principal’s access scope.
- `429`: Rate limit exceeded. Retry after the number of seconds in the `Retry-After` header.

---

[API](https://skmtc.dev/cactal/apis/cactal-api.md) · [All operations](https://skmtc.dev/cactal/apis/cactal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cactal/apis/cactal-api/revisions/9cd0fb5eacdd?raw)