--- updatedAt: 2026-09-07T11:12:49.000Z agentTools: projectIndex: https://developers.slite.com/llms.txt --- # List notes for knowledge management List notes for knowledge management. # OpenAPI definition ```json { "openapi": "3.0.0", "components": { "schemas": { "PublicApiAuthError": { "properties": { "message": { "type": "string", "enum": [ "Invalid apiKey" ], "nullable": false }, "id": { "type": "string", "enum": [ "auth/unauthorized" ], "nullable": false } }, "required": [ "message", "id" ], "type": "object" }, "PublicApiError": { "properties": { "message": { "type": "string" }, "id": { "type": "string" } }, "required": [ "message", "id" ], "type": "object" }, "FieldErrors": { "properties": {}, "type": "object", "additionalProperties": { "properties": { "value": {}, "message": { "type": "string" } }, "required": [ "message" ], "type": "object" } }, "PublicApiFieldValidationError": { "properties": { "details": { "$ref": "#/components/schemas/FieldErrors" }, "message": { "type": "string", "enum": [ "Validation Failed" ], "nullable": false }, "id": { "type": "string", "enum": [ "field-validation" ], "nullable": false } }, "required": [ "message", "id" ], "type": "object" }, "PublicApiRateLimitError": { "properties": { "message": { "type": "string", "enum": [ "You've reached the api rate limit. Please wait and retry later." ], "nullable": false }, "id": { "type": "string", "enum": [ "rate-limit" ], "nullable": false } }, "required": [ "message", "id" ], "type": "object" }, "PublicApiReviewState": { "enum": [ "Verified", "Outdated", "VerificationRequested", "VerificationExpired" ], "type": "string" }, "NoteOwner": { "properties": { "groupId": { "type": "string", "description": "Group id of the owner (if owner is a group)" }, "userId": { "type": "string", "description": "User id of the owner (if owner is a user)" } }, "type": "object", "description": "Owner of the note for review purposes.\nEither userId or groupId will be set, but not both." }, "Note": { "properties": { "owner": { "$ref": "#/components/schemas/NoteOwner", "description": "Owner of the note for review purposes.\nEither userId or groupId will be set, but not both.\nIf no owner is set, this field will be omitted." }, "reviewState": { "$ref": "#/components/schemas/PublicApiReviewState", "description": "Review state of the note\nCan be Verified, Outdated, VerificationRequested or VerificationExpired" }, "archivedAt": { "type": "string", "format": "date-time", "nullable": true, "description": "Date of the archiving of the note (null if not archived)" }, "lastEditedAt": { "type": "string", "format": "date-time", "description": "Date of the last edition of the note" }, "updatedAt": { "type": "string", "format": "date-time", "description": "Date of the last update of the note" }, "createdAt": { "type": "string", "format": "date-time", "description": "Date of the creation of the note" }, "columns": { "items": { "type": "string" }, "type": "array", "description": "If note is in a collection, it will contain its column names" }, "attributes": { "items": { "type": "string" }, "type": "array", "description": "If note is in a collection, it will contain its attributes ordered\nby column" }, "url": { "type": "string", "description": "Url to the note" }, "listPosition": { "type": "number", "format": "double", "nullable": true, "description": "Position of the note among its siblings, matching the order shown in the\nSlite sidebar. Higher values come first (top of the sidebar). By default\nit is seeded from the creation date, so freshly created docs appear at the\ntop; manual reordering overrides it. Combine with\n`orderBy=listPosition_DESC` on the children endpoint to reproduce the\nsidebar order. Writable via the `listPosition` body parameter of the\ncreate and update endpoints." }, "parentNoteId": { "type": "string", "nullable": true, "description": "Parent note id of the current note.\nIt can be null if it's a root note." }, "iconColor": { "type": "string", "nullable": true, "description": "Optional icon color for the note." }, "iconShape": { "type": "string", "nullable": true, "description": "Optional icon identifier for the note." }, "title": { "type": "string", "description": "Title of the note" }, "id": { "type": "string", "description": "Id of the note" } }, "required": [ "archivedAt", "lastEditedAt", "updatedAt", "createdAt", "url", "parentNoteId", "title", "id" ], "type": "object" }, "PaginatedNotes": { "properties": { "notes": { "items": { "$ref": "#/components/schemas/Note" }, "type": "array" }, "total": { "type": "number", "format": "double", "description": "Total number of children" }, "hasNextPage": { "type": "boolean", "description": "Is there any other page to fetch" }, "nextCursor": { "type": "string", "nullable": true, "description": "Next cursor to continue fetching the paginate children" } }, "required": [ "notes", "total", "hasNextPage", "nextCursor" ], "type": "object" }, "KnowledgeManagementFirst": { "type": "integer", "format": "int32", "minimum": 1, "maximum": 50 } }, "securitySchemes": { "bearer": { "type": "http", "scheme": "bearer", "description": "API keys can be generated under Settings > API" } } }, "info": { "title": "Public Slite api", "version": "1", "description": "Access your Slite documents, search, create, update...", "license": { "name": "private" }, "contact": { "name": "Slite" } }, "paths": { "/knowledge-management/notes": { "get": { "operationId": "listNotesForKnowledgeManagement", "responses": { "200": { "description": "Ok", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedNotes" } } } }, "401": { "description": "Invalid authentication", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiAuthError" } } } }, "422": { "description": "Input validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiFieldValidationError" } } } }, "429": { "description": "Rate limitation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiRateLimitError" } } } }, "default": { "description": "Unexpected error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicApiError" } } } } }, "description": "List notes for knowledge management.", "summary": "List notes for knowledge management", "security": [ { "bearer": [ "read" ] } ], "parameters": [ { "description": "Optional filter to only return notes in special review states.", "in": "query", "name": "reviewStateList", "required": false, "schema": { "type": "array", "items": { "$ref": "#/components/schemas/PublicApiReviewState" } } }, { "description": "Optional: user or group ids to filter notes by owner", "in": "query", "name": "ownerIdList", "required": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "description": "Optional: channel ids to filter notes by channel", "in": "query", "name": "channelIdList", "required": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "description": "Optional: number of trailing days to consider", "in": "query", "name": "sinceDaysAgo", "required": false, "schema": { "format": "double", "type": "number" } }, { "description": "Maximum number of notes to return. Defaults to 20.", "in": "query", "name": "first", "required": false, "schema": { "$ref": "#/components/schemas/KnowledgeManagementFirst" } }, { "description": "Cursor to use to continue fetching notes", "in": "query", "name": "cursor", "required": false, "schema": { "type": "string" } } ] } } }, "servers": [ { "url": "https://api.slite.com/v1" } ] } ```