API

If you have been to developer.box.com in the last few minutes, you may notice a lot has changed. We are now live on Mintlify! All the guides and API reference materials you are used to are there. But with Mintlify, the site is built on AI. Thing are now much easier to find, and with the AI Assistant, you don’t even have to find it. Check out all the improvements in this blog.There are more improvements coming, but check it out and let us know what you think!

Hi!I’ve created a custom app using client credentials. After authorizing the app, I noticed that the automation user has a default storage limit of 10 GB.I attempted to increase the storage by first retrieving the user ID via the endpoint “api.box.com/2.0/users/me”, and then sending a PUT request to “api.box.com/2.0/users/{id}”.However, I received a 403 error:error="insufficient_scope", error_description="The request requires higher privileges than provided by the access token."I also verified the app permissions and confirmed that “Manage users” is enabled.Any suggestions on what might be causing this issue?Thanks in advance!

I’m trying to find a way to trigger some automations when a tag is added to a file or folder. I saw this post: and understand there is not currently a webhook event that can do this, but I’m wondering if anyone has figured out a clever workaround? It doesn’t look like there are any Relay events associated with tags either. I see that there is a “TAG_ITEM_CREATE” event type in the Events endpoint: https://developer.box.com/guides/events/, but only by user (i.e., there’s no way to filter enterprise events by that event type)?

When I click 'Run App Diagnostic Report', it gives me an error saying 'Something went wrong. The report did not initiate.' 

The API that I use is this :{{BASE_URL}}/enterprise_configurations/{{ENTERPRISE_ID}}?categories=user_settings,securityAnd I always have 404 response.  I have made sure the enterprise scope is present in token. Infact I tried to login from my docs using same oauth and receive 404 so is it something that needs to be enabled in account?

 Hello,I'm running a program that automatically creates folders and shared links using the Box API.After creating a folder, when I execute the shared link creation (PUT /folders/{id}) for the newly created folder,I receive the following error:Status: 404Details: trashedBoth the folder creation and shared link creation are performed by the same user. Also, although the error message says "trashed," the folder is not in the trash and can be viewed normally in the Box Web UI. Therefore, I'm unable to determine why the 404 error is occurring and am stuck. If anyone has experienced a similar problem or knows a solution, I would appreciate your guidance. Thank you in advance. 

Hi All,We are a Box enterprise customer  having developer licence and are currently working on a integration project involving our developer account and the Box REST API. Specifically, we are building api to perform CRUD operations on the Box User object.We need to utilize the User Tracking Codes functionality to accurately tag our users upon creation. the issue is: The User Tracking Codes section is currently not visible in our Box Admin Console under Enterprise Settings > User Settings. Attempts to create a user via the API using the tracking_codes parameter result in a 400 Bad Request error, which is expected if the feature is not active. Question:          Please help use to enable the tracking_codes feature for the our account.    

Files uploaded years ago using OAuth2.0 were being re-uploaded recently as indicted by the dates on my box.com folder files. I checked the website which it originated from and it wasn’t updated recently. The old files were even actually deleted already from the website it originated from. Any ideas on why this is happening?

I am trying to move a file to another folder where a file with that name already exists. Right now this operation throws 409 “item_name_in_use”. I want to enable versioning on this file move operation. Is there any way to do this or do I need to download and reupload the file for versioning to work?AI suggested using `conflict_resolution = "replace" ` in the body but it did nothing. Is this hallucination?

Dear all.I have a business requirement involving multiple files of different formats that are uploaded at different times to the same folder. I need to extract data from these files and consolidate it into a single file. It is important to note that these files cannot be downloaded to the local machine; the entire process needs to be carried out on the BOX platform.My question is: Is it possible to use the BOX API to write this logic and then have it run automatically in the background at scheduled intervals on BOX?If anyone has experience with similar implementations or solutions, I would appreciate your insights or suggestions. Thank you for your help!

Hello! Has anyone used the no code platform n8n to create workflows? I am currently working on an image tagging workflow that would trigger when a folder is created in a specified box location, and then send those images to be tagged and then update the metadata being stored in a json file. When I create actions in the workflow like get files or get folders, I have no issues. But when I use a box trigger node to start the workflow, I get the following error message : Forbidden - perhaps check your credentials? Show Details Box Trigger: 403 - “”

There are several apps in our Box environment that I need to have deleted. I have them disable but our information security team wants them deleted. How do I go about getting them removed ASAP?

Dear Box Developer Support Team,I hope you are doing well.We are currently using the Box.V2 .NET SDK in our C# application to fetch files and folders from Box.We have a requirement to retrieve all files and folders within a specific date range (e.g., created or modified date) without providing any keyword in the search query.Our goal is to filter Box content by date range only — for example, all items modified between 2025-01-01 and 2025-01-31 — without specifying a search term.Below is the code snippet we are currently using: var searchParams = new BoxSearchRequest(){    Query = "", // No keyword    ContentTypes = new List<string> { "name", "description", "file_content" },    FileExtensions = null,    CreatedAtRangeFromDate = new DateTime(2025, 01, 01),    CreatedAtRangeToDate = new DateTime(2025, 01, 31),    Limit = 1000,    Offset = 0};var searchResults = await client.SearchManager.SearchAsync(searchParams); However, when we omit the keyword (Query = "" or null), the API eithe

