API

During call to query folder by metadata I'm getting HTTP 400 - too_many_instances, this is happening just with one box subscription, it's working for the other oneRequest:curl --location 'https://api.box.com/2.0/metadata_queries/execute_read' \--header 'box-version: 2024.0' \--header 'Content-Type: application/json' \--header 'Authorization: Bearer ****' \--data '{ "from": "enterprise_1234.metadata", "query": "entityId = :entityId and entityType = :entityType", "query_params": { "entityId": 1, "entityType": "TEST_FOLDER" }, "fields": [ "id" ], "ancestor_folder_id": "0"}'Response:{ "type": "error", "status": 400, "code": "too_many_instances", "help_url": "https://developer.box.com/reference/post-metadata-queries-execute-read/", "message": "Too many instances, and no supporting index available", "request_id": "0e75317d0072c5a523ba79f1422552050"}Tried to find something in box community but all the references are old and the links

issue 1: Were I have a box account as a admin and have the access to the whole box and things in there i am a partner on a box app in the developer console which i can’t able to access to the webhook v2 (with the signature and security) there i have enabled the manage webhook there but i can’t be able to use the webhook tab in there and use them there…issue 2: were there is no option for creating the access token (the permanent developer token) for my application there i need the specific steps to do it and enable them as well.. I need the proper steps to mitigate these issues and solve it the docs of the box are not suffice in some aspects in there which misses out the the primary and complete steps in there can you guide me through the steps to solve these things in there.  

 OverviewWhen executing the following API, only certain accounts are unable to retrieve the file list, which prevents the process from proceeding.If you have any insights on possible causes or solutions, I would greatly appreciate your guidance. Target APIhttps://api.box.com/2.0/folders/${folderId}/items?fields=id%2Cname%2Ctype%2Cmodified_at%2Cextension%2Cshared_link%2Cexpiring_embed_link&limit=100&offset=0 OAuth Endpoint Authorization: https://account.box.com/api/oauth2/authorize Revoke: https://api.box.com/oauth2/revoke Scope root_readwrite Execution EnvironmentReact Native + Expo SDK 51 + Expo Auth SessionWhat we have checked so far No API or network errors occurred, and no error information is available. Other accounts can retrieve the file list without any issues (both free and organizational accounts work fine). We verified account information using https://api.box.com/2.0/users/me. However, for accounts that cannot retrieve the file list, certain expec

Hi, I couldn’t find any information on whether I can create custom apps on Business and Business Plus plans. And if we can, can we enable the “App + Enterprise Access” scope for the custom app? Thanks!

