---
title: "Browse maintained project knowledge"
method: GET
path: "/api/v1/organizations/{organization_id}/verify/knowledge"
tags: ["organizations"]
---

# Browse maintained project knowledge

`GET /api/v1/organizations/{organization_id}/verify/knowledge`

## Request

- Base URL: `https://composal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://composal.com/api/v1/organizations/{organization_id}/verify/knowledge`
- Auth: HTTP bearer

## Path parameters

- `organization_id` string, required

## Query parameters

- `q` string
- `project_id` string

## Response `200`

Project selection and most recent 50 matching knowledge documents

- VerifyKnowledgePage
  - `organization` object, required
    - `slug` string, required
    - `name` string, required
  - `permissions` object, required
    - `manage` boolean, required
  - `selected_project_id` string, nullable, required
  - `total` integer, required
  - `projects` object[], required
    - `id` string, required
    - `name` string, required
    - `purpose` string, nullable, required
  - `documents` VerifyKnowledgeSummary[], required
    - `id` string, required
    - `title` string, required
    - `kind` 'discovery' | 'operator' | 'learning', required
    - `observed_at` string, date-time, required
    - `project_id` string, required
    - `project_name` string, required
    - `source` object, required
      - `edited_at` string, nullable, required
  - `dreaming` object, required
    - `schedule` VerifyDreamSchedule, required
      - `timezone` string, required: Organization IANA timezone dreams are scheduled in
      - `start_hour` integer, required: Local 24-hour clock hour a dream starts
      - `next_at` string, date-time, required: Next scheduled start
    - `latest` VerifyDreamSummary, required
      - `id` string, required: Public id used in the dream's URL
      - `reviewed_date` string, date, required: Local day whose finished runs it reviewed
      - `timezone` string, required: Organization timezone the dream used
      - `scope_name` string, required: Project or unassigned environment name
      - `phase` 'queued' | 'running' | 'stalled' | 'paused' | 'stopped' | 'completed' | 'stopped_early', required: Where the dream is. queued: waiting for a worker. running: a worker holds it. stalled: marked running but no worker holds it. paused: it hit an error and the periodic sweep still resumes it. stopped: it hit an error and is no longer retried automatically; only an administrator can resume it. completed: finished normally. stopped_early: finished, but ended before reviewing everything because its project or environment became unavailable.
      - `attention` boolean, required: The dream skipped at least one run, which will not be retried
      - `reviewed` integer, required: Finished runs and blocked executions reviewed, not counting skipped ones
      - `skipped` integer, required: Runs skipped after repeated rejected review output
      - `changes` integer, required: Knowledge and memory entries created, updated or archived
      - `completed_at` string, date-time, nullable, required
      - `error_code` string, nullable, required: Diagnostic code from the last failure, or from a dream that stopped early; not display copy, show reason instead
      - `reason` string, nullable, required: Plain-language explanation of the phase: the cause and what happens next. Null for queued, running and completed dreams.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `422`: Unprocessable entity
- `502`: Bad gateway

---

[API](https://skmtc.dev/composal/apis/vex-api.md) - [All operations](https://skmtc.dev/composal/apis/vex-api/llms.txt) - [OpenAPI document](https://skmtc.dev/composal/apis/vex-api/revisions/74298a24e040?raw)