---
title: "List graphs"
method: GET
path: "/v1/graphs"
tags: ["KG API"]
---

# List graphs

`GET /v1/graphs`

## Request

- Base URL: `https://api.writer.com`
- URL: `https://api.writer.com/v1/graphs`
- Auth: HTTP bearer

Retrieve a list of Knowledge Graphs.

By default, the response contains only org-wide Knowledge Graphs. To include Knowledge Graphs that are deployed to specific teams, pass one or more team IDs in the `team_ids` query parameter. Requests authenticated with a team-scoped API key always return only that key's team; passing a different value in `team_ids` is rejected.

## Query parameters

- `order` 'asc' | 'desc'
- `before` string, uuid
- `after` string, uuid
- `limit` integer
- `team_ids` integer[]

## Response `200`

- GraphsResponse
  - `data` Graph[], required
    - `id` string, uuid, required: The unique identifier of the Knowledge Graph.
    - `created_at` string, date-time, required: The timestamp when the Knowledge Graph was created.
    - `name` string, required: The name of the Knowledge Graph.
    - `description` string: A description of the Knowledge Graph.
    - `file_status` GraphFileStatus, required
      - `in_progress` integer, required: The number of files currently being processed.
      - `completed` integer, required: The number of files that have been successfully processed.
      - `failed` integer, required: The number of files that failed to process.
      - `total` integer, required: The total number of files associated with the Knowledge Graph.
    - `type` 'manual' | 'connector' | 'web', required: The type of Knowledge Graph: - `manual`: files are uploaded via UI or API - `connector`: files are uploaded via a data connector such as Google Drive or Confluence - `web`: URLs are connected to the Knowledge Graph
    - `urls` WebConnectorUrl[]: An array of web connector URLs associated with this Knowledge Graph.
      - `url` string, required: The URL to be processed by the web connector.
      - `status` WebConnectorUrlState, required: The state of a web connector URL processing.
        - `status` 'validating' | 'success' | 'error', required: The status of web connector URL processing.
        - `error_type` 'invalid_url' | 'not_searchable' | 'not_found' | 'paywall_or_login_page' | 'unexpected_error': The type of error that can occur during web connector URL processing.
      - `exclude_urls` string[]: An array of URLs to exclude from processing within this web connector.
      - `type` 'single_page' | 'sub_pages', required: The type of web connector processing for a URL.
    - `team_ids` integer[]: The team IDs the Knowledge Graph is deployed to. An empty array indicates an org-wide Knowledge Graph accessible to every team in the organization.
  - `first_id` string, uuid: The ID of the first Knowledge Graph in the current response.
  - `last_id` string, uuid: The ID of the last Knowledge Graph in the current response.
  - `has_more` boolean, required: Indicates if there are more Knowledge Graphs available beyond the current page.

## Changes

- **2026-08-28** `55e7d6385506`: 2 info
  - added the new optional `query` request parameter `team_ids`
  - added the optional property `data/items/team_ids` to the response with the `200` status
- **2025-08-12** `0bbaae2a6920`: 1 warning, 1 info
  - added the new `web` enum value to the `data/items/type` response property for the response status `200`
  - added the optional property `data/items/urls` to the response with the `200` status
- **2025-02-25** `3d3b2fe43375`: 1 info
  - added the required property `data/items/type` to the response with the `200` status

[Operation history](https://skmtc.dev/writer/apis/writer-api/changes/v1/graphs/get.md)

---

[API](https://skmtc.dev/writer/apis/writer-api.md) - [All operations](https://skmtc.dev/writer/apis/writer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/writer/apis/writer-api/revisions/59865afc5779?raw)