API

With some help from Claude we built a standalone Box Mock service which responds to most APIs (well, most the ones our app uses).   YMMV but it’s here if you find it helpful:  https://github.com/transparency-analytics/box-mock

I am using Box API v10 via the Node SDK to query for Folders, specifically:client.folders.getFolderItems(parentId) // parentId is a folder name that exists (e.g. ‘QCG Test’) The value I am receiving from Box API does not match the Folder ID found in the URL of the folder when viewing My Account.For Example:My folder name is “QCG Test” with an Id (from Box URL) of: ********5204The value received when I query for this Folder ID from the API returns as: ********0532Note: The values above are edited to censor the full ID. The censored digits do not match as well.

Im creating Webhook to setup a Automatic trigger that will notify my project application if there is any change in the Box side (Ex: File Uploaded).The setup was fine, but i didnt receive any data delivered to my application. After checking, turnout my application doesnt allow public network traffic, and it would need to setup an IP allow list for Webhook to be able to connect. ( I did check with our testing environment that allowed public traffic. It worked)I had follow this ip address list from this site : https://support.box.com/ips but it is not working yet.Also, I tested with webhook.site and get the data coming from 74.112.186.xx instead of the ip from the list above. So my question is : Do Box’s Webhook data come from a static range of IP addresses. If so, can I get the info anywhere? Best Regards.

Subject: OAuth invalid_client after login — Custom App with valid credentials Authentication Type: OAuth 2.0 (User Authentication) Status in Dev Console: Enabled Status in Admin Console → Platform Apps Manager → User Authentication Apps: Enabled Issue: The OAuth authorize endpoint returns "invalid_client" after the user logs in (logged in as the app owner [removed by moderator] ). The error page shows Error: invalid_client with no Show Details revealed. What I have already verified: 1. Client Secret is correct — confirmed via curl POST to https://api.box.com/oauth2/token with a fake auth code. Response: {"error":"invalid_grant","error_description":"Auth code doesn't exist or is invalid for the client"} This proves client_id + client_secret are accepted by Box's token endpoint. 2. Redirect URI is registered exactly as sent in the consent request: 3. Scopes: Read all files + Write

We want to apply tags based on the content of the pdfs we store in box. is there a way for Box AI to analyze individual pdf files and apply tags from a pre-created list of tags?

We need access to the v1 webhooks for our app. This is so that our users can select a folder or root folder to monitor for new media files to auto import and transcribe using our service.I have already tested the webhooks functionality in production using our collaborator accounts.This is urgent because a lot of our box users have been asking for instant sync - currently we are having to poll the api for each connected user - hitting api rate limits.

Hi,I am using BOX python sdk to download files from a shared box drive. I use the code below to download files from the box drive. Recently, i noticed that this doesn’t return/download all of the files that matches the search query. I reported the issue to box sdk here but i was told it was an API issue. Can you please resolve this issue ASAP.

Hello!I need assistance with enabling my account as a free developer account so I can authorize apps and continue developing. However, I keep seeing the message, "Log in or sign up for a Box Developer account to access all of the Developer Console features," even though I am already logged in.If anyone knows what might be happening or how to resolve this, I would really appreciate your help.

  Hi everyone,  We are investigating an intermittent upload failure pattern and would  appreciate any community insights or official clarification.  When uploading files via the Box REST API using direct upload (non-chunked),  we have observed that some transfers are terminated mid-stream by the  server. The termination appears as TCP FIN followed by RST from  upload.box.com, with no HTTP response returned prior to disconnection.  This behavior occurs specifically on clients with lower network throughput,  which suggests the issue may be related to a time-based or throughput-based  threshold on the server side.  What we have ruled out:  - SSL inspection (not deployed in our environment)  - Intermediate proxy interference (packet analysis confirms server-initiated    disconnection from Box IP)  - HTTP-level rate limiting (no HTTP 429 received)  - Client-side timeout (the SDK does not i

SummaryThe preflight check endpoint applies NFKC normalization to the incoming filename/folder name before checking for conflicts, but does not apply the same normalization to the names already stored in the folder. This causes an order-dependent, asymmetric 409 conflict for NFKC-equivalent names that can legitimately coexist as separate items.Steps to reproduceTake two names that are NFKC-equivalent but distinct code points:- Item A: `\uFA1B` (CJK Compatibility Ideograph, U+FA1B)- Item B: `\u798F` (CJK Unified Ideograph, U+798F)These two items can coexist in Box — the actual upload/create endpoint accepts both. However:Order 1 (succeeds):1. Upload/create `\uFA1B` → stored as `\uFA1B` ✓2. Upload/create `\u798F` → preflight normalizes `\u798F` → `\u798F`, no exact `\u798F` in folder → OK ✓Order 2 (fails):1. Upload/create `\u798F`

Hello,We are looking to automate Box workflows using the API, and I would like to better understand how the tagging system works. Are there any limits on the number of tags that can be assigned to a file or folder? Are there restrictions on tag length, as well as on the type of characters allowed (special characters, numbers, etc.), particularly when using the Box API?

Apologies if this has been asked in the past. Can someone tell me how I can get release notification for upcoming changes to Box AI API? I saw notes from https://support.box.com/hc/en-us/categories/21356727474323-Product-Guides but does not articulate any changes in the API (or changes to the default AI model). I’d like to be notified before the changes roll into Production so we can adequately prepare for the changes.

Is it possible to create and list service accounts using box api 

I am creating a signature request using the API. When the end user accesses the sign-in link, this dialog appears and is in English language. How can I change this text language?

I have been attempting to initiate a DocGen process through the API, and am being met with a 403 error indicating insufficient permissions. According to the developer console, ‘Manage Doc Gen’ is checked and enabled. I even forced a token refresh to see if that would make things update. Those efforts have had no effect, and the 403 error is still present. Are there any further steps I can take?The error response in full:{"message":"Insufficient permissions: Document Generation scope not enabled for this OAuth application","status":"error","fileId":null}The app’s service account is the one performing the action, and I have verified that it has access to all of the relevant folders and files the call is attempting to interact with.

Subject: OAuth 2.0 app — invalid_client on authorize endpointI'm getting an `invalid_client` error when attempting the OAuth 2.0 authorization flow for a custom app on our Standard Enterprise account (Enterprise ID: 42813).What I've done:1. Created a new Custom App in the Developer Console, selecting "OAuth 2.0" as the App Type at creation time (App ID: 2544805, "Claude OAuth")2. Configured redirect URI: http://localhost3. Scopes: Read all files/folders, Write all files/folders, Manage AI4. Saved configuration5. Verified Enterprise Settings > Platform Apps > "Disable unpublished platform apps by default" is OFFWhen I visit:https://account.box.com/api/oauth2/authorize?client_id=8q17251dyhyzbopddx012vadvvnk6at3&response_type=code&redirect_uri=http://localhostI get: "There was an error logging you in. Please restart your application and try again."In incognito, the error is more specific: "Error: inva

Hi, I’m trying to use the metadata query API to find files with a particular multiSelect value, but nothing I’m trying is working correctly and the documentation doesn’t even address this issue except to say that the “IN” operator won’t work on these fields. There has to be a way to do this. Currently , all I can do is find files with *the exact same list of multiSelect values* as I specify, but that’s not what I want. I want to be able to search for: assetType := “LOGO” and return all assets that *include* LOGO as one of the assetType values, but could contain other values as well. I’m not looking for items that only have that one value. So for instance, that search above should also match an item with assetType = ‘LOGO’, ‘ART’]   

