---
title: "Fetch a document or graph node by id or partial name"
method: GET
path: "/api/v1/items/{id}"
tags: ["Workspace"]
---

# Fetch a document or graph node by id or partial name

`GET /api/v1/items/{id}`

## Request

- Base URL: `https://www.specky.space`
- URL: `https://www.specky.space/api/v1/items/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Query parameters

- `kind` 'document' | 'graph_node' | 'auto'

## Response `200`

Successful response. Always includes `summary` (string) and `ok: true`; mutating endpoints additionally include the created resource id under a tool-specific key.

- OkSummary
  - `ok` true
  - `summary` string: Human-readable result text.

## Other responses

- `401`: Missing or invalid bearer token

---

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