Graniite Docs
REST API overviewItems

Get full item.

Returns metadata, transcript + segments, outputs (transforms), and folder memberships (filtered to in-scope folders only). Scoped tokens 404 on items outside scope; kbOnly tokens 404 on in_kb=false items. Per-token rate limit: 1000/hr.

GET
/items/{id}

Returns metadata, transcript + segments, outputs (transforms), and folder memberships (filtered to in-scope folders only). Scoped tokens 404 on items outside scope; kbOnly tokens 404 on in_kb=false items. Per-token rate limit: 1000/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

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/items/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "user_item_id": "bdbfc5c1-4635-4d6b-a226-2cb5d7e08712",
  "content_id": "713e4c61-5a69-43fb-a600-2e2699462e14",
  "title": "string",
  "custom_title": "string",
  "source_title": "string",
  "url": "string",
  "platform": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "archived": true,
  "read": true,
  "in_kb": true,
  "auto_transform": true,
  "transcript": "string",
  "transcript_segments": [
    null
  ],
  "transcription_status": "string",
  "transcription_error": "string",
  "transform_error": "string",
  "transform_failed_at": "2019-08-24T14:15:22Z",
  "media_kind": "audio",
  "mime_type": "string",
  "duration_seconds": 0,
  "thumbnail_url": "string",
  "published_at": "2019-08-24T14:15:22Z",
  "outputs": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "format": "auto",
      "title": "string",
      "tldr": "string",
      "content_md": "string",
      "custom_prompt": "string",
      "model": "string",
      "created_at": "2019-08-24T14:15:22Z"
    }
  ],
  "folders": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string"
    }
  ]
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "rate_limited",
  "retry_after_sec": 0
}

Delete an item. DELETE

Write capability. Scoped tokens require ≥1 in-scope folder membership; out-of-scope returns 404. Cascade is automatic: outputs / chunks / folder_items via FK CASCADE; manual-upload storage objects queued by the delete_orphan_manual_content trigger for the 30-min cron drainer. Per-token rate limit: 30/hr.

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.