Given a lock event returned from the List user and enterprise events endpoint, how can I determine the parent item that the event applies to? I cannot see any reference to the parent from the response payload (see below) nor any “Get lock by ID” endpoint or equivalent that I could use. Lock event response example{ "type" : "event", "createdAt" : "2026-03-19T14:41:22Z", "recordedAt" : "2026-03-19T14:41:25Z", "eventId" : "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", "createdBy" : { "id" : "XXXXXXXXXXX", "type" : "USER", "name" : "Foo Bar", "login" : "foo.bar@example.com" }, "eventType" : "LOCK_CREATE", "source" : { "id" : "XXXXXXXXXXX", "type" : "LOCK", "createdAt" : { "value" : "2026-03-19T14

As part of a disaster recovery my hosting company has moved my website to a different server, even a different datacentre. Since then my rclone backups don’t work, saying the token has expited, The expirry date in rclone.conf is shown as the last successful backup on the old server.Can someone advise me what I have to do to get it working again please?

I’m trying to download a file that I created via the API, but keep getting an SSL error. Note that I can download the same file successfully using the API Developer playground, providing just the file ID and my developer token. See curl output below:$ curl -i -L "https://api.box.com/2.0/files/ [removed by moderator] /content" -H "authorization: Bearer <REDACTED_TOKEN>"HTTP/2 302 date: Wed, 11 Mar 2026 12:55:49 GMTx-envoy-upstream-service-time: 259location: <REDACTED_LINK>box-request-id: 07a3f1d1a260e4d0957df37044c38d148cache-control: no-cache, no-storestrict-transport-security: max-age=31536000via: 1.1 googlecontent-length: 0alt-svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000curl: (35) error:0A000126:SSL routines::unexpected eof while reading

Hello Box Community,I am currently using a free account, and I’ve noticed that I am unable to find the "Webhook" tab in the Developer Console. Could anyone here clarify which paid plan includes access to the "Webhook" feature?I would appreciate any help or insights on this.Thanks in advance!

HiError code as below, can you help me to solve this problem? {  "error": {    "message": "403: Box team folder not found",    "type": "server_error",    "param": null,    "code": null  }}

I would like to remove pinned devices in our enterprise on accounts that have had no activity in 90 days. I wrote the following with the help of Gemini and it appears it will work. I’m new to the Box CLI so if anyone else with more experience can take a look at this I’d appreciate it. # 1. Calculate the date 90 days ago in ISO 8601 format$thresholdDate = (Get-Date).AddDays(-90)Write-Host "Looking for users inactive since: $($thresholdDate.ToShortDateString())" -ForegroundColor Cyan# 2. Get all users and filter by 'modified_at'# Note: --max-items 5000 ensures we don't just get the first page$inactiveUsers = box users --all-users --json --max-items 5000 | ConvertFrom-Json | Where-Object { [datetime]$_.modified_at -lt $thresholdDate}if ($inactiveUsers.Count -eq 0) { Write-Host "No inactive users found. Exiting." -ForegroundColor Green exit}

In short: the app created a second folder ( [removed by moderator] ) because the Box service account it authenticates with may have a different root folder ("0") than the Box user where your original folder ( [removed by moderator] ) exists.Your files are being saved inside the app's folder ( [removed by moderator] ), not your existing one ( [removed by moderator] ). To find them, look for the service account's content in your Box admin console — it may be listed under "Service Account" or "App User" content depending on your Box enterprise setup.How do I see Service Account or App User folders????

When a folder is moved to the trash, webhook notifications for the files inside are not sent. Is this by design?Notifications will be sent for folders inside a folder that has been moved to the trash.