# Bottari Developers > Read and write Bottari databases from your own server with an API token, and get notified of changes with webhooks. ## Guides ### Get started - [Bottari API](https://developers.bottari.ai/index.md): Read and write Bottari databases from your own server with an API token. - [Quickstart](https://developers.bottari.ai/quickstart.md): Create an integration, connect a database, and send your first request. ### Import data - [Import external data](https://developers.bottari.ai/import/external-data.md): Bring files and databases from other places into Bottari in the desktop app. ### Authentication and access - [Tokens](https://developers.bottari.ai/auth/tokens.md): The integration token format, where to manage it, and how to replace it. - [Capabilities](https://developers.bottari.ai/auth/capabilities.md): The five capabilities that control what an integration can do, and their defaults. - [Connections](https://developers.bottari.ai/auth/connections.md): Which databases and rows an integration can read and write. ### Limits - [Values and request size](https://developers.bottari.ai/limits/values.md): Limits on a single request and on values, and how to read and write long text. - [Rate limits](https://developers.bottari.ai/limits/rate-limits.md): API rate limits and how to handle a 429 response. ### Webhooks - [Subscribe to webhooks](https://developers.bottari.ai/webhooks/subscribe.md): Create a webhook subscription for an integration and verify the receiving address. - [Verify signatures](https://developers.bottari.ai/webhooks/signature.md): Use the x-notion-signature header to confirm a webhook request came from Bottari. - [Events](https://developers.bottari.ai/webhooks/events.md): Webhook body fields, the 17 events, and the data format of each. - [Batching](https://developers.bottari.ai/webhooks/batching.md): How changes merge into one event, and when each event is sent. - [Retries and automatic pause](https://developers.bottari.ai/webhooks/retries.md): Retries after a failed delivery, handling duplicates, and what happens when failures continue. ## API reference ### Common - [Common rules](https://developers.bottari.ai/api-reference/overview.md): The address, headers, responses, errors, and pagination that apply to every endpoint. - [Property values](https://developers.bottari.ai/api-reference/property-values.md): What each property type returns when read and what to send when writing. - [Filters and sorts](https://developers.bottari.ai/api-reference/filters.md): Conditions you can use in filter and sorts for POST /v1/data_sources/{id}/query. ### Users - [Retrieve your integration](https://developers.bottari.ai/api-reference/users/me.md): Read the bot of the integration that owns the token. Answers regardless of capabilities. - [List users](https://developers.bottari.ai/api-reference/users/list.md): Read team members and live integration bots. - [Retrieve a user](https://developers.bottari.ai/api-reference/users/retrieve.md): Read one member, guest, or integration bot. ### Search - [Search](https://developers.bottari.ai/api-reference/search.md): Find rows, subpages, and databases the integration can see, by title. ### Databases and data sources - [Retrieve a database](https://developers.bottari.ai/api-reference/databases/retrieve.md): Read a database object. Property definitions are on the data source. - [Retrieve a data source](https://developers.bottari.ai/api-reference/data-sources/retrieve.md): Read a database's property definitions. - [Query rows](https://developers.bottari.ai/api-reference/data-sources/query.md): Read a database's rows with filters and sorts. ### Pages - [Create a row](https://developers.bottari.ai/api-reference/pages/create.md): Create a row in a connected database. Requires Insert content. - [Retrieve a page](https://developers.bottari.ai/api-reference/pages/retrieve.md): Read the properties of one row or subpage. - [Update a row](https://developers.bottari.ai/api-reference/pages/update.md): Update a row's properties, trash state, archive state, lock, icon, and cover. Requires Update content. - [Retrieve a property value](https://developers.bottari.ai/api-reference/pages/property.md): Read all of one property's value. Use it for relations and original rollup values over 25 items. - [Retrieve content as Markdown](https://developers.bottari.ai/api-reference/pages/markdown.md): Read a document's or block's content as Markdown. ### Blocks - [Retrieve a block](https://developers.bottari.ai/api-reference/blocks/retrieve.md): Read one block. Document, subpage, and inline database IDs can also be read as blocks. - [List block children](https://developers.bottari.ai/api-reference/blocks/children.md): Read a block's children. With a document ID, returns the top-level blocks of its content. ### Comments - [List comments](https://developers.bottari.ai/api-reference/comments/list.md): Read comments on a page or block, oldest first. Requires Read comments. - [Retrieve a comment](https://developers.bottari.ai/api-reference/comments/retrieve.md): Read one comment or reply, including deleted ones. ## Changelog ### Changelog - [Changelog](https://developers.bottari.ai/changelog.md): Changes to the Bottari API. > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [Korean (33 pages)](https://developers.bottari.ai/_llms/ko.txt): Documentation for Korean. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.