Delete Upload

DELETE

/api/v1/uploads/:upload_id

Delete an upload and its S3 object.

DB record is deleted first (committed on response). S3 cleanup runs after the response via a background task so the file is only removed once the DB commit succeeds.

POD-301: if the upload was confirmed against a workspace-scoped resource, release the bytes back to that workspace’s storage counter. Without this, storage_bytes_used drifts upward forever and customers stay capped after deleting files. Read upload state BEFORE delete_for_user — the row is gone after that call.

Delete an upload and its S3 object. DB record is deleted first (committed on response). S3 cleanup runs after the response via a background task so the file is only removed once the DB commit succeeds. POD-301: if the upload was confirmed against a workspace-scoped resource, release the bytes back to that workspace's storage counter. Without this, storage_bytes_used drifts upward forever and customers stay capped after deleting files. Read upload state BEFORE delete_for_user — the row is gone after that call.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

upload_idstringRequiredformat: "uuid"

Response

Successful Response

datamap from strings to any

metaobject

Errors

422

Unprocessable Entity Error

$	curl -X DELETE https://api.onepin.ai/api/v1/uploads/upload_id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"data": {},
3	"meta": {
4	"request_id": "a3f47b9e-8c2d-4f1a-9b7e-2d5f3c6a1e4b",
5	"timestamp": "2024-04-27T14:45:00Z"
6	}
7	}

Authentication

Path parameters

Headers

Response

Errors