---
updatedAt: 2025-05-12T08:38:10.000Z
---

Fetch the complete documentation index at: https://apidocs.hibob.com/llms.txt. Use this file to discover all available pages before exploring further.

# Documents

The Docs API provides access to the details of your company documents and folders.

# Getting started

Before you start, explore the [Docs API](/docs/explore-docs-api") to learn how to upload and access Bob's documents via the Public API.

# File Size Limits

* **General uploads**: Files can be uploaded up to a maximum size of 5MB.
* **Uploads to custom folders**: When uploading to a custom folder, the size limit is 1MB. This limitation is relevant to the following endpoints:
  * [Upload File from a URL to a Custom Folder](https://apidocs.hibob.com/reference/post_docs-people-id-custom-folderid)
  * [Upload File to a Custom Folder](https://apidocs.hibob.com/reference/post_docs-people-id-folders-folderid-upload)

# Permissions required

Each docs folder (e.g., Shared, Confidential, or a custom folder) has its permissions managed separately in a permission section with the folder name.

To access documents via the API, you should grant the service user permissions based on the folders you want to access and the actions you want to perform.

| Action             | Permission                                                                                 |
| :----------------- | :----------------------------------------------------------------------------------------- |
| Download documents | People's Data > Docs > **\[docs folder]** > View selected employees' docs in the folder.   |
| Upload documents   | People's Data > Docs > **\[docs folder]** > Upload selected employees’ docs in the folder. |
| Delete documents   | People's Data > Docs > **\[docs folder]** > Delete selected employees’ docs in the folder  |

For example, for a custom folder called "Recruitment CVs", you need to set the permission:

People's Data > Docs > Recruitment CVs > View selected employees' docs in the folder.

To learn more, see [Permissions](/reference/permissions).

# Rate limiting

At the moment, document endpoints don't have rate limits.