---
title: "Retrieve graph"
method: GET
path: "/v1/graphs/{graph_id}"
tags: ["KG API"]
---

# Retrieve graph

`GET /v1/graphs/{graph_id}`

Retrieve a Knowledge Graph.

## Path parameters

- `graph_id` string, uuid, required

## Response `200`

- Graph
  - `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.

---

[API](https://skmtc.dev/writer/apis/writer-enterprise-api.md) · [All operations](https://skmtc.dev/writer/apis/writer-enterprise-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/writer/writer-enterprise-api/revisions/313187c251a5/schema)