I am trying to get data after Selected Date in selected Folder I am using dll with Below Code in C#  searchTermFiles = boxClient.SearchManager.QueryAsync(          query: keyword,                             // Names, descriptions, text contents of files, and other data          ancestorFolderIds: null,                          // Searches to specific parent folders          contentTypes: new[] { "file_content", "name" },                       // Can be name, description, file_content, comments, or tags          limit: limit,                                                 // The default is 30 and the maximum is 200                                    type: "file",                                                 // Can be file, folder, or web_link,          scope: "user_content",          //fileExtensions: new[] { "docx" },          //createdAfter: isFirstTimeScan ? null : DateTimeOffset.Parse(keywordCollection.ModificationDate.ToString()),          //createdBefore: DateTimeOffset.Parse

We are developing a third-party API in-house, and we’ve encountered an issue where, under certain conditions, file uploads via the API result in errors, preventing all files from being uploaded successfully. We would like to determine whether this issue is caused by our application or by specific limitations of the API.To investigate, we generated an API report using the "App Diagnostics" feature on the developer console for our API app at "https://xxxxx.app.box.com/developers/console/app/xxxx". In the report, we found a section labeled "HTTP Status", which showed error statuses such as 400, 409, and 499.However, the list of Box API HTTP status codes available at https://developer.box.com/guides/api-calls/status-codes/ does not provide detailed explanations for these errors. Based on this information, is there any insight into what kind of errors might be occurring? Could it be that we are hitting the API rate limits?

Hello all, I am using the Box API to upload files, which is working fine. But I would like to know is there a way to retrieve the “direct link” from the same api? And how would I set the sharing permissions so that my web app can access the file? My use case is:1- Upload an image using the box API.2- Retrieve the image URL.3- Use the image URL in a web app. (as an image source)Current issues:1- No clear way to generate the direct link from the API. It seems I have to share it in another API call. Or download it every time a user wants to preview it on the web app.2- No clear way to set CORS/viewing permissions without authenticating each user. (I would like to use my service account). What I’m looking for:-Add a property that automatically shares the file when it’s uploaded in the same API.-Have a whitelist for the web app domain or a way to allow it to preview without making the links public. Thank you!

We are receiving a 500 server error when attempting a upload using the BOX API. Is any one else experiencing the same? Our application have not changed and have been working as of yesterday. Here is the error we are getting:{"statusCode":500,"error":"Internal Server Error","message":"An internal server error occurred"}

i got empty error message and i dont know why 

Good afternoon,Hope everyone was able to catch Boxworks today.Is there an easy way to utilize List enterprise users from the API to populate a user MetaData collection?The idea is that the users exist in Box and having to manually add users to the metadata collection is inefficient.  Thanks in advance,Rob

Good day, I have been tasked with automating a file upload to box with Power Automate. If the dated directory doesn’t exist in box to upload the file to then my process must create the directory first. I don’t see any “Create Folder” action in Power Automate for the Box connector - How can I create a folder in box with Power Automate?My box account has the necessary permission to create folders (I’ve tested on box website) but I  need to automate this through Power Automate Desktop but I don’t see the action to so

When calling “Create Folder (https://developer.box.com/reference/post-folders/)”,an HTTP status 403 error was returned with:code: access_denied_insufficient_permissionsmessage: Access denied - insufficient permissionThe API documentation states:403This error is returned when the user lacks the necessary access permissions to perform this action. This may be because the user lacks access to the folder or its parent folder, or the application lacks write permissions for files and folders.However, in this case, what specific permission was lacking?

im having issues with the API, previously i used sign request sandbox which worked great and my portal was pulling data and adding it to the agreements before sending, when trying to add the prefill tags its not pulling the data and then sending the agreement, basically box is refusing the prefill tags being added before sending the document, does anyone know if this is possible for the API to add text tags from my platform to be added to an agreement then be sent for signature ?

Hello Team,We have successfully configured the Box Authorization Service and are able to collect data from Box accounts that have a small number of collaborators (less than 5).However, when attempting to collect from accounts with a large number of collaborators (for example, 92K or 140K), the collection fails after about 5–10 minutes with the following error:Error: “Error loading evidence file”Upon logging the exception details, we observed the following:Exception Type: System.Net.WebExceptionMessage: The operation has timed outDetails: Box Authorization Service: Configured and validated successfully Works as expected for low collaborator counts Fails consistently for high collaborator counts (tens of thousands) Error occurs during the collection phase after several minutes Exception indicates a possible timeout or performance limitation Request for Guidance: Are there known limitations or thresholds in Box when handling accounts with a very large number of collaborators? An

I am trying to run self hosted mcp server using CCG but to get tokens I need a server authentication app to run it on an azure web app as a container. My account is on box free trial.Issue-I can’t authorize the platform app as server authentication. Would be also interested to know what solution other people came up with to get pass this obstacle.

Hi everyone,I'm trying to integrate Box with WatsonX Orchestrate, and I’ve run into an issue I hope someone can help me with.Here’s my setup:I created a Box application using OAuth 2.0 with Client Credentials Grant (Server Authentication). The application has already been approved by the Box administrator. I’m attempting to connect this Box app to WatsonX Orchestrate. However, when I try to establish the connection from WatsonX Orchestrate, I get the following error:redirect_uri_mismatchI understand that this error typically means the redirect URI used in the authentication flow doesn’t match what’s registered in the Box Developer Console. But since I’m using Client Credentials Grant, there shouldn’t be a redirect URI involved, right?Has anyone successfully connected Box to WatsonX Orchestrate using this method?Do I need to configure a redirect URI anyway, or is there something specific WatsonX expects?Any guidance or examples would be greatly appreciated. I’d love to learn from others