---
title: "List User Graphs and Repositories"
method: GET
path: "/v1/graphs"
tags: ["Graphs"]
---

# List User Graphs and Repositories

`GET /v1/graphs`

## Request

- Base URL: `https://api.robosystems.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.robosystems.ai/v1/graphs`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

## Response `200`

Successful Response

- UserGraphsResponse: User graphs response model.
  - `graphs` GraphInfo[], required: List of accessible graphs
    - `graphId` string, required: Graph database identifier
    - `graphName` string, required: Display name for the graph
    - `description` string: Free-form description ('' when unset)
    - `tags` string[]: Organizational tags for the graph
    - `role` string, required: User's role/access level
    - `isSelected` boolean, required: Whether this is the currently selected graph
    - `createdAt` string, required: Creation timestamp
    - `isRepository` boolean: Whether this is a shared repository (vs user graph)
    - `repositoryType` string, nullable: Repository type if isRepository=true
    - `schemaExtensions` string[]: List of schema extensions installed on this graph
    - `isSubgraph` boolean: Whether this is a subgraph (vs a main graph)
    - `parentGraphId` string, nullable: Parent graph ID if this is a subgraph
    - `graphType` string: Type of graph: generic, entity, or repository
    - `status` string: Graph lifecycle status: active, suspended, deprovisioned
  - `selectedGraphId` string, nullable: Currently selected graph ID

## Other responses

- `400`: Invalid request
- `401`: Authentication required
- `403`: Access denied
- `429`: Rate limit exceeded
- `500`: Internal server error

---

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