Hi, im using n8n box create folder node, sometimes i get this error, seems like box api issues?{  "errorMessage": "The DNS server returned an error, perhaps the server is offline",  "errorDetails": {    "rawErrorMessage": [      "getaddrinfo EAI_AGAIN api.box.com",      "getaddrinfo EAI_AGAIN api.box.com"    ],    "httpCode": "EAI_AGAIN"  },  "n8nDetails": {    "nodeName": "Create a folder",    "nodeType": "n8n-nodes-base.box",    "nodeVersion": 1,    "resource": "folder",    "operation": "create",    "time": "8/11/2025, 5:29:04 PM",    "n8nVersion": "1.102.3 (Self Hosted)",    "binaryDataMode": "default",    "stackTrace": [      "NodeApiError: The DNS server returned an error, perhaps the server is offline",      "    at ExecuteContext.boxApiRequest (/usr/local/lib/node_modules/n8n/node_modules/.pnpm/n8n-nodes-base@file+packages+nodes-base_@aws-sdk+credential-providers@3.808.0_asn1.js@5_1af219c3f47f2a1223ec4ccec249a974/node_modules/n8n-nodes-base/nodes/Box/GenericFunctions.ts:46:9)", 

Hello Box Community,I’m working on integrating Box with my application and want to establish a security policy federation. Specifically, I want to map user permissions from Box to my application’s permission model, ensuring consistent access control across both platforms.So far, I have explored the following: The Get File API to retrieve permissions, but it only returns permissions for the current user. This means I would need to get all enterprise users and execute the Get File API for each user individually to gather permissions for all users, which seems inefficient. The Collaborations API to retrieve collaborators on files and folders. Is there any existing solution, best practice, or recommended approach for: Federating security policies between Box and an external application? Efficiently mapping Box user permissions or roles to custom permissions in my app without having to query each user individually? Tools or APIs provided by Box to facilitate this kind of integration?

I’m an admin in our Box Business (not plus) account and have already enabled all the required permissions as outlined in the Box documentation.I’m trying to impersonate a user using the As-User header, but when I use an OAuth 2.0 access token obtained via the refresh token flow, I consistently receive a 403 Forbidden error.However, when I use a Developer Token generated directly from the Box Developer Console (UI), the same API call works without issues. What could I be missing here?Does the Developer Token grant broader permissions compared to tokens obtained via the OAuth 2.0 refresh token flow?Is there something I need to configure differently during authentication to ensure the correct permissions or context are applied?  

Thought I read somewhere that free accounts can’t upload files using the Python API, but I couldn’t find anything about it in the docs.Anyone know if that’s still true?

I’m building a web application (React + Node.js) that integrates Box for document storage and collaboration using the Office Online editing feature. Here's a summary of our use case:✅ Use Case Overview: Users in our app upload various documents (e.g. .docx) for collaboration purposes When a document is uploaded: It is saved to Box via the API We store the file_id and metadata in our own database The user interface (our app) allows users to: Preview documents (via embedded Box preview) Edit documents (in Word Online) 🔐 Access Design: All Box operations are handled by a single Box service account End users do not have Box accounts When users click “Edit,” we want to redirect them directly to an Office Online editing session for the document ❓ Key Question:Is there any supported way to generate an editable Office Online link via the Box API that does not require the end user to log into Box?If not, is there a workaround — such as using App Users, JWT auth, or pr

In my iOS app, I am using UIDocumentPickerViewController to pick a file from a Box Drive file provider. I am using startAccessingSecurityScopedResource on the url I receive and register an NSFilePresenter for this url to get change notifications. When I read the contents of the file, I am using file coordination.  Reading the initial content is working fine. When now however the file is changed on some other machine, I expect a change notification from the file presenter and I should be able to read the fresh data from the updated file. This is however not working. I am only getting fresh data, when I terminate my app and re-pick the file with the UIDocumentPickerViewController.Is this a fundamental limitation of the Box Drive file provider under iOS or is there some secret on how to get fresh data while the app is running?

I'm trying to generate a client secret on my developer account. I have fully set up MFA (see screenshot below). Whenever I try to click "Fetch Client Secret", it redirects me to "https://app.box.com/login/mfa?redirectUrl=/developers/console/app/2363167/configuration&from=dev_console" and I then get the below screenshot. This is a bug, can somebody please help me?

I’m trying to clarify MCP billing.1. Remote Box MCP Server  2. Self‑Hosted Box MCP Server  The Self‑Hosted Box MCP Server uses the Box SDK internally, which makes the underlying API calls. I think this is chargeable.Docs say:• Partner Integration is non-chargeable.  • Custom App is chargeable.For case of remote box mcp server, will the API calls be marked as chargeable or not?

https://api.box.com/2.0/users call fails eventhough right permission set thru developer portal

We have many different organizations using our integration with Box.  All of them except for one obtains and uses OAuth refresh tokens, all day, every day.One organization in particular is complaining about "losing their connection" with Box.  The scenario is that the user has not used their OAuth connection in over an hour, so the OAuth token is expired;  we use the refresh token to obtain a new OAuth token (and new refresh token), but the request fails with the error; "invalid grant"  "Invalid refresh token" It hasn't been 60 days, so that's not the error (that error reports "timeout" which is not what we're seeing.    It's not an attempt to use the same refresh token more than once (we've eliminated that possibility).In other OAuth systems, I know that if the user changes his password that it will invalidate any outstanding OAuth refresh tokens.  Could this be the case here?   Are there any other cases in which would cause an OAuth refresh token to become invalid?

I'm currently using a Box Individual Plan and I'm developing an integration with ServiceNow using the Box Developer Platform.However, with my current plan, I’m unable to generate the Primary Key and Secondary Key, and I also do not see the Webhooks section available in the admin console or developer settings.https://www.servicenow.com/docs/bundle/yokohama-integrate-applications/page/administer/integrationhub-store-spokes/task/setup-webhook-box-spoke.htmlCould you please confirm:  Does the Box Individual Plan support the use of Webhooks v2 via the API? If not, which minimum Box plan is required to enable Webhook functionality?  

While i was working on Box Preservations Im stucked while assigning the Hold policy to user / folder with the following endpoint.https://{{api.box.com}}/2.0/legal_hold_policy_assignmentsPayload: {  "policy_id": "3710887",  "assign_to": {    "type": "user",    "id": "2262844940"  }}The access token was generated with all the scopes mentioned as belowroot_readwrite manage_app_users manage_groups enterprise_content manage_legal_holds manage_legal_hold_policies manage_legal_hold_policy_assignmentspolicy creation is working fine with the app Onna Enterprise [Stage]. But this is failing with error {    "type": "error",    "status": 403,    "code": "access_denied_insufficient_permissions",    "help_url": "http://developers.box.com/docs/#errors",    "message": "Access denied - insufficient permission",    "request_id": "w42h6ui2xemxd8tt"}As i tried to research on this i came to know that we have to raise a support ticket to Box to enable manage_legal_hold_policies manage_legal_hold_policy_assi

Hi,I have created an application (2404923) to upload the files to box from a program. It is in status “Pending Authorization”. How long it takes to get approved? Or how to know who can help approve my application?Thanks a lot 

using the .Net Sdki am not seeing the update metdata for a file  those are the fileds         public const string FieldSequence = "sequence_id";        public const string FieldEtag = "etag";        public const string FieldName = "name";        public const string FieldCreatedAt = "created_at";        public const string FieldModifiedAt = "modified_at";        public const string FieldDescription = "description";        public const string FieldSize = "size";        public const string FieldPathCollection = "path_collection";        public const string FieldCreatedBy = "created_by";        public const string FieldModifiedBy = "modified_by";        public const string FieldOwnedBy = "owned_by";        public const string FieldSharedLink = "shared_link";        public const string FieldParent = "parent";        public const string FieldItemStatus = "item_status";        public const string FieldPermissions = "permissions";        public const string FieldTags = "tags";  Am I missing so

I'm trying to generate a Public/Private keypair in the developer console for my application, but it continuous to fail. I already set the 2FA, but still can’t generate my keys. I need help!

I’m trying to set up a new Platform App using JWT, but when I attempt to generate a public/private key, or upload my self-generated public key, I get an error about needing 2-factor on. My 2-factor is on. It then sends me to a dead-end page in Box outside of the Developer page.

I have a Box app with a valid Client ID and Client secret. The app is set to App + Enterprise Access. I also have “Manage Enterprise Properties” checked. I can receive a Bearer Token using the Client ID and Client secret. However, when I try to retrieve events using curlcurl -i -X GET "https://api.box.com/2.0/events" \ -H "authorization: Bearer <ACCESS_TOKEN>"I get thisHTTP/2 200 date: Fri, 11 Jul 2025 06:38:55 GMTcontent-type: application/jsonx-envoy-upstream-service-time: 70strict-transport-security: max-age=31536000box-request-id: 0ad50df19baed02f845ec8d10931bcb48via: 1.1 googlealt-svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000{"entries":[],"next_stream_position":30401049700682011,"chunk_size":0}% Why is my entries empty?

Hi, I am facing the issue where I’m getting back the following error when trying to enable webhooks for a folder via the API using a valid OAuth token:error="insufficient_scope", error_description="The request requires higher privileges than provided by the access token."Example of a request:curl -X POST "https://api.box.com/2.0/webhooks" -H 'authorization: Bearer '$BOX_TOKEN'' -H "content-type: application/json" -d '{"target": {"id": "0", "type": "folder"}, "address": "xxx", "triggers": ["FILE.UPLOADED", "FILE.TRASHED", "FILE.RESTORED", "FILE.MOVED", "FILE.RENAMED"]}'I can confirm that Manage webhooks is enabled in the console. I have also followed steps to here to make sure the app is enabled the app in the admin console. Note that there’s no authorization option for OAuth apps under Platform Apps Manager -> User Authentication Apps tab. I’m facing this issue even with a fresh token is obtained after making the configuration changes above.What can be done to overcome this?

I submitted a ticket with Support about not being able to access or enable the GxP feature and shared back screenshots where they said I should see the option to enable the GxP Sandbox and nothing was available, and Support said to open an issue with my Account Rep which I don’t have. I tried to open a ticket with Accounts, and it was closed in favor of the ticket with Support and marked as a duplicate which I wasn’t able to re-open to refute. So far I’ve been very unimpressed with Box and Box Support and am considering asking for a refund. Has anyone else been able to get GxP functionality setup with Box and how did you do it? We have the Enterprise Plus license which indicates GxP as a feature.  

Hello,I am trying to automate some workflows for our NGO with the help of the APIs of box. Right now I am testing the endpoints in bruno. Many endpoints are working fine with the developer token. However I can’t get the Box sign APIs to work. "The request requires higher privileges than provided by the access token."We are on the “nonprofit Starter” box plan with 25k API calls per month.I have submitted and approved the app to our workspace. I have enabled all scopes within the app that I see (however I see none specific to box sign): Box sign is enabled for our organization and working fine manually: Are box sign APIs only available for higher tier subscriptions? If yes the description in the “Plan comparison” is misleading because it does not state which APIs are available per plan.Thanks for your time!

In box developer I have setup a platform app to connect and sync some data from an Ubuntu server using rclone.I have done all steps correctly but upon connecting i get error 403 forbidden, though the access token is valid.Probably, while doing some tests for the script, seems like box banned the server ip.I tried reproducing from other machine using the same platform app, and everything works.How can box.com remove IP from blacklist?I am not using paid account yet, I am on the free tier, but I am not willing to proceed to premium if such block encounters.