diff --git a/CHANGELOG.md b/CHANGELOG.md
index ec46f1b..3f1f7fd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- chore(uploads): clarify finalize token validation errors
 - feat(jobs): add ivf_index_hold job type support
 - feat(indexes): add algorithm and probe_fraction support
 - chore: add 403 forbidden response to endpoints
diff --git a/docs/UploadsApi.md b/docs/UploadsApi.md
index 99ab848..3daff50 100644
--- a/docs/UploadsApi.md
+++ b/docs/UploadsApi.md
@@ -283,8 +283,8 @@ Name | Type | Description  | Notes
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 **200** | Upload finalized |  -  |
-**400** | Invalid finalize token, uploaded size mismatch, missing file, or upload not finalizable |  -  |
-**404** | Upload session not found |  -  |
+**400** | Missing finalize token header, uploaded size mismatch, missing file, or upload not finalizable |  -  |
+**404** | Upload session not found, or the finalize token does not match it |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
 
@@ -375,8 +375,8 @@ Name | Type | Description  | Notes
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 **200** | Minted part URLs |  -  |
-**400** | Invalid finalize token, invalid part numbers, batch too large, or the upload is not a multi-part upload |  -  |
-**404** | Upload session not found |  -  |
+**400** | Missing finalize token header, invalid part numbers, batch too large, or the upload is not a multi-part upload |  -  |
+**404** | Upload session not found, or the finalize token does not match it |  -  |
 **501** | This deployment cannot issue upload URLs |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)