Skip to main content
GET
/
api
/
v1
/
knowledge
List Knowledge Items
curl --request GET \
  --url https://www.stardeck.ai/api/v1/knowledge
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "organizationId": "org_2abc123",
        "path": "docs/api/overview.md",
        "content": "# API Overview\n\nWelcome to the API.",
        "itemType": "text",
        "fileKey": null,
        "fileName": null,
        "contentType": null,
        "fileSize": null,
        "requiredReadPermission": "inherit",
        "requiredWritePermission": "inherit",
        "createdAt": "2026-01-15T10:30:00.000Z",
        "updatedAt": "2026-01-15T10:30:00.000Z"
      }
    ]
  }
}
Returns all knowledge items accessible to the API key’s assigned role. Items are filtered by the key’s permissions — items requiring higher access levels than the key’s role are excluded. 
{
  "success": true,
  "data": {
    "items": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "organizationId": "org_2abc123",
        "path": "docs/api/overview.md",
        "content": "# API Overview\n\nWelcome to the API.",
        "itemType": "text",
        "fileKey": null,
        "fileName": null,
        "contentType": null,
        "fileSize": null,
        "requiredReadPermission": "inherit",
        "requiredWritePermission": "inherit",
        "createdAt": "2026-01-15T10:30:00.000Z",
        "updatedAt": "2026-01-15T10:30:00.000Z"
      }
    ]
  }
}
​
success
boolean
required
Always true for successful responses.
​
data
object
required