{"openapi":"3.1.0","info":{"title":"Slite (BYOK) API","version":"0.1.0","description":"Slite (BYOK) lets an AI assistant read your own Slite data through the Slite API with a key you supply (personal API key). Read-only: 7 tools (get_me, list_notes, get_note, list_note_children, search_notes, search_users, search_groups). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.slite.com. Unofficial...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-slite.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-slite/docs"},"termsOfService":"https://connectorbay.com/byok-slite/terms"},"servers":[{"url":"https://byok-slite.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-slite/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_me":{"post":{"operationId":"get_me","summary":"Show the Slite user the key belongs to: display name, email and organization name and domain. Use for \"Which Slite accou","description":"Show the Slite user the key belongs to: display name, email and organization name and domain. Use for \"Which Slite account is my API key for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_meArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_notes":{"post":{"operationId":"list_notes","summary":"List notes with title, parent, review state, owner and dates; filter by owner or parent note and order by edit time or p","description":"List notes with title, parent, review state, owner and dates; filter by owner or parent note and order by edit time or position. Use for \"What are the most recently edited notes in Slite\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"owner_id":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only notes owned by this user id.","title":"Owner Id"},"parent_note_id":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only notes under this parent note id.","title":"Parent Note Id"},"order_by":{"anyOf":[{"enum":["lastEditedAt_DESC","lastEditedAt_ASC","listPosition_DESC","listPosition_ASC"],"type":"string"},{"type":"null"}],"default":"lastEditedAt_DESC","description":"Order of notes.","title":"Order By"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's nextCursor, to fetch the next page; leave out for the first page.","title":"Cursor"}},"title":"list_notesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_note":{"post":{"operationId":"get_note","summary":"Get one note with its title, review state, dates and the full content as markdown, HTML or SliteML. Use for \"Show me the","description":"Get one note with its title, review state, dates and the full content as markdown, HTML or SliteML. Use for \"Show me the content of Slite note kxm1sH0YBvGFya\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"note_id":{"description":"Note id from list_notes or search_notes (also the last part of a note's URL).","maxLength":200,"title":"Note Id","type":"string"},"format":{"anyOf":[{"enum":["md","html","sliteml"],"type":"string"},{"type":"null"}],"default":"md","description":"Content format: md (markdown, default), html or sliteml.","title":"Format"}},"required":["note_id"],"title":"get_noteArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_note_children":{"post":{"operationId":"list_note_children","summary":"List the notes directly under a parent note, or the whole subtree when include_descendants is true. Use for \"What notes ","description":"List the notes directly under a parent note, or the whole subtree when include_descendants is true. Use for \"What notes sit under Slite note kxm1sH0YBvGFya\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"note_id":{"description":"Note id from list_notes or search_notes (also the last part of a note's URL).","maxLength":200,"title":"Note Id","type":"string"},"order_by":{"anyOf":[{"enum":["title","listPosition","lastEditedAt"],"type":"string"},{"type":"null"}],"default":"title","description":"Order by title (default), listPosition or lastEditedAt.","title":"Order By"},"order_direction":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"asc","description":"asc (default) or desc.","title":"Order Direction"},"include_descendants":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to return the whole subtree flattened instead of only direct children.","title":"Include Descendants"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's nextCursor, to fetch the next page; leave out for the first page.","title":"Cursor"}},"required":["note_id"],"title":"list_note_childrenArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_notes":{"post":{"operationId":"search_notes","summary":"Search notes by text with optional filters for parent note, review state and edit date; returns title, a highlighted sni","description":"Search notes by text with optional filters for parent note, review state and edit date; returns title, a highlighted snippet, parents and dates. Use for \"Find Slite notes about onboarding\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Search text.","maxLength":200,"title":"Query","type":"string"},"parent_note_id":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Only notes under this parent note id.","title":"Parent Note Id"},"review_state":{"anyOf":[{"enum":["Verified","Outdated","VerificationRequested","VerificationExpired"],"type":"string"},{"type":"null"}],"default":null,"description":"Only notes in this review state.","title":"Review State"},"last_edited_after":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only notes edited after this ISO 8601 time.","title":"Last Edited After"},"include_archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to include archived notes.","title":"Include Archived"},"hits_per_page":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many notes per page (default 10).","title":"Hits Per Page"},"page":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Page of results to fetch for paging; leave out for the first page. The answer gives page and nbPages.","title":"Page"}},"required":["query"],"title":"search_notesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_users":{"post":{"operationId":"search_users","summary":"Search users by name or email and return id, display name, role and guest flag. Use for \"Who in Slite is called Ada\".","description":"Search users by name or email and return id, display name, role and guest flag. Use for \"Who in Slite is called Ada\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Text matched against name and email.","maxLength":100,"title":"Query","type":"string"},"include_archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to include archived users.","title":"Include Archived"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's nextCursor, to fetch the next page; leave out for the first page.","title":"Cursor"}},"required":["query"],"title":"search_usersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_groups":{"post":{"operationId":"search_groups","summary":"Search groups by name and return id, name and description. Use for \"Which Slite groups exist for engineering\".","description":"Search groups by name and return id, name and description. Use for \"Which Slite groups exist for engineering\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Text matched against group names.","maxLength":100,"title":"Query","type":"string"},"cursor":{"anyOf":[{"maxLength":300,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor from the previous answer's nextCursor, to fetch the next page; leave out for the first page.","title":"Cursor"}},"required":["query"],"title":"search_groupsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}