# Beezr API > Records and files in your workspace. Base: https://services.beezr.io/generic. Auth: X-API-Key. Nine POST operations: create, bulk create, update, bulk update, delete, bulk delete, query, get and content. ## Agent notes Append .md to a page path without its trailing slash (overview: index.md). llms-full.txt holds everything. OpenAPI: https://beezr.io/developers/api/openapi.json. Keep keys server-side. ## Start - [Overview](https://beezr.io/developers/api/): The Beezr API lets your systems create, read, search, update and delete records and their files in your Beezr workspace, with one API key. - [Quickstart: your first call](https://beezr.io/developers/api/quickstart/): Make your first Beezr API call: get an API key, find your module and field names, query records and create one. - [Authentication](https://beezr.io/developers/api/authentication/): Authenticate Beezr API calls with an X-API-Key header. A key acts for your whole workspace, so keep it on your server. - [Find your module and field names](https://beezr.io/developers/api/names/): Find the module table names and field System names the Beezr API needs, and copy them straight from the Beezr Designer. ## Concepts - [Records and field values](https://beezr.io/developers/api/records/): Send Beezr record values by field System name and read back the stored values, field type by field type. - [Filtering and sorting](https://beezr.io/developers/api/filtering/): Filter and sort Beezr API queries: combine conditions, group them with OR and start from common filters you can copy. - [Paging through results](https://beezr.io/developers/api/paging/): Read every page of a Beezr API query using the paging metadata that comes back with each response. - [Files](https://beezr.io/developers/api/files/): Upload files inside a Beezr record as base64 when you create or update it, and download them later by reference. Files can be up to 10 MB. - [Safe retries (idempotency)](https://beezr.io/developers/api/idempotency/): Send an Idempotency-Key with create and update calls, so a retry after a timeout returns the first result instead of running twice. - [Limits](https://beezr.io/developers/api/limits/): See which Beezr API limit you hit, what the response tells you and when it is safe to retry, including the monthly quota. - [Errors](https://beezr.io/developers/api/errors/): Every Beezr API error comes in one envelope. Read the code, find its cause in the table and fix the request before you retry. ## Reference - [Create a record](https://beezr.io/developers/api/reference/create-record/): Create one record in a Beezr module. Fields you don't send stay empty, and an Idempotency-Key makes retries safe. - [Create up to 100 records](https://beezr.io/developers/api/reference/bulk-create-records/): Create up to 100 Beezr records in one call. Each item succeeds or fails on its own, and failures come back with their index. - [Update a record](https://beezr.io/developers/api/reference/update-record/): Update a Beezr record: only the fields you send change, and the response is the record as it is after the update. - [Update up to 100 records](https://beezr.io/developers/api/reference/bulk-update-records/): Update up to 100 Beezr records in one call. Each item succeeds or fails on its own, and failures come back with their id. - [Delete a record](https://beezr.io/developers/api/reference/delete-record/): Delete one record from a Beezr module by its id, with the response codes to expect when the record or module isn't found. - [Delete up to 100 records](https://beezr.io/developers/api/reference/bulk-delete-records/): Delete up to 100 Beezr records in one call. Each item succeeds or fails on its own, so check the failures list. - [Query records](https://beezr.io/developers/api/reference/query-records/): Query Beezr records with filters, sorting and paging, and get back the matching records with their field values. - [Get a record](https://beezr.io/developers/api/reference/get-record/): Get one Beezr record by its id, with all its field values, or a clear error when the module or record isn't found. - [Download a file](https://beezr.io/developers/api/reference/download-file/): Download a file attached to a Beezr record by its reference. Files over 10 MB and missing files return named errors. ## Guides - [Export every record](https://beezr.io/developers/api/guides-export/): Export every record from a Beezr module: page through query results, then download each record's files separately. - [Keep another system in sync](https://beezr.io/developers/api/guides-sync/): Keep another system in sync with Beezr: match records by id, retry writes safely, send batches of up to 100 and respect rate limits. - [Attach and download a PDF](https://beezr.io/developers/api/guides-pdf/): Attach a PDF to a Beezr record by sending it as base64 inside the record, then download it later using the record's id. - [Handle rate limits well](https://beezr.io/developers/api/guides-limits/): Handle Beezr API rate limits: share one queue, wait the Retry-After seconds and stop retrying once the monthly quota is used. ## Build with AI - [Brief your AI assistant](https://beezr.io/developers/api/build-with-ai/): Turn your module's names into one brief that ChatGPT or Claude can write working code from. - [Use the docs with AI](https://beezr.io/developers/api/ai-resources/): Use the Beezr API docs with AI assistants: the llms.txt index, plain Markdown for every page and the OpenAPI file.