KOkoncile
Public

Register Upload

Changed on

Start extraction for files already uploaded to their presigned URLs (step 2 of 2).

Safe to retry: a handle that is already running or already finished comes back under skipped, never started or charged twice.

Per handle: one file that cannot be started (not uploaded yet, too large) comes back under rejected and the others are started anyway. The call only fails as a whole when every handle is refused, or when storage cannot be reached (503 — nothing has been started, retry the same request).

post/v1/register_upload/

Request

Request body

upload_idsinteger[] required

Handles from /v1/presign_upload/, for files that have actually been uploaded. All must belong to the caller's company.

Example request

{
  "upload_ids": [
    101,
    102
  ]
}

Response

Successful Response

task_idsstring[]

One task per newly-started file, pollable with /v1/fetch_tasks_results. Every task reaches a terminal status (UPLOAD-016).

Example response

{
  "skipped": [
    {
      "reason": "already_dispatched"
    }
  ],
  "rejected": [
    {
      "reason": "not_uploaded"
    }
  ]
}

Changes