Box API breaking changes & specification history.
Files, folders, collaborations, and webhooks.
3 recorded releases · Last captured 28 Sept 2026.
Which Box API endpoints have captured breaking changes?
3 recorded releases; last specification capture . This dated snapshot contains 20 sampled findings from 3 recent releases, including 2 breaking findings. Up to ten findings are retained per release; these counts are not totals for the complete API history.
Snapshot retrieved . A capture date is not a provider deployment date. Missing or unmatched repository usage is not proof of safety.
| Classification | Sampled findings |
|---|---|
| Breaking | 2 |
| Non-breaking | 14 |
| Needs review | 4 |
| Deprecation | 0 |
| Pending classification | 0 |
| Operation | Field and rule | Capture |
|---|---|---|
POST /files/upload_sessions/{upload_session_id}/commit | allOfresponse.removed | |
GET /collaborations/{collaboration_id} | allOfresponse.removed |
Where does this evidence come from?
- Publisher specification
- Official specification source
- Configured SDK matching
- No SDK package listed in this snapshot
- API authentication
- none
- Publisher version
- 2024.0
Snapshot captured 3 Nov 2026. Breaking describes contract evidence; repository impact is a separate analysis.
Box captured release evidence
Dated snapshot: . Latest 3 captured releases, with up to ten findings per release. Contract findings describe specification changes; repository impact is a separate analysis.
Box API specification changes · Revision 1dff22a5 · GET /files/{file_id}#get_shared_link
GET /files/{file_id}#get_shared_link295 recorded findings · classified · Previous revision b0ecd541
Non-breaking: GET /files/{file_id}#get_shared_link
added `#/components/schemas/ParityDiffShared_0002937dd5750eebcfbdab1e9ea6f19669ffdb8f6922842ae97fc43a2baddaa2, #/components/schemas/ParityDiffShared_5f4215ef4aee455daea09b64004fd590ace2d4b967b0ed9d9c9b29b3aaf53111` to the response body `allOf` list for the response status `200`
Rule: level.info
Non-breaking: POST /retention_policies
added the non-success response with the status `403`
Rule: level.info
Needs review: PUT /files/{file_id}#update_shared_link
removed `#/components/schemas/ParityDiffShared_f24e2526992199f661afc9733f73bb825922b63b2c4f4f94edc4b6f000508d9a, #/components/schemas/ParityDiffShared_34748ca8b5eb5bcd78755f71dfd5bad2d363b8c2c67b6147904b96f647ff7f6f` from the response body `allOf` list for the response status `200`
Rule: level.warning
Needs review: GET /files/{file_id}/collaborations
removed `#/components/schemas/ParityDiffShared_4870f64c16b1d9ee39d4ebf95a04fb4c3ccb39a5a9b90761dfea47425bafb150` from the response body `allOf` list for the response status `200`
Rule: level.warning
Needs review: PUT /files/{file_id}
removed `#/components/schemas/ParityDiffShared_f24e2526992199f661afc9733f73bb825922b63b2c4f4f94edc4b6f000508d9a, #/components/schemas/ParityDiffShared_34748ca8b5eb5bcd78755f71dfd5bad2d363b8c2c67b6147904b96f647ff7f6f` from the response body `allOf` list for the response status `200`
Rule: level.warning
Non-breaking: GET /shared_items#web_links
added `#/components/schemas/ParityDiffShared_4a3ff36e327183be43cdc87cce5de2fd11ca7eb46fd4afa2caab29ec4db779e7` to the response body `allOf` list for the response status `200`
Rule: level.info
Needs review: GET /recent_items
removed `#/components/schemas/ParityDiffShared_b29e4374c7920c66568d405cd54713a98446d750e1de3598fbfac35b2f7ffce1` from the response body `allOf` list for the response status `200`
Rule: level.warning
Non-breaking: PUT /folders/{folder_id}
added `#/components/schemas/ParityDiffShared_e0a37f4adc2486e4c71188e979ba78698eae171a1f2c99c5fc81df8677b7bbd7` to the response body `allOf` list for the response status `200`
Rule: level.info
Breaking: POST /files/upload_sessions/{upload_session_id}/commit
removed `#/components/schemas/ParityDiffShared_f24e2526992199f661afc9733f73bb825922b63b2c4f4f94edc4b6f000508d9a, #/components/schemas/ParityDiffShared_34748ca8b5eb5bcd78755f71dfd5bad2d363b8c2c67b6147904b96f647ff7f6f` from the `entries/items/` response property `allOf` list for the response status `201`
Field: allOf
Rule: response.removed
Breaking: GET /collaborations/{collaboration_id}
removed `#/components/schemas/ParityDiffShared_2ff5bd9f118968f84c51298b6d1a04eb0ca11d43ceb36efe489f7acf085c31cc` from the `item` response property `allOf` list for the response status `200`
Field: allOf
Rule: response.removed
Showing the first ten findings. Open the release for the remaining changes.
Box API specification changes · Revision b0ecd541 · POST /files/upload_sessions
POST /files/upload_sessions4 recorded findings · classified · Previous revision b8b6db28
Non-breaking: POST /files/upload_sessions
added the optional property `session_endpoints/allOf[subschema #1: Session endpoints]/plan` to the response with the `201` status
Rule: response.added
Non-breaking: GET /files/upload_sessions/{upload_session_id}
added the optional property `session_endpoints/allOf[subschema #1: Session endpoints]/plan` to the response with the `200` status
Rule: response.added
Non-breaking: POST /files/upload_sessions/{upload_session_id}/plan
endpoint added
Rule: level.info
Non-breaking: POST /files/{file_id}/upload_sessions
added the optional property `session_endpoints/allOf[subschema #1: Session endpoints]/plan` to the response with the `201` status
Rule: response.added
Box API specification changes · Revision b8b6db28 · POST /sign_requests
POST /sign_requests6 recorded findings · classified · Previous revision b3491549
Non-breaking: POST /sign_requests
added `subschema #5: Sign Request Signer Input ZIP JP Validation` to the `allOf[subschema #2]/signers/items/allOf[subschema #2]/inputs/items/allOf[subschema #2]/validation/anyOf[subschema #1: Sign Request Signer Input Validation]/` response property `oneOf` list for the response status `201`
Rule: response.added
Non-breaking: GET /sign_templates
added `subschema #5: Sign Request Signer Input ZIP JP Validation` to the `allOf[subschema #2]/entries/items/allOf[subschema #1]/signers/items/inputs/items/allOf[subschema #2]/validation/anyOf[subschema #1: Sign Request Signer Input Validation]/` response property `oneOf` list for the response status `200`
Rule: response.added
Non-breaking: GET /sign_requests
added `subschema #5: Sign Request Signer Input ZIP JP Validation` to the `allOf[subschema #2]/entries/items/allOf[subschema #2]/signers/items/allOf[subschema #2]/inputs/items/allOf[subschema #2]/validation/anyOf[subschema #1: Sign Request Signer Input Validation]/` response property `oneOf` list for the response status `200`
Rule: response.added
Non-breaking: GET /sign_templates/{template_id}
added `subschema #5: Sign Request Signer Input ZIP JP Validation` to the `allOf[subschema #1]/signers/items/inputs/items/allOf[subschema #2]/validation/anyOf[subschema #1: Sign Request Signer Input Validation]/` response property `oneOf` list for the response status `200`
Rule: response.added
Non-breaking: POST /sign_requests/{sign_request_id}/cancel
added `subschema #5: Sign Request Signer Input ZIP JP Validation` to the `allOf[subschema #2]/signers/items/allOf[subschema #2]/inputs/items/allOf[subschema #2]/validation/anyOf[subschema #1: Sign Request Signer Input Validation]/` response property `oneOf` list for the response status `200`
Rule: response.added
Non-breaking: GET /sign_requests/{sign_request_id}
added `subschema #5: Sign Request Signer Input ZIP JP Validation` to the `allOf[subschema #2]/signers/items/allOf[subschema #2]/inputs/items/allOf[subschema #2]/validation/anyOf[subschema #1: Sign Request Signer Input Validation]/` response property `oneOf` list for the response status `200`
Rule: response.added