Upload batch Not Found

upload-batch-not-found · 404

The bucket in the path has no upload batch by that id that the caller started.

A batch is found only under its bucket, in the workspace the call runs in, for the member who started it. resourceId repeats the id the API looked up.

Besides the members every error carries, this type adds resourceType and resourceId.

Common causes

  • Another member started the batch.
  • The batch is on another bucket than the one in the path.
  • The call ran in another workspace than the batch's: a call runs in the workspace its X-Ghaym-Workspace header names, or a stream's ?workspace=<id> when the header is absent.

How to fix the call

  • Read resourceId and compare it with the value you meant to send.
  • Start a batch of your own on that bucket with POST /v1/buckets/<bucket>/upload-batches, and use the id it answers with.
  • Don't retry unchanged: the same call answers the same 404 for as long as nothing changes.

Example response

json
{
  "type": "upload-batch-not-found",
  "title": "Upload batch Not Found",
  "detail": "Upload batch with ID '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402' was not found",
  "resourceType": "Upload batch",
  "resourceId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/complete",
  "method": "POST",
  "instance": "POST /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/upload-batches/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad402/complete",
  "status": 404,
  "docs": "https://ghaym.me/docs/errors/upload-batch-not-found"
}