Graniite Docs
REST API overviewItems

Remove an item from a folder.

Removing the item's only folder is allowed — the item becomes unfiled but stays in the library. Returns 404 if the membership didn't exist (idempotent). Per-token rate limit: 60/hr.

DELETE
/items/{id}/folders/{folderId}

Removing the item's only folder is allowed — the item becomes unfiled but stays in the library. Returns 404 if the membership didn't exist (idempotent). Per-token rate limit: 60/hr.

Authorization

bearerAuth
AuthorizationBearer <token>

Per-user bearer token minted at /settings/integrations. Format: 'lev_' followed by 32 base64url chars. Each token carries a capability set (read | write) and a folder scope (whole library or a list of specific folders). Per-endpoint requirements are noted on each operation.

In: header

Path Parameters

id*string
Formatuuid
folderId*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/items/497f6eca-6276-4993-bfeb-53cbbbba6f08/folders/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "ok": true
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "rate_limited",
  "retry_after_sec": 0
}

List items the token can see. GET

Paginated list. Scoped tokens see only items in folders within their scope. Lightweight shape — no transcript or outputs (use GET /items/{id} for the full item). Per-token rate limit: 1000/hr.

Add content to the caller's knowledge base. POST

Ingest a URL or raw text snippet. Requires the 'write' capability on the bearer token. Per-token rate limit: 60/hr. Counts against monthly transcription quota for paid-transcription paths (audio URLs, YouTube videos, audio/video uploads).