# Brault API documentation > Brault (https://brault.app) is a creative file management platform for creative professionals and teams. Its public REST API (`/v1`) automates libraries, files, boards, pages, reviews, transfers and sharing in a brandspace, with scoped Bearer keys, signed webhooks and an OpenAPI document. This file indexes the documentation at https://developers.brault.app; the full text of every page is at https://developers.brault.app/llms-full.txt. Plans and pricing: https://brault.app/pricing. - [Getting Started](https://developers.brault.app/docs): The two API hosts, authentication, and your first request to the Brault public API. - [Get an API key](https://developers.brault.app/docs/get-an-api-key): Where API keys live in the Brault web app, how to create one, and how to check it works. - [Authentication and keys](https://developers.brault.app/docs/authentication-and-keys): The bsk_… key format, scopes, permission model, and auth-related error codes. - [Plans and limits](https://developers.brault.app/docs/plans-and-limits): Rate limit buckets, response headers, quotas, and the plan table. - [Conventions](https://developers.brault.app/docs/conventions): The central and regional hosts, wire format, pagination, errors, request tracing, idempotency, body limits and versioning — the rules every /v1 route follows. - Guides: End-to-end walkthroughs for common integration tasks. - [Upload and organize files](https://developers.brault.app/docs/guides/upload-and-organize): Create a library and folder, upload a file, and list what you've stored. - [Automate boards](https://developers.brault.app/docs/guides/automate-boards): Create a board, add files to it, set a status value, and query by it. - [Review workflows](https://developers.brault.app/docs/guides/review-workflows): Leave a timestamped comment on a file, resolve it, and share it for external review. - [Publish pages](https://developers.brault.app/docs/guides/publish-pages): Create a page from structured blocks, append more content, and publish it. - [Send a transfer](https://developers.brault.app/docs/guides/send-transfers): Package Brault files, or files you upload, into one expiring download link. - [Integrate webhooks](https://developers.brault.app/docs/guides/integrate-webhooks): Register an endpoint, send a test delivery, and know what to expect once it's live. - [Connect n8n](https://developers.brault.app/docs/guides/connect-n8n): Trigger n8n workflows from Brault events and call the API from an HTTP Request node. - [Connect Make](https://developers.brault.app/docs/guides/connect-make): Trigger Make scenarios from Brault events and call the API from an HTTP module. - [Connect Zapier](https://developers.brault.app/docs/guides/connect-zapier): Trigger Zaps from Brault events and call the API with Webhooks by Zapier. - [Webhooks](https://developers.brault.app/docs/webhooks): The full event catalogue, delivery headers, and how to verify a payload's signature. - API reference - [API reference](https://developers.brault.app/docs/reference): Every /v1 operation, grouped by resource. Automate libraries, files, boards, pages, reviews and sharing in your brandspace. - Meta: Who the key is, what it is allowed to do, and how much of its budget is left. - [Meta](https://developers.brault.app/docs/reference/meta): Who the key is, what it is allowed to do, and how much of its budget is left. - [Health](https://developers.brault.app/docs/reference/meta/V1PublicController_health) - [Who am I](https://developers.brault.app/docs/reference/meta/MetaController_me) - [Current usage](https://developers.brault.app/docs/reference/meta/MetaController_usage) - [The webhook event catalogue](https://developers.brault.app/docs/reference/meta/MetaController_events) - Libraries: Top-level containers. Called workspaces inside the product database. - [Libraries](https://developers.brault.app/docs/reference/libraries): Top-level containers. Called workspaces inside the product database. - [List libraries](https://developers.brault.app/docs/reference/libraries/V1LibrariesController_list) - [Create a library](https://developers.brault.app/docs/reference/libraries/V1LibrariesController_create) - [Retrieve a library](https://developers.brault.app/docs/reference/libraries/V1LibrariesController_retrieve) - [Update a library](https://developers.brault.app/docs/reference/libraries/V1LibrariesController_update) - [Delete a library](https://developers.brault.app/docs/reference/libraries/V1LibrariesController_remove) - Folders: Folders inside a library. - [Folders](https://developers.brault.app/docs/reference/folders): Folders inside a library. - [List folders](https://developers.brault.app/docs/reference/folders/V1FoldersController_list) - [Create a folder](https://developers.brault.app/docs/reference/folders/V1FoldersController_create) - [Retrieve a folder](https://developers.brault.app/docs/reference/folders/V1FoldersController_retrieve) - [Rename or recolor a folder](https://developers.brault.app/docs/reference/folders/V1FoldersController_update) - [Trash or permanently delete a folder](https://developers.brault.app/docs/reference/folders/V1FoldersController_remove) - [Move a folder](https://developers.brault.app/docs/reference/folders/V1FoldersController_move) - [Restore a trashed folder](https://developers.brault.app/docs/reference/folders/V1FoldersController_restore) - Imports: Import a file into the brandspace from a public URL. - [Imports](https://developers.brault.app/docs/reference/imports): Import a file into the brandspace from a public URL. - [Import a file from a URL](https://developers.brault.app/docs/reference/imports/V1ImportsController_start) - [Retrieve an import](https://developers.brault.app/docs/reference/imports/V1ImportsController_retrieve) - Files: The central resource: metadata, renditions, moves, copies and deletion. - [Files](https://developers.brault.app/docs/reference/files): The central resource: metadata, renditions, moves, copies and deletion. - [List files](https://developers.brault.app/docs/reference/files/V1FilesListController_list) - [Retrieve a file](https://developers.brault.app/docs/reference/files/V1FilesController_retrieve) - [Update a file](https://developers.brault.app/docs/reference/files/V1FilesController_update) - [Trash or permanently delete a file](https://developers.brault.app/docs/reference/files/V1FilesController_remove) - [Get a download URL](https://developers.brault.app/docs/reference/files/V1FilesController_download) - [Find visually similar files](https://developers.brault.app/docs/reference/files/V1FilesController_similar) - [Move a file](https://developers.brault.app/docs/reference/files/V1FilesController_move) - [Copy a file](https://developers.brault.app/docs/reference/files/V1FilesController_copy) - [Set or clear a brandspace property value on a file](https://developers.brault.app/docs/reference/files/V1FilesController_setProperty) - [List the boards a file is on](https://developers.brault.app/docs/reference/files/V1FilesController_boards) - [Restore a trashed file](https://developers.brault.app/docs/reference/files/V1FilesController_restore) - Downloads: Signed URLs for one file, and asynchronous ZIP downloads. - [Downloads](https://developers.brault.app/docs/reference/downloads): Signed URLs for one file, and asynchronous ZIP downloads. - [Start a ZIP download](https://developers.brault.app/docs/reference/downloads/V1DownloadsController_create) - [Retrieve a ZIP download](https://developers.brault.app/docs/reference/downloads/V1DownloadsController_retrieve) - Uploads: Three-call presigned upload flow. Bytes go straight to S3. - [Uploads](https://developers.brault.app/docs/reference/uploads): Three-call presigned upload flow. Bytes go straight to S3. - [Start an upload](https://developers.brault.app/docs/reference/uploads/V1UploadsController_start) - [Get presigned URLs for multipart parts](https://developers.brault.app/docs/reference/uploads/V1UploadsController_parts) - [Finish an upload](https://developers.brault.app/docs/reference/uploads/V1UploadsController_complete) - [Abort an upload](https://developers.brault.app/docs/reference/uploads/V1UploadsController_abort) - Versions: Version history of a file. - [Versions](https://developers.brault.app/docs/reference/versions): Version history of a file. - [List a file’s versions](https://developers.brault.app/docs/reference/versions/V1VersionsController_list) - [Make a version the active one](https://developers.brault.app/docs/reference/versions/V1VersionsController_activate) - [Delete a version](https://developers.brault.app/docs/reference/versions/V1VersionsController_remove) - Comments: Comments and replies on a file, with a CSV export. - [Comments](https://developers.brault.app/docs/reference/comments): Comments and replies on a file, with a CSV export. - [List a file’s comments](https://developers.brault.app/docs/reference/comments/V1CommentsController_list) - [Comment on a file](https://developers.brault.app/docs/reference/comments/V1CommentsController_create) - [Retrieve a comment](https://developers.brault.app/docs/reference/comments/V1CommentsController_retrieve) - [Edit a comment’s text](https://developers.brault.app/docs/reference/comments/V1CommentsController_update) - [Delete a comment](https://developers.brault.app/docs/reference/comments/V1CommentsController_remove) - [Resolve a comment](https://developers.brault.app/docs/reference/comments/V1CommentsController_resolve) - [Reopen a comment](https://developers.brault.app/docs/reference/comments/V1CommentsController_reopen) - [List a comment’s replies](https://developers.brault.app/docs/reference/comments/V1RepliesController_list) - [Reply to a comment](https://developers.brault.app/docs/reference/comments/V1RepliesController_create) - [Edit a reply’s text](https://developers.brault.app/docs/reference/comments/V1RepliesController_update) - [Delete a reply](https://developers.brault.app/docs/reference/comments/V1RepliesController_remove) - Pages: Pages: structured documents, published or private. - [Pages](https://developers.brault.app/docs/reference/pages): Pages: structured documents, published or private. - [List pages](https://developers.brault.app/docs/reference/pages/V1PagesController_list) - [Create a page](https://developers.brault.app/docs/reference/pages/V1PagesController_create) - [Retrieve a page](https://developers.brault.app/docs/reference/pages/V1PagesController_retrieve) - [Trash or permanently delete a page](https://developers.brault.app/docs/reference/pages/V1PagesController_remove) - [Publish a page](https://developers.brault.app/docs/reference/pages/V1PagesController_publish) - [Unpublish a page](https://developers.brault.app/docs/reference/pages/V1PagesController_unpublish) - [Append blocks to a page](https://developers.brault.app/docs/reference/pages/V1PagesController_appendBlocks) - Shared links: Public links to a file, folder, library or board. - [Shared links](https://developers.brault.app/docs/reference/shared-links): Public links to a file, folder, library or board. - [List shared links](https://developers.brault.app/docs/reference/shared-links/V1SharedLinksController_list) - [Create a shared link](https://developers.brault.app/docs/reference/shared-links/V1SharedLinksController_create) - [Retrieve a shared link](https://developers.brault.app/docs/reference/shared-links/V1SharedLinksController_retrieve) - [Update a shared link](https://developers.brault.app/docs/reference/shared-links/V1SharedLinksController_update) - [Delete a shared link](https://developers.brault.app/docs/reference/shared-links/V1SharedLinksController_remove) - Transfers: Send files and folders as a BTransfer, and manage the ones already sent. - [Transfers](https://developers.brault.app/docs/reference/transfers): Send files and folders as a BTransfer, and manage the ones already sent. - [List transfers](https://developers.brault.app/docs/reference/transfers/V1TransfersController_list) - [Create a transfer](https://developers.brault.app/docs/reference/transfers/V1TransfersController_create) - [Get presigned URLs for multipart parts](https://developers.brault.app/docs/reference/transfers/V1TransfersController_parts) - [Finish one declared upload](https://developers.brault.app/docs/reference/transfers/V1TransfersController_completeUpload) - [Finalize a transfer](https://developers.brault.app/docs/reference/transfers/V1TransfersController_complete) - [Retrieve a transfer](https://developers.brault.app/docs/reference/transfers/V1TransfersController_retrieve) - [Update a transfer](https://developers.brault.app/docs/reference/transfers/V1TransfersController_update) - [Expire a transfer](https://developers.brault.app/docs/reference/transfers/V1TransfersController_remove) - Boards: Boards, the files on them, their properties and options. - [Boards](https://developers.brault.app/docs/reference/boards): Boards, the files on them, their properties and options. - [List boards](https://developers.brault.app/docs/reference/boards/V1BoardsController_list) - [Create a board](https://developers.brault.app/docs/reference/boards/V1BoardsController_create) - [Retrieve a board](https://developers.brault.app/docs/reference/boards/V1BoardsController_retrieve) - [Update a board](https://developers.brault.app/docs/reference/boards/V1BoardsController_update) - [Delete a board](https://developers.brault.app/docs/reference/boards/V1BoardsController_remove) - [List board members](https://developers.brault.app/docs/reference/boards/V1BoardsController_members) - [List board properties](https://developers.brault.app/docs/reference/boards/V1BoardPropertiesController_list) - [Create a board property](https://developers.brault.app/docs/reference/boards/V1BoardPropertiesController_create) - [Retrieve a board property](https://developers.brault.app/docs/reference/boards/V1BoardPropertiesController_retrieve) - [Rename a board property](https://developers.brault.app/docs/reference/boards/V1BoardPropertiesController_update) - [Delete a board property](https://developers.brault.app/docs/reference/boards/V1BoardPropertiesController_remove) - [Create an option](https://developers.brault.app/docs/reference/boards/V1BoardPropertiesController_createOption) - [Update an option](https://developers.brault.app/docs/reference/boards/V1BoardPropertiesController_updateOption) - [Delete an option](https://developers.brault.app/docs/reference/boards/V1BoardPropertiesController_removeOption) - [Query the files on a board](https://developers.brault.app/docs/reference/boards/V1BoardFilesController_query) - [Add files to a board](https://developers.brault.app/docs/reference/boards/V1BoardFilesController_addFiles) - [Remove a file from a board](https://developers.brault.app/docs/reference/boards/V1BoardFilesController_removeFile) - [Set or clear a board property value](https://developers.brault.app/docs/reference/boards/V1BoardFilesController_setValue) - Properties: Brandspace properties and options — the schema of the metadata layer. - [Properties](https://developers.brault.app/docs/reference/properties): Brandspace properties and options — the schema of the metadata layer. - [List brandspace properties](https://developers.brault.app/docs/reference/properties/V1PropertiesController_list) - [Create a brandspace property](https://developers.brault.app/docs/reference/properties/V1PropertiesController_create) - [Retrieve a brandspace property](https://developers.brault.app/docs/reference/properties/V1PropertiesController_retrieve) - [Update a brandspace property](https://developers.brault.app/docs/reference/properties/V1PropertiesController_update) - [Delete a brandspace property](https://developers.brault.app/docs/reference/properties/V1PropertiesController_remove) - [Create an option](https://developers.brault.app/docs/reference/properties/V1PropertiesController_createOption) - [Update an option](https://developers.brault.app/docs/reference/properties/V1PropertiesController_updateOption) - [Delete an option](https://developers.brault.app/docs/reference/properties/V1PropertiesController_removeOption) - Search: Keyword, semantic and natural-language search. - [Search](https://developers.brault.app/docs/reference/search): Keyword, semantic and natural-language search. - [Search files and folders](https://developers.brault.app/docs/reference/search/V1SearchController_search) - Brandspace: The brandspace behind the key, its members and its roles. - [Brandspace](https://developers.brault.app/docs/reference/brandspace): The brandspace behind the key, its members and its roles. - [List members](https://developers.brault.app/docs/reference/brandspace/V1MembersController_list) - [Retrieve a member](https://developers.brault.app/docs/reference/brandspace/V1MembersController_retrieve) - [List roles](https://developers.brault.app/docs/reference/brandspace/V1MembersController_listRoles) - [Retrieve the brandspace this key belongs to](https://developers.brault.app/docs/reference/brandspace/V1BrandspaceController_retrieve) - Webhooks: Webhook endpoints and their deliveries. - [Webhooks](https://developers.brault.app/docs/reference/webhooks): Webhook endpoints and their deliveries. - [List webhook endpoints](https://developers.brault.app/docs/reference/webhooks/V1WebhooksController_list) - [Create a webhook endpoint](https://developers.brault.app/docs/reference/webhooks/V1WebhooksController_create) - [Retrieve a webhook endpoint](https://developers.brault.app/docs/reference/webhooks/V1WebhooksController_retrieve) - [Update a webhook endpoint](https://developers.brault.app/docs/reference/webhooks/V1WebhooksController_update) - [Delete a webhook endpoint](https://developers.brault.app/docs/reference/webhooks/V1WebhooksController_remove) - [Send a test delivery](https://developers.brault.app/docs/reference/webhooks/V1WebhooksController_test) - [Roll the signing secret](https://developers.brault.app/docs/reference/webhooks/V1WebhooksController_rollSecret) - [List an endpoint’s deliveries](https://developers.brault.app/docs/reference/webhooks/V1WebhooksController_deliveries) - [Retrieve one delivery](https://developers.brault.app/docs/reference/webhooks/V1WebhooksController_delivery) - [Redeliver one delivery](https://developers.brault.app/docs/reference/webhooks/V1WebhooksController_redeliver) - [Replay a window of events](https://developers.brault.app/docs/reference/webhooks/V1WebhooksController_replay) - [Changelog](https://developers.brault.app/docs/changelog): What shipped in each version of the Brault public API.