{"openapi":"3.1.0","info":{"title":"Ferrule Box API","version":"1.0.0","description":"REST API for Box via the Ferrule gateway.","contact":{"name":"Ferrule","url":"https://ferrule.io"}},"servers":[{"url":"https://0.0.0.0:3000","description":"Ferrule gateway"}],"paths":{"/api/v1/box/files/{file_id}":{"get":{"operationId":"box.get_file","description":"Retrieve details for a file by its ID, including name, size, owner, path, and metadata.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the file (e.g. '12345')."},"required":true,"description":"The unique identifier of the file (e.g. '12345')."},{"in":"query","name":"fields","schema":{"description":"Comma-separated list of fields to include (e.g. 'name,size,modified_at').","type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"file"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"pathCollection":{"anyOf":[{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["totalCount","entries"],"additionalProperties":{}},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentCreatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentModifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"modifiedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"ownedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"sharedLink":{"anyOf":[{"type":"object","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"downloadUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"vanityUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"vanityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectiveAccess":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectivePermission":{"anyOf":[{"type":"string"},{"type":"null"}]},"isPasswordEnabled":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"unsharedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"downloadCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"previewCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"access":{"anyOf":[{"type":"string"},{"type":"null"}]},"permissions":{"anyOf":[{"type":"object","properties":{"canDownload":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"canPreview":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"canEdit":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"itemStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]},"fileVersion":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"extension":{"anyOf":[{"type":"string"},{"type":"null"}]},"permissions":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"lock":{"anyOf":[{},{"type":"null"}]},"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}},"patch":{"operationId":"box.update_file","description":"Update a file's name, description, or move it to a different folder by changing its parent.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the file to update."},"required":true,"description":"The unique identifier of the file to update."},{"in":"query","name":"name","schema":{"description":"New name for the file.","type":"string"}},{"in":"query","name":"description","schema":{"description":"New description for the file.","type":"string"}},{"in":"query","name":"parent_id","schema":{"description":"ID of the new parent folder to move the file into. Use '0' for root.","type":"string"}},{"in":"query","name":"tags","schema":{"description":"Array of tags to set on the file."}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}},"delete":{"operationId":"box.delete_file","description":"Delete a file by its ID, moving it to the trash.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the file to delete."},"required":true,"description":"The unique identifier of the file to delete."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/files/{file_id}/copy":{"post":{"operationId":"box.copy_file","description":"Copy a file to a destination folder. Optionally provide a new name.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the file to copy."},"required":true,"description":"The unique identifier of the file to copy."},{"in":"query","name":"parent_id","schema":{"type":"string","description":"ID of the destination folder for the copy."}},{"in":"query","name":"name","schema":{"description":"Optional new name for the copied file.","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"file"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"pathCollection":{"anyOf":[{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["totalCount","entries"],"additionalProperties":{}},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentCreatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentModifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"modifiedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"ownedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"sharedLink":{"anyOf":[{"type":"object","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"downloadUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"vanityUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"vanityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectiveAccess":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectivePermission":{"anyOf":[{"type":"string"},{"type":"null"}]},"isPasswordEnabled":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"unsharedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"downloadCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"previewCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"access":{"anyOf":[{"type":"string"},{"type":"null"}]},"permissions":{"anyOf":[{"type":"object","properties":{"canDownload":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"canPreview":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"canEdit":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"itemStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]},"fileVersion":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"extension":{"anyOf":[{"type":"string"},{"type":"null"}]},"permissions":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"lock":{"anyOf":[{},{"type":"null"}]},"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/files/{file_id}/download-url":{"get":{"operationId":"box.get_download_url","description":"Get a temporary download URL for a file. The URL is valid for a short time.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the file to download."},"required":true,"description":"The unique identifier of the file to download."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/files/{file_id}/versions":{"get":{"operationId":"box.list_file_versions","description":"List all past versions of a file. Versions are only tracked for premium accounts.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the file."},"required":true,"description":"The unique identifier of the file."},{"in":"query","name":"limit","schema":{"description":"Maximum number of versions to return per page.","type":"number"}},{"in":"query","name":"offset","schema":{"description":"Offset for pagination (0-based).","type":"number"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"modifiedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]},"trashedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"trashedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"restoredAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"restoredBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"purgedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"uploaderDisplayName":{"anyOf":[{"type":"string"},{"type":"null"}]},"versionNumber":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"offset":{"anyOf":[{"type":"number"},{"type":"null"}]},"limit":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["totalCount","entries"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/files/{file_id}/versions/promote":{"post":{"operationId":"box.promote_file_version","description":"Promote an older version of a file to become the current version. Creates a copy of the old version as the latest.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the file."},"required":true,"description":"The unique identifier of the file."},{"in":"query","name":"version_id","schema":{"type":"string","description":"The ID of the file version to promote."}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/folders/{folder_id}":{"get":{"operationId":"box.get_folder","description":"Retrieve details for a folder by its ID, including the first 100 items. Use '0' for the root folder.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"folder_id","schema":{"type":"string","description":"The unique identifier of the folder. Use '0' for the root folder."},"required":true,"description":"The unique identifier of the folder. Use '0' for the root folder."},{"in":"query","name":"fields","schema":{"description":"Comma-separated list of fields to include.","type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"pathCollection":{"anyOf":[{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["totalCount","entries"],"additionalProperties":{}},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"modifiedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"ownedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"sharedLink":{"anyOf":[{"type":"object","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"downloadUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"vanityUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"vanityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectiveAccess":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectivePermission":{"anyOf":[{"type":"string"},{"type":"null"}]},"isPasswordEnabled":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"unsharedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"downloadCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"previewCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"access":{"anyOf":[{"type":"string"},{"type":"null"}]},"permissions":{"anyOf":[{"type":"object","properties":{"canDownload":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"canPreview":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"canEdit":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"itemStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"itemCollection":{"anyOf":[{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{}},"offset":{"anyOf":[{"type":"number"},{"type":"null"}]},"limit":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["totalCount","entries"],"additionalProperties":{}},{"type":"null"}]},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"permissions":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"folderUploadEmail":{"anyOf":[{},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}},"patch":{"operationId":"box.update_folder","description":"Update a folder's name, description, or move it to a different parent folder.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"folder_id","schema":{"type":"string","description":"The unique identifier of the folder to update."},"required":true,"description":"The unique identifier of the folder to update."},{"in":"query","name":"name","schema":{"description":"New name for the folder.","type":"string"}},{"in":"query","name":"description","schema":{"description":"New description for the folder.","type":"string"}},{"in":"query","name":"parent_id","schema":{"description":"ID of the new parent folder to move into.","type":"string"}},{"in":"query","name":"tags","schema":{"description":"Array of tags to set on the folder."}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}},"delete":{"operationId":"box.delete_folder","description":"Delete a folder by its ID, moving it to the trash. Set recursive to true to delete non-empty folders.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"folder_id","schema":{"type":"string","description":"The unique identifier of the folder to delete."},"required":true,"description":"The unique identifier of the folder to delete."},{"in":"query","name":"recursive","schema":{"description":"Whether to delete the folder even if it is not empty (default: false).","type":"boolean"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/folders/{folder_id}/items":{"get":{"operationId":"box.list_folder_items","description":"List items (files, folders, web links) in a folder with pagination support.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"folder_id","schema":{"type":"string","description":"The unique identifier of the folder. Use '0' for the root folder."},"required":true,"description":"The unique identifier of the folder. Use '0' for the root folder."},{"in":"query","name":"fields","schema":{"description":"Comma-separated list of fields to include.","type":"string"}},{"in":"query","name":"limit","schema":{"description":"Maximum number of items to return (max 1000).","type":"number"}},{"in":"query","name":"offset","schema":{"description":"Offset for pagination (0-based).","type":"number"}},{"in":"query","name":"sort","schema":{"description":"Sort field: 'id', 'name', or 'date'.","type":"string"}},{"in":"query","name":"direction","schema":{"description":"Sort direction: 'ASC' or 'DESC'.","type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{}},"offset":{"anyOf":[{"type":"number"},{"type":"null"}]},"limit":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["totalCount","entries"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/folders":{"post":{"operationId":"box.create_folder","description":"Create a new folder inside a parent folder.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"query","name":"name","schema":{"type":"string","description":"Name for the new folder."}},{"in":"query","name":"parent_id","schema":{"type":"string","description":"ID of the parent folder. Use '0' to create in the root folder."}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"pathCollection":{"anyOf":[{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["totalCount","entries"],"additionalProperties":{}},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"modifiedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"ownedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"sharedLink":{"anyOf":[{"type":"object","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"downloadUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"vanityUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"vanityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectiveAccess":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectivePermission":{"anyOf":[{"type":"string"},{"type":"null"}]},"isPasswordEnabled":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"unsharedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"downloadCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"previewCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"access":{"anyOf":[{"type":"string"},{"type":"null"}]},"permissions":{"anyOf":[{"type":"object","properties":{"canDownload":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"canPreview":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"canEdit":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"itemStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"itemCollection":{"anyOf":[{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{}},"offset":{"anyOf":[{"type":"number"},{"type":"null"}]},"limit":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["totalCount","entries"],"additionalProperties":{}},{"type":"null"}]},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"permissions":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"folderUploadEmail":{"anyOf":[{},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/folders/{folder_id}/copy":{"post":{"operationId":"box.copy_folder","description":"Copy a folder and its contents to a destination folder. Optionally provide a new name.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"folder_id","schema":{"type":"string","description":"The unique identifier of the folder to copy."},"required":true,"description":"The unique identifier of the folder to copy."},{"in":"query","name":"parent_id","schema":{"type":"string","description":"ID of the destination folder for the copy."}},{"in":"query","name":"name","schema":{"description":"Optional new name for the copied folder.","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"pathCollection":{"anyOf":[{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["totalCount","entries"],"additionalProperties":{}},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"modifiedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"ownedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"sharedLink":{"anyOf":[{"type":"object","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"downloadUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"vanityUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"vanityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectiveAccess":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectivePermission":{"anyOf":[{"type":"string"},{"type":"null"}]},"isPasswordEnabled":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"unsharedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"downloadCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"previewCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"access":{"anyOf":[{"type":"string"},{"type":"null"}]},"permissions":{"anyOf":[{"type":"object","properties":{"canDownload":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"canPreview":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"canEdit":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"itemStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"itemCollection":{"anyOf":[{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{}},"offset":{"anyOf":[{"type":"number"},{"type":"null"}]},"limit":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["totalCount","entries"],"additionalProperties":{}},{"type":"null"}]},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"permissions":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"folderUploadEmail":{"anyOf":[{},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/search":{"post":{"operationId":"box.search_content","description":"Search for files, folders, and web links across the user's content. Supports full-text search with Boolean operators (AND, OR, NOT).","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"query","name":"query","schema":{"description":"Search query string. Supports AND, OR, NOT operators and quoted exact matches.","type":"string"}},{"in":"query","name":"type","schema":{"description":"Limit to 'file', 'folder', or 'web_link'.","type":"string"}},{"in":"query","name":"file_extensions","schema":{"description":"Comma-separated file extensions to filter by (e.g. 'pdf,docx').","type":"string"}},{"in":"query","name":"ancestor_folder_ids","schema":{"description":"Comma-separated folder IDs to scope the search.","type":"string"}},{"in":"query","name":"content_types","schema":{"description":"Comma-separated content types: 'name', 'description', 'file_content', 'comments', 'tags'.","type":"string"}},{"in":"query","name":"limit","schema":{"description":"Maximum number of results to return.","type":"number"}},{"in":"query","name":"offset","schema":{"description":"Offset for pagination (max 10000).","type":"number"}},{"in":"query","name":"sort","schema":{"description":"Sort by 'relevance' (default) or 'modified_at'.","type":"string"}},{"in":"query","name":"direction","schema":{"description":"Sort direction: 'ASC' or 'DESC'.","type":"string"}},{"in":"query","name":"created_at_range","schema":{"description":"Comma-separated date range for creation date (e.g. '2023-01-01T00:00:00Z,2023-12-31T23:59:59Z'). Omit start or end for open ranges.","type":"string"}},{"in":"query","name":"updated_at_range","schema":{"description":"Comma-separated date range for last update date (e.g. '2023-01-01T00:00:00Z,2023-12-31T23:59:59Z'). Omit start or end for open ranges.","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"entries":{"type":"array","items":{}},"offset":{"anyOf":[{"type":"number"},{"type":"null"}]},"limit":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["entries"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/folders/{folder_id}/collaborations":{"get":{"operationId":"box.list_folder_collaborations","description":"List all collaborations (shared access) on a folder, including pending invitations.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"folder_id","schema":{"type":"string","description":"The unique identifier of the folder."},"required":true,"description":"The unique identifier of the folder."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"createdBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"accessibleBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"acknowledgedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"inviteEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"item":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"offset":{"anyOf":[{"type":"number"},{"type":"null"}]},"limit":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["totalCount","entries"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/collaborations":{"post":{"operationId":"box.add_collaboration","description":"Add a collaborator to a file or folder. Specify the item, the user or group, and their role.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"query","name":"item_type","schema":{"type":"string","description":"Type of item: 'file' or 'folder'."}},{"in":"query","name":"item_id","schema":{"type":"string","description":"ID of the file or folder."}},{"in":"query","name":"accessible_by_type","schema":{"type":"string","description":"Type of collaborator: 'user' or 'group'."}},{"in":"query","name":"accessible_by_id","schema":{"description":"ID of the user or group. Required if login is not provided.","type":"string"}},{"in":"query","name":"accessible_by_login","schema":{"description":"Email of the user to invite. Required if id is not provided.","type":"string"}},{"in":"query","name":"role","schema":{"type":"string","description":"Role: 'editor', 'viewer', 'previewer', 'uploader', 'previewer uploader', 'viewer uploader', 'co-owner'."}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"createdBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"accessibleBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"acknowledgedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"inviteEmail":{"anyOf":[{"type":"string"},{"type":"null"}]},"item":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/collaborations/{collaboration_id}":{"patch":{"operationId":"box.update_collaboration","description":"Update the role or status of an existing collaboration.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"collaboration_id","schema":{"type":"string","description":"The unique identifier of the collaboration."},"required":true,"description":"The unique identifier of the collaboration."},{"in":"query","name":"role","schema":{"description":"New role: 'editor', 'viewer', 'previewer', 'uploader', 'previewer uploader', 'viewer uploader', 'co-owner', 'owner'.","type":"string"}},{"in":"query","name":"status","schema":{"description":"New status: 'accepted' or 'rejected' (for pending invites).","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}},"delete":{"operationId":"box.remove_collaboration","description":"Remove a collaboration (revoke access) by its ID.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"collaboration_id","schema":{"type":"string","description":"The unique identifier of the collaboration to remove."},"required":true,"description":"The unique identifier of the collaboration to remove."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/files/{file_id}/shared-link":{"post":{"operationId":"box.add_shared_link_to_file","description":"Create or update a shared link on a file. Returns the file with the shared_link field populated.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the file."},"required":true,"description":"The unique identifier of the file."},{"in":"query","name":"access","schema":{"description":"Access level: 'open' (anyone with link), 'company' (enterprise only), or 'collaborators'.","type":"string"}},{"in":"query","name":"password","schema":{"description":"Password to protect the shared link.","type":"string"}},{"in":"query","name":"unshared_at","schema":{"description":"ISO 8601 date-time when the link expires.","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","const":"file"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"pathCollection":{"anyOf":[{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["totalCount","entries"],"additionalProperties":{}},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentCreatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentModifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"modifiedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"ownedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"sharedLink":{"anyOf":[{"type":"object","properties":{"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"downloadUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"vanityUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"vanityName":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectiveAccess":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectivePermission":{"anyOf":[{"type":"string"},{"type":"null"}]},"isPasswordEnabled":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"unsharedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"downloadCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"previewCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"access":{"anyOf":[{"type":"string"},{"type":"null"}]},"permissions":{"anyOf":[{"type":"object","properties":{"canDownload":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"canPreview":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"canEdit":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]}},"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"itemStatus":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequenceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]},"fileVersion":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"extension":{"anyOf":[{"type":"string"},{"type":"null"}]},"permissions":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"lock":{"anyOf":[{},{"type":"null"}]},"metadata":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}},"delete":{"operationId":"box.remove_shared_link_from_file","description":"Remove a shared link from a file.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the file."},"required":true,"description":"The unique identifier of the file."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/files/{file_id}/comments":{"get":{"operationId":"box.list_file_comments","description":"List all comments on a file.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the file."},"required":true,"description":"The unique identifier of the file."},{"in":"query","name":"limit","schema":{"description":"Maximum number of comments to return per page.","type":"number"}},{"in":"query","name":"offset","schema":{"description":"Offset for pagination (0-based).","type":"number"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"message":{"anyOf":[{"type":"string"},{"type":"null"}]},"taggedMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"isReplyComment":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"item":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"offset":{"anyOf":[{"type":"number"},{"type":"null"}]},"limit":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["totalCount","entries"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/comments":{"post":{"operationId":"box.create_comment","description":"Add a comment to a file. Use tagged_message to @mention users with @[user_id:name] syntax.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"query","name":"file_id","schema":{"type":"string","description":"The ID of the file to comment on."}},{"in":"query","name":"message","schema":{"description":"The comment text. Use this for simple comments.","type":"string"}},{"in":"query","name":"tagged_message","schema":{"description":"Comment text with @mentions using @[user_id:name] syntax. Use instead of message when mentioning users.","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"message":{"anyOf":[{"type":"string"},{"type":"null"}]},"taggedMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"isReplyComment":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"item":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/comments/{comment_id}":{"delete":{"operationId":"box.delete_comment","description":"Permanently delete a comment by its ID.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"comment_id","schema":{"type":"string","description":"The unique identifier of the comment to delete."},"required":true,"description":"The unique identifier of the comment to delete."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/files/{file_id}/tasks":{"get":{"operationId":"box.list_file_tasks","description":"List all tasks on a file.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the file."},"required":true,"description":"The unique identifier of the file."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"item":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"dueAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"action":{"anyOf":[{"type":"string"},{"type":"null"}]},"message":{"anyOf":[{"type":"string"},{"type":"null"}]},"taskAssignmentCollection":{"anyOf":[{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{}}},"required":["totalCount","entries"],"additionalProperties":{}},{"type":"null"}]},"isCompleted":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"completionRule":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"offset":{"anyOf":[{"type":"number"},{"type":"null"}]},"limit":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["totalCount","entries"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/tasks":{"post":{"operationId":"box.create_task","description":"Create a task on a file. The task will need to be assigned separately using create_task_assignment.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"query","name":"file_id","schema":{"type":"string","description":"The ID of the file to create a task on."}},{"in":"query","name":"message","schema":{"description":"An optional message/description for the task.","type":"string"}},{"in":"query","name":"action","schema":{"description":"Task action: 'review' (approval task) or 'complete' (general task). Defaults to 'review'.","type":"string"}},{"in":"query","name":"due_at","schema":{"description":"Due date in ISO 8601 format (e.g. '2024-12-31T23:59:59Z').","type":"string"}},{"in":"query","name":"completion_rule","schema":{"description":"Completion rule: 'all_assignees' (default) or 'any_assignee'.","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"item":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"dueAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"action":{"anyOf":[{"type":"string"},{"type":"null"}]},"message":{"anyOf":[{"type":"string"},{"type":"null"}]},"taskAssignmentCollection":{"anyOf":[{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{}}},"required":["totalCount","entries"],"additionalProperties":{}},{"type":"null"}]},"isCompleted":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"completionRule":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/task-assignments":{"post":{"operationId":"box.create_task_assignment","description":"Assign a task to a user by user ID or email address.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"query","name":"task_id","schema":{"type":"string","description":"The ID of the task to assign."}},{"in":"query","name":"user_id","schema":{"description":"The ID of the user to assign. Provide either user_id or login.","type":"string"}},{"in":"query","name":"login","schema":{"description":"The email of the user to assign. Provide either user_id or login.","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"item":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"assignedTo":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"message":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"assignedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"remindedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"resolutionState":{"anyOf":[{"type":"string"},{"type":"null"}]},"assignedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/task-assignments/{task_assignment_id}":{"patch":{"operationId":"box.update_task_assignment","description":"Update a task assignment's resolution state (e.g., mark as completed, approved, or rejected).","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"task_assignment_id","schema":{"type":"string","description":"The unique identifier of the task assignment."},"required":true,"description":"The unique identifier of the task assignment."},{"in":"query","name":"message","schema":{"description":"An optional message from the assignee.","type":"string"}},{"in":"query","name":"resolution_state","schema":{"description":"Resolution state: 'completed', 'incomplete', 'approved', or 'rejected'.","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/tasks/{task_id}/assignments":{"get":{"operationId":"box.list_task_assignments","description":"List all assignments for a task.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"task_id","schema":{"type":"string","description":"The unique identifier of the task."},"required":true,"description":"The unique identifier of the task."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"totalCount":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"item":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"assignedTo":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"message":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"assignedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"remindedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"resolutionState":{"anyOf":[{"type":"string"},{"type":"null"}]},"assignedBy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"offset":{"anyOf":[{"type":"number"},{"type":"null"}]},"limit":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["totalCount","entries"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/files/{file_id}/metadata":{"get":{"operationId":"box.list_file_metadata","description":"List all metadata instances applied to a file.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the file."},"required":true,"description":"The unique identifier of the file."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"entries":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"limit":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["entries"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/files/{file_id}/metadata/{scope}/{template_key}":{"get":{"operationId":"box.get_file_metadata","description":"Get a specific metadata instance on a file by scope and template key.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the file."},"required":true,"description":"The unique identifier of the file."},{"in":"path","name":"scope","schema":{"type":"string","description":"Metadata scope: 'global' or 'enterprise' (e.g. 'enterprise_12345')."},"required":true,"description":"Metadata scope: 'global' or 'enterprise' (e.g. 'enterprise_12345')."},{"in":"path","name":"template_key","schema":{"type":"string","description":"The key of the metadata template (e.g. 'contractTemplate')."},"required":true,"description":"The key of the metadata template (e.g. 'contractTemplate')."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}},"post":{"operationId":"box.create_file_metadata","description":"Apply a metadata template instance to a file with the given key-value pairs.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the file."},"required":true,"description":"The unique identifier of the file."},{"in":"path","name":"scope","schema":{"type":"string","description":"Metadata scope: 'global' or 'enterprise' (e.g. 'enterprise_12345')."},"required":true,"description":"Metadata scope: 'global' or 'enterprise' (e.g. 'enterprise_12345')."},{"in":"path","name":"template_key","schema":{"type":"string","description":"The key of the metadata template."},"required":true,"description":"The key of the metadata template."},{"in":"query","name":"data","schema":{"description":"Key-value pairs for the metadata instance. Example: { \"category\": \"contract\", \"amount\": 100 }."}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}},"delete":{"operationId":"box.delete_file_metadata","description":"Remove a metadata instance from a file by scope and template key.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the file."},"required":true,"description":"The unique identifier of the file."},{"in":"path","name":"scope","schema":{"type":"string","description":"Metadata scope: 'global' or 'enterprise'."},"required":true,"description":"Metadata scope: 'global' or 'enterprise'."},{"in":"path","name":"template_key","schema":{"type":"string","description":"The key of the metadata template to remove."},"required":true,"description":"The key of the metadata template to remove."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/users/me":{"get":{"operationId":"box.get_current_user","description":"Get the user profile for the currently authenticated user, including storage usage and role.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"modifiedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}]},"spaceAmount":{"anyOf":[{"type":"number"},{"type":"null"}]},"spaceUsed":{"anyOf":[{"type":"number"},{"type":"null"}]},"maxUploadSize":{"anyOf":[{"type":"number"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"jobTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"address":{"anyOf":[{"type":"string"},{"type":"null"}]},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/trash/files/{file_id}":{"get":{"operationId":"box.get_trashed_file","description":"Get details of a file that has been moved to the trash.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the trashed file."},"required":true,"description":"The unique identifier of the trashed file."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/trash/files/{file_id}/restore":{"post":{"operationId":"box.restore_file_from_trash","description":"Restore a file from the trash. Optionally provide a new parent folder if the original was deleted.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"path","name":"file_id","schema":{"type":"string","description":"The unique identifier of the trashed file to restore."},"required":true,"description":"The unique identifier of the trashed file to restore."},{"in":"query","name":"name","schema":{"description":"Optional new name for the restored file.","type":"string"}},{"in":"query","name":"parent_id","schema":{"description":"Optional ID of the folder to restore into (if the original parent was deleted).","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}},"/api/v1/box/shared-link-items":{"post":{"operationId":"box.get_shared_link_item","description":"Resolve a shared link URL to the underlying file it points to. Returns the full file details for the shared resource.","tags":["box"],"security":[{"oauth2":[]},{"bearerApiKey":[]}],"parameters":[{"in":"query","name":"shared_link","schema":{"type":"string","description":"The full shared link URL (e.g. 'https://app.box.com/s/...')"}},{"in":"query","name":"shared_link_password","schema":{"description":"Password for the shared link, if it is password-protected.","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Request body parameters"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}},"502":{"description":"Upstream error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"boolean"},"code":{"type":"string"},"message":{"type":"string"}},"required":["error","code","message"],"additionalProperties":false}}}}}}}},"webhooks":{"box.file.uploaded":{"post":{"operationId":"onBoxFileUploaded","summary":"box webhook: box.file.uploaded","description":"Fires when a file is uploaded to a watched folder or moved into it. Webhook must be placed on the parent folder.","tags":["box:webhooks"],"x-ferrule-provider-trigger":"FILE.UPLOADED","parameters":[{"name":"Ferrule-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"UUIDv7 event id, stable across retries."},{"name":"Ferrule-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]+$"},"description":"Unix seconds when this attempt was signed (regenerated per attempt)."},{"name":"Ferrule-Signature","in":"header","required":true,"schema":{"type":"string"},"description":"HMAC-SHA-256 signature, e.g. `t=...,v1=<hex>`; during rotation also carries `v1a=<hex>`."},{"name":"Ferrule-Attempt","in":"header","required":false,"schema":{"type":"integer","minimum":1},"description":"1-based attempt counter. Informational — subscribers must not condition correctness on it."}],"requestBody":{"description":"Ferrule-signed event envelope.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FerruleWebhookEnvelope_box_file_uploaded"}}}},"responses":{"200":{"description":"Subscriber acknowledged receipt. Ferrule marks the attempt delivered on any 2xx within 30 seconds."},"410":{"description":"Permanent teardown — Ferrule hard-pauses the destination on the first 410 response."}}}},"box.file.deleted":{"post":{"operationId":"onBoxFileDeleted","summary":"box webhook: box.file.deleted","description":"Fires when a file is permanently deleted (purged from trash). Distinct from FILE.TRASHED — the file is no longer recoverable.","tags":["box:webhooks"],"x-ferrule-provider-trigger":"FILE.DELETED","parameters":[{"name":"Ferrule-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"UUIDv7 event id, stable across retries."},{"name":"Ferrule-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]+$"},"description":"Unix seconds when this attempt was signed (regenerated per attempt)."},{"name":"Ferrule-Signature","in":"header","required":true,"schema":{"type":"string"},"description":"HMAC-SHA-256 signature, e.g. `t=...,v1=<hex>`; during rotation also carries `v1a=<hex>`."},{"name":"Ferrule-Attempt","in":"header","required":false,"schema":{"type":"integer","minimum":1},"description":"1-based attempt counter. Informational — subscribers must not condition correctness on it."}],"requestBody":{"description":"Ferrule-signed event envelope.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FerruleWebhookEnvelope_box_file_deleted"}}}},"responses":{"200":{"description":"Subscriber acknowledged receipt. Ferrule marks the attempt delivered on any 2xx within 30 seconds."},"410":{"description":"Permanent teardown — Ferrule hard-pauses the destination on the first 410 response."}}}},"box.file.trashed":{"post":{"operationId":"onBoxFileTrashed","summary":"box webhook: box.file.trashed","description":"Fires when a file is moved to the trash (soft delete). The file is still recoverable until permanently deleted.","tags":["box:webhooks"],"x-ferrule-provider-trigger":"FILE.TRASHED","parameters":[{"name":"Ferrule-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"UUIDv7 event id, stable across retries."},{"name":"Ferrule-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]+$"},"description":"Unix seconds when this attempt was signed (regenerated per attempt)."},{"name":"Ferrule-Signature","in":"header","required":true,"schema":{"type":"string"},"description":"HMAC-SHA-256 signature, e.g. `t=...,v1=<hex>`; during rotation also carries `v1a=<hex>`."},{"name":"Ferrule-Attempt","in":"header","required":false,"schema":{"type":"integer","minimum":1},"description":"1-based attempt counter. Informational — subscribers must not condition correctness on it."}],"requestBody":{"description":"Ferrule-signed event envelope.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FerruleWebhookEnvelope_box_file_trashed"}}}},"responses":{"200":{"description":"Subscriber acknowledged receipt. Ferrule marks the attempt delivered on any 2xx within 30 seconds."},"410":{"description":"Permanent teardown — Ferrule hard-pauses the destination on the first 410 response."}}}},"box.file.restored":{"post":{"operationId":"onBoxFileRestored","summary":"box webhook: box.file.restored","description":"Fires when a file is restored from the trash back to its original location. Paired with FILE.TRASHED for complete soft-delete lifecycle coverage.","tags":["box:webhooks"],"x-ferrule-provider-trigger":"FILE.RESTORED","parameters":[{"name":"Ferrule-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"UUIDv7 event id, stable across retries."},{"name":"Ferrule-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]+$"},"description":"Unix seconds when this attempt was signed (regenerated per attempt)."},{"name":"Ferrule-Signature","in":"header","required":true,"schema":{"type":"string"},"description":"HMAC-SHA-256 signature, e.g. `t=...,v1=<hex>`; during rotation also carries `v1a=<hex>`."},{"name":"Ferrule-Attempt","in":"header","required":false,"schema":{"type":"integer","minimum":1},"description":"1-based attempt counter. Informational — subscribers must not condition correctness on it."}],"requestBody":{"description":"Ferrule-signed event envelope.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FerruleWebhookEnvelope_box_file_restored"}}}},"responses":{"200":{"description":"Subscriber acknowledged receipt. Ferrule marks the attempt delivered on any 2xx within 30 seconds."},"410":{"description":"Permanent teardown — Ferrule hard-pauses the destination on the first 410 response."}}}},"box.file.copied":{"post":{"operationId":"onBoxFileCopied","summary":"box webhook: box.file.copied","description":"Fires when a file is copied. The source object represents the new copy. Webhook on the destination folder fires FILE.UPLOADED; webhook on the original folder does not fire for copies.","tags":["box:webhooks"],"x-ferrule-provider-trigger":"FILE.COPIED","parameters":[{"name":"Ferrule-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"UUIDv7 event id, stable across retries."},{"name":"Ferrule-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]+$"},"description":"Unix seconds when this attempt was signed (regenerated per attempt)."},{"name":"Ferrule-Signature","in":"header","required":true,"schema":{"type":"string"},"description":"HMAC-SHA-256 signature, e.g. `t=...,v1=<hex>`; during rotation also carries `v1a=<hex>`."},{"name":"Ferrule-Attempt","in":"header","required":false,"schema":{"type":"integer","minimum":1},"description":"1-based attempt counter. Informational — subscribers must not condition correctness on it."}],"requestBody":{"description":"Ferrule-signed event envelope.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FerruleWebhookEnvelope_box_file_copied"}}}},"responses":{"200":{"description":"Subscriber acknowledged receipt. Ferrule marks the attempt delivered on any 2xx within 30 seconds."},"410":{"description":"Permanent teardown — Ferrule hard-pauses the destination on the first 410 response."}}}},"box.file.moved":{"post":{"operationId":"onBoxFileMoved","summary":"box webhook: box.file.moved","description":"Fires when a file is moved between folders. Source reflects the file at its new location. The destination folder also fires FILE.UPLOADED.","tags":["box:webhooks"],"x-ferrule-provider-trigger":"FILE.MOVED","parameters":[{"name":"Ferrule-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"UUIDv7 event id, stable across retries."},{"name":"Ferrule-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]+$"},"description":"Unix seconds when this attempt was signed (regenerated per attempt)."},{"name":"Ferrule-Signature","in":"header","required":true,"schema":{"type":"string"},"description":"HMAC-SHA-256 signature, e.g. `t=...,v1=<hex>`; during rotation also carries `v1a=<hex>`."},{"name":"Ferrule-Attempt","in":"header","required":false,"schema":{"type":"integer","minimum":1},"description":"1-based attempt counter. Informational — subscribers must not condition correctness on it."}],"requestBody":{"description":"Ferrule-signed event envelope.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FerruleWebhookEnvelope_box_file_moved"}}}},"responses":{"200":{"description":"Subscriber acknowledged receipt. Ferrule marks the attempt delivered on any 2xx within 30 seconds."},"410":{"description":"Permanent teardown — Ferrule hard-pauses the destination on the first 410 response."}}}},"box.folder.created":{"post":{"operationId":"onBoxFolderCreated","summary":"box webhook: box.folder.created","description":"Fires when a new subfolder is created inside a watched folder. Webhook must be placed on the parent folder.","tags":["box:webhooks"],"x-ferrule-provider-trigger":"FOLDER.CREATED","parameters":[{"name":"Ferrule-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"UUIDv7 event id, stable across retries."},{"name":"Ferrule-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]+$"},"description":"Unix seconds when this attempt was signed (regenerated per attempt)."},{"name":"Ferrule-Signature","in":"header","required":true,"schema":{"type":"string"},"description":"HMAC-SHA-256 signature, e.g. `t=...,v1=<hex>`; during rotation also carries `v1a=<hex>`."},{"name":"Ferrule-Attempt","in":"header","required":false,"schema":{"type":"integer","minimum":1},"description":"1-based attempt counter. Informational — subscribers must not condition correctness on it."}],"requestBody":{"description":"Ferrule-signed event envelope.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FerruleWebhookEnvelope_box_folder_created"}}}},"responses":{"200":{"description":"Subscriber acknowledged receipt. Ferrule marks the attempt delivered on any 2xx within 30 seconds."},"410":{"description":"Permanent teardown — Ferrule hard-pauses the destination on the first 410 response."}}}},"box.folder.deleted":{"post":{"operationId":"onBoxFolderDeleted","summary":"box webhook: box.folder.deleted","description":"Fires when a folder is permanently deleted (purged from trash). Distinct from FOLDER.TRASHED.","tags":["box:webhooks"],"x-ferrule-provider-trigger":"FOLDER.DELETED","parameters":[{"name":"Ferrule-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"UUIDv7 event id, stable across retries."},{"name":"Ferrule-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]+$"},"description":"Unix seconds when this attempt was signed (regenerated per attempt)."},{"name":"Ferrule-Signature","in":"header","required":true,"schema":{"type":"string"},"description":"HMAC-SHA-256 signature, e.g. `t=...,v1=<hex>`; during rotation also carries `v1a=<hex>`."},{"name":"Ferrule-Attempt","in":"header","required":false,"schema":{"type":"integer","minimum":1},"description":"1-based attempt counter. Informational — subscribers must not condition correctness on it."}],"requestBody":{"description":"Ferrule-signed event envelope.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FerruleWebhookEnvelope_box_folder_deleted"}}}},"responses":{"200":{"description":"Subscriber acknowledged receipt. Ferrule marks the attempt delivered on any 2xx within 30 seconds."},"410":{"description":"Permanent teardown — Ferrule hard-pauses the destination on the first 410 response."}}}},"box.folder.copied":{"post":{"operationId":"onBoxFolderCopied","summary":"box webhook: box.folder.copied","description":"Fires when a folder is copied. The source object represents the new copy. Useful for detecting when folder structures are duplicated.","tags":["box:webhooks"],"x-ferrule-provider-trigger":"FOLDER.COPIED","parameters":[{"name":"Ferrule-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"UUIDv7 event id, stable across retries."},{"name":"Ferrule-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]+$"},"description":"Unix seconds when this attempt was signed (regenerated per attempt)."},{"name":"Ferrule-Signature","in":"header","required":true,"schema":{"type":"string"},"description":"HMAC-SHA-256 signature, e.g. `t=...,v1=<hex>`; during rotation also carries `v1a=<hex>`."},{"name":"Ferrule-Attempt","in":"header","required":false,"schema":{"type":"integer","minimum":1},"description":"1-based attempt counter. Informational — subscribers must not condition correctness on it."}],"requestBody":{"description":"Ferrule-signed event envelope.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FerruleWebhookEnvelope_box_folder_copied"}}}},"responses":{"200":{"description":"Subscriber acknowledged receipt. Ferrule marks the attempt delivered on any 2xx within 30 seconds."},"410":{"description":"Permanent teardown — Ferrule hard-pauses the destination on the first 410 response."}}}},"box.folder.moved":{"post":{"operationId":"onBoxFolderMoved","summary":"box webhook: box.folder.moved","description":"Fires when a folder is moved from one parent to another. The parent field in source reflects the folder's new location.","tags":["box:webhooks"],"x-ferrule-provider-trigger":"FOLDER.MOVED","parameters":[{"name":"Ferrule-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"UUIDv7 event id, stable across retries."},{"name":"Ferrule-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]+$"},"description":"Unix seconds when this attempt was signed (regenerated per attempt)."},{"name":"Ferrule-Signature","in":"header","required":true,"schema":{"type":"string"},"description":"HMAC-SHA-256 signature, e.g. `t=...,v1=<hex>`; during rotation also carries `v1a=<hex>`."},{"name":"Ferrule-Attempt","in":"header","required":false,"schema":{"type":"integer","minimum":1},"description":"1-based attempt counter. Informational — subscribers must not condition correctness on it."}],"requestBody":{"description":"Ferrule-signed event envelope.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FerruleWebhookEnvelope_box_folder_moved"}}}},"responses":{"200":{"description":"Subscriber acknowledged receipt. Ferrule marks the attempt delivered on any 2xx within 30 seconds."},"410":{"description":"Permanent teardown — Ferrule hard-pauses the destination on the first 410 response."}}}},"box.collaboration.created":{"post":{"operationId":"onBoxCollaborationCreated","summary":"box webhook: box.collaboration.created","description":"Fires when a user or group is granted access to a watched folder via a collaboration. Validates the subscription surface for non-file entities.","tags":["box:webhooks"],"x-ferrule-provider-trigger":"COLLABORATION.CREATED","parameters":[{"name":"Ferrule-Event-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"UUIDv7 event id, stable across retries."},{"name":"Ferrule-Timestamp","in":"header","required":true,"schema":{"type":"string","pattern":"^[0-9]+$"},"description":"Unix seconds when this attempt was signed (regenerated per attempt)."},{"name":"Ferrule-Signature","in":"header","required":true,"schema":{"type":"string"},"description":"HMAC-SHA-256 signature, e.g. `t=...,v1=<hex>`; during rotation also carries `v1a=<hex>`."},{"name":"Ferrule-Attempt","in":"header","required":false,"schema":{"type":"integer","minimum":1},"description":"1-based attempt counter. Informational — subscribers must not condition correctness on it."}],"requestBody":{"description":"Ferrule-signed event envelope.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FerruleWebhookEnvelope_box_collaboration_created"}}}},"responses":{"200":{"description":"Subscriber acknowledged receipt. Ferrule marks the attempt delivered on any 2xx within 30 seconds."},"410":{"description":"Permanent teardown — Ferrule hard-pauses the destination on the first 410 response."}}}}},"components":{"schemas":{"FerruleWebhookEnvelope_box_file_uploaded":{"type":"object","properties":{"id":{"type":"string","description":"UUIDv7. Equals the `Ferrule-Event-Id` header and is stable across retries."},"type":{"type":"string","const":"box.file.uploaded","description":"Ferrule canonical event type."},"created":{"type":"string","description":"ISO-8601 timestamp of the originating event."},"integration_type":{"type":"string","const":"box","description":"Ferrule integration type that produced the event (matches `ServiceType`)."},"organization_id":{"type":"string","description":"Ferrule organization that owns the source integration."},"source_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Provider-native event identifier. `null` when the provider did not supply one."},"data":{"type":"object","properties":{"type":{"type":"string","const":"webhook_event"},"id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trigger":{"type":"string","const":"FILE.UPLOADED"},"webhook":{"type":"object","properties":{"id":{"type":"string"},"type":{"anyOf":[{"type":"string","const":"webhook"},{"type":"null"}]}},"required":["id"],"additionalProperties":{}},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"source":{"type":"object","properties":{"type":{"type":"string","const":"file"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"file_version":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"path_collection":{"anyOf":[{"type":"object","properties":{"total_count":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["total_count","entries"],"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"modified_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trashed_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"owned_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"item_status":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"required":["type","id","trigger","webhook","source"],"additionalProperties":{},"description":"Provider payload for `box.file.uploaded`."}},"required":["id","type","created","integration_type","organization_id","source_event_id","data"],"description":"Ferrule-wrapped envelope for `box.file.uploaded`."},"FerruleWebhookEnvelope_box_file_deleted":{"type":"object","properties":{"id":{"type":"string","description":"UUIDv7. Equals the `Ferrule-Event-Id` header and is stable across retries."},"type":{"type":"string","const":"box.file.deleted","description":"Ferrule canonical event type."},"created":{"type":"string","description":"ISO-8601 timestamp of the originating event."},"integration_type":{"type":"string","const":"box","description":"Ferrule integration type that produced the event (matches `ServiceType`)."},"organization_id":{"type":"string","description":"Ferrule organization that owns the source integration."},"source_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Provider-native event identifier. `null` when the provider did not supply one."},"data":{"type":"object","properties":{"type":{"type":"string","const":"webhook_event"},"id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trigger":{"type":"string","const":"FILE.DELETED"},"webhook":{"type":"object","properties":{"id":{"type":"string"},"type":{"anyOf":[{"type":"string","const":"webhook"},{"type":"null"}]}},"required":["id"],"additionalProperties":{}},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"source":{"type":"object","properties":{"type":{"type":"string","const":"file"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"file_version":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"path_collection":{"anyOf":[{"type":"object","properties":{"total_count":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["total_count","entries"],"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"modified_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trashed_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"owned_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"item_status":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"required":["type","id","trigger","webhook","source"],"additionalProperties":{},"description":"Provider payload for `box.file.deleted`."}},"required":["id","type","created","integration_type","organization_id","source_event_id","data"],"description":"Ferrule-wrapped envelope for `box.file.deleted`."},"FerruleWebhookEnvelope_box_file_trashed":{"type":"object","properties":{"id":{"type":"string","description":"UUIDv7. Equals the `Ferrule-Event-Id` header and is stable across retries."},"type":{"type":"string","const":"box.file.trashed","description":"Ferrule canonical event type."},"created":{"type":"string","description":"ISO-8601 timestamp of the originating event."},"integration_type":{"type":"string","const":"box","description":"Ferrule integration type that produced the event (matches `ServiceType`)."},"organization_id":{"type":"string","description":"Ferrule organization that owns the source integration."},"source_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Provider-native event identifier. `null` when the provider did not supply one."},"data":{"type":"object","properties":{"type":{"type":"string","const":"webhook_event"},"id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trigger":{"type":"string","const":"FILE.TRASHED"},"webhook":{"type":"object","properties":{"id":{"type":"string"},"type":{"anyOf":[{"type":"string","const":"webhook"},{"type":"null"}]}},"required":["id"],"additionalProperties":{}},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"source":{"type":"object","properties":{"type":{"type":"string","const":"file"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"file_version":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"path_collection":{"anyOf":[{"type":"object","properties":{"total_count":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["total_count","entries"],"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"modified_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trashed_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"owned_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"item_status":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"required":["type","id","trigger","webhook","source"],"additionalProperties":{},"description":"Provider payload for `box.file.trashed`."}},"required":["id","type","created","integration_type","organization_id","source_event_id","data"],"description":"Ferrule-wrapped envelope for `box.file.trashed`."},"FerruleWebhookEnvelope_box_file_restored":{"type":"object","properties":{"id":{"type":"string","description":"UUIDv7. Equals the `Ferrule-Event-Id` header and is stable across retries."},"type":{"type":"string","const":"box.file.restored","description":"Ferrule canonical event type."},"created":{"type":"string","description":"ISO-8601 timestamp of the originating event."},"integration_type":{"type":"string","const":"box","description":"Ferrule integration type that produced the event (matches `ServiceType`)."},"organization_id":{"type":"string","description":"Ferrule organization that owns the source integration."},"source_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Provider-native event identifier. `null` when the provider did not supply one."},"data":{"type":"object","properties":{"type":{"type":"string","const":"webhook_event"},"id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trigger":{"type":"string","const":"FILE.RESTORED"},"webhook":{"type":"object","properties":{"id":{"type":"string"},"type":{"anyOf":[{"type":"string","const":"webhook"},{"type":"null"}]}},"required":["id"],"additionalProperties":{}},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"source":{"type":"object","properties":{"type":{"type":"string","const":"file"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"file_version":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"path_collection":{"anyOf":[{"type":"object","properties":{"total_count":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["total_count","entries"],"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"modified_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trashed_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"owned_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"item_status":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"required":["type","id","trigger","webhook","source"],"additionalProperties":{},"description":"Provider payload for `box.file.restored`."}},"required":["id","type","created","integration_type","organization_id","source_event_id","data"],"description":"Ferrule-wrapped envelope for `box.file.restored`."},"FerruleWebhookEnvelope_box_file_copied":{"type":"object","properties":{"id":{"type":"string","description":"UUIDv7. Equals the `Ferrule-Event-Id` header and is stable across retries."},"type":{"type":"string","const":"box.file.copied","description":"Ferrule canonical event type."},"created":{"type":"string","description":"ISO-8601 timestamp of the originating event."},"integration_type":{"type":"string","const":"box","description":"Ferrule integration type that produced the event (matches `ServiceType`)."},"organization_id":{"type":"string","description":"Ferrule organization that owns the source integration."},"source_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Provider-native event identifier. `null` when the provider did not supply one."},"data":{"type":"object","properties":{"type":{"type":"string","const":"webhook_event"},"id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trigger":{"type":"string","const":"FILE.COPIED"},"webhook":{"type":"object","properties":{"id":{"type":"string"},"type":{"anyOf":[{"type":"string","const":"webhook"},{"type":"null"}]}},"required":["id"],"additionalProperties":{}},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"source":{"type":"object","properties":{"type":{"type":"string","const":"file"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"file_version":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"path_collection":{"anyOf":[{"type":"object","properties":{"total_count":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["total_count","entries"],"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"modified_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trashed_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"owned_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"item_status":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"required":["type","id","trigger","webhook","source"],"additionalProperties":{},"description":"Provider payload for `box.file.copied`."}},"required":["id","type","created","integration_type","organization_id","source_event_id","data"],"description":"Ferrule-wrapped envelope for `box.file.copied`."},"FerruleWebhookEnvelope_box_file_moved":{"type":"object","properties":{"id":{"type":"string","description":"UUIDv7. Equals the `Ferrule-Event-Id` header and is stable across retries."},"type":{"type":"string","const":"box.file.moved","description":"Ferrule canonical event type."},"created":{"type":"string","description":"ISO-8601 timestamp of the originating event."},"integration_type":{"type":"string","const":"box","description":"Ferrule integration type that produced the event (matches `ServiceType`)."},"organization_id":{"type":"string","description":"Ferrule organization that owns the source integration."},"source_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Provider-native event identifier. `null` when the provider did not supply one."},"data":{"type":"object","properties":{"type":{"type":"string","const":"webhook_event"},"id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trigger":{"type":"string","const":"FILE.MOVED"},"webhook":{"type":"object","properties":{"id":{"type":"string"},"type":{"anyOf":[{"type":"string","const":"webhook"},{"type":"null"}]}},"required":["id"],"additionalProperties":{}},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"source":{"type":"object","properties":{"type":{"type":"string","const":"file"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"file_version":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"sha1":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"path_collection":{"anyOf":[{"type":"object","properties":{"total_count":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["total_count","entries"],"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"modified_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trashed_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"owned_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"item_status":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"required":["type","id","trigger","webhook","source"],"additionalProperties":{},"description":"Provider payload for `box.file.moved`."}},"required":["id","type","created","integration_type","organization_id","source_event_id","data"],"description":"Ferrule-wrapped envelope for `box.file.moved`."},"FerruleWebhookEnvelope_box_folder_created":{"type":"object","properties":{"id":{"type":"string","description":"UUIDv7. Equals the `Ferrule-Event-Id` header and is stable across retries."},"type":{"type":"string","const":"box.folder.created","description":"Ferrule canonical event type."},"created":{"type":"string","description":"ISO-8601 timestamp of the originating event."},"integration_type":{"type":"string","const":"box","description":"Ferrule integration type that produced the event (matches `ServiceType`)."},"organization_id":{"type":"string","description":"Ferrule organization that owns the source integration."},"source_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Provider-native event identifier. `null` when the provider did not supply one."},"data":{"type":"object","properties":{"type":{"type":"string","const":"webhook_event"},"id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trigger":{"type":"string","const":"FOLDER.CREATED"},"webhook":{"type":"object","properties":{"id":{"type":"string"},"type":{"anyOf":[{"type":"string","const":"webhook"},{"type":"null"}]}},"required":["id"],"additionalProperties":{}},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"source":{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"path_collection":{"anyOf":[{"type":"object","properties":{"total_count":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["total_count","entries"],"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"modified_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"owned_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"item_status":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"required":["type","id","trigger","webhook","source"],"additionalProperties":{},"description":"Provider payload for `box.folder.created`."}},"required":["id","type","created","integration_type","organization_id","source_event_id","data"],"description":"Ferrule-wrapped envelope for `box.folder.created`."},"FerruleWebhookEnvelope_box_folder_deleted":{"type":"object","properties":{"id":{"type":"string","description":"UUIDv7. Equals the `Ferrule-Event-Id` header and is stable across retries."},"type":{"type":"string","const":"box.folder.deleted","description":"Ferrule canonical event type."},"created":{"type":"string","description":"ISO-8601 timestamp of the originating event."},"integration_type":{"type":"string","const":"box","description":"Ferrule integration type that produced the event (matches `ServiceType`)."},"organization_id":{"type":"string","description":"Ferrule organization that owns the source integration."},"source_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Provider-native event identifier. `null` when the provider did not supply one."},"data":{"type":"object","properties":{"type":{"type":"string","const":"webhook_event"},"id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trigger":{"type":"string","const":"FOLDER.DELETED"},"webhook":{"type":"object","properties":{"id":{"type":"string"},"type":{"anyOf":[{"type":"string","const":"webhook"},{"type":"null"}]}},"required":["id"],"additionalProperties":{}},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"source":{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"path_collection":{"anyOf":[{"type":"object","properties":{"total_count":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["total_count","entries"],"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"modified_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"owned_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"item_status":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"required":["type","id","trigger","webhook","source"],"additionalProperties":{},"description":"Provider payload for `box.folder.deleted`."}},"required":["id","type","created","integration_type","organization_id","source_event_id","data"],"description":"Ferrule-wrapped envelope for `box.folder.deleted`."},"FerruleWebhookEnvelope_box_folder_copied":{"type":"object","properties":{"id":{"type":"string","description":"UUIDv7. Equals the `Ferrule-Event-Id` header and is stable across retries."},"type":{"type":"string","const":"box.folder.copied","description":"Ferrule canonical event type."},"created":{"type":"string","description":"ISO-8601 timestamp of the originating event."},"integration_type":{"type":"string","const":"box","description":"Ferrule integration type that produced the event (matches `ServiceType`)."},"organization_id":{"type":"string","description":"Ferrule organization that owns the source integration."},"source_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Provider-native event identifier. `null` when the provider did not supply one."},"data":{"type":"object","properties":{"type":{"type":"string","const":"webhook_event"},"id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trigger":{"type":"string","const":"FOLDER.COPIED"},"webhook":{"type":"object","properties":{"id":{"type":"string"},"type":{"anyOf":[{"type":"string","const":"webhook"},{"type":"null"}]}},"required":["id"],"additionalProperties":{}},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"source":{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"path_collection":{"anyOf":[{"type":"object","properties":{"total_count":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["total_count","entries"],"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"modified_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"owned_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"item_status":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"required":["type","id","trigger","webhook","source"],"additionalProperties":{},"description":"Provider payload for `box.folder.copied`."}},"required":["id","type","created","integration_type","organization_id","source_event_id","data"],"description":"Ferrule-wrapped envelope for `box.folder.copied`."},"FerruleWebhookEnvelope_box_folder_moved":{"type":"object","properties":{"id":{"type":"string","description":"UUIDv7. Equals the `Ferrule-Event-Id` header and is stable across retries."},"type":{"type":"string","const":"box.folder.moved","description":"Ferrule canonical event type."},"created":{"type":"string","description":"ISO-8601 timestamp of the originating event."},"integration_type":{"type":"string","const":"box","description":"Ferrule integration type that produced the event (matches `ServiceType`)."},"organization_id":{"type":"string","description":"Ferrule organization that owns the source integration."},"source_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Provider-native event identifier. `null` when the provider did not supply one."},"data":{"type":"object","properties":{"type":{"type":"string","const":"webhook_event"},"id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trigger":{"type":"string","const":"FOLDER.MOVED"},"webhook":{"type":"object","properties":{"id":{"type":"string"},"type":{"anyOf":[{"type":"string","const":"webhook"},{"type":"null"}]}},"required":["id"],"additionalProperties":{}},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"source":{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]},"path_collection":{"anyOf":[{"type":"object","properties":{"total_count":{"type":"number"},"entries":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}}},"required":["total_count","entries"],"additionalProperties":{}},{"type":"null"}]},"parent":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"modified_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"owned_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"item_status":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"required":["type","id","trigger","webhook","source"],"additionalProperties":{},"description":"Provider payload for `box.folder.moved`."}},"required":["id","type","created","integration_type","organization_id","source_event_id","data"],"description":"Ferrule-wrapped envelope for `box.folder.moved`."},"FerruleWebhookEnvelope_box_collaboration_created":{"type":"object","properties":{"id":{"type":"string","description":"UUIDv7. Equals the `Ferrule-Event-Id` header and is stable across retries."},"type":{"type":"string","const":"box.collaboration.created","description":"Ferrule canonical event type."},"created":{"type":"string","description":"ISO-8601 timestamp of the originating event."},"integration_type":{"type":"string","const":"box","description":"Ferrule integration type that produced the event (matches `ServiceType`)."},"organization_id":{"type":"string","description":"Ferrule organization that owns the source integration."},"source_event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Provider-native event identifier. `null` when the provider did not supply one."},"data":{"type":"object","properties":{"type":{"type":"string","const":"webhook_event"},"id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"trigger":{"type":"string","const":"COLLABORATION.CREATED"},"webhook":{"type":"object","properties":{"id":{"type":"string"},"type":{"anyOf":[{"type":"string","const":"webhook"},{"type":"null"}]}},"required":["id"],"additionalProperties":{}},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"source":{"type":"object","properties":{"type":{"type":"string","const":"collaboration"},"id":{"type":"string"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"modified_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"accessible_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"acknowledged_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"invite_email":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_by":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"login":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]},"item":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"folder"},"id":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"sequence_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"etag":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}},{"type":"null"}]}},"required":["type","id"],"additionalProperties":{}}},"required":["type","id","trigger","webhook","source"],"additionalProperties":{},"description":"Provider payload for `box.collaboration.created`."}},"required":["id","type","created","integration_type","organization_id","source_event_id","data"],"description":"Ferrule-wrapped envelope for `box.collaboration.created`."}},"securitySchemes":{"oauth2":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"/oauth/authorize","tokenUrl":"/oauth/token","scopes":{}}}},"bearerApiKey":{"type":"http","scheme":"bearer","description":"API key authentication. Pass a Ferrule API key as a Bearer token."}}}}