---
title: "Create File Upload Job"
method: POST
path: "/api/v2/file-upload/start"
tags: ["Collection Uploads", "Community", "Enterprise"]
---

# Create File Upload Job

`POST /api/v2/file-upload/start`

Creates a file upload job for sending collection files

## Response `201`

Created

- object
  - `data` ModelFileUploadJob
    - `id` integer — This is the unique identifier for this object.
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `deleted_at` NullTime
      - `time` string, date-time — An RFC-3339 formatted string
      - `valid` boolean — Valid is true if `time` is not `null`.
    - `user_id` string, uuid
    - `user_email_address` string, email
    - `status` -1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 — This enum describes the current status of a Job. Values are: - `-1` Invalid - `0` Ready - `1` Running - `2` Complete - `3` Canceled - `4` Timed Out - `5` Failed - `6` Ingesting - `7` Analyzing - `8` Partially Complete
    - `status_message` string
    - `start_time` string, date-time
    - `end_time` string, date-time
    - `last_ingest` string, date-time
    - `total_files` integer
    - `failed_files` integer

## Other responses

- `401` — **Unauthorized** This endpoint failed an authentication requirement. Either the client tried to access a protected endpoint without being authenticated, or an auth validation failed (ex- invalid credentials or expired token).
- `500` — **Internal Server Error** This is usually the result of either an unexpected database or application error. The client may try modifying or resending the request, but the error is likely not related to the client doing something wrong.

---

[API](https://skmtc.net/specterops/apis/bloodhound-api.md) · [All operations](https://skmtc.net/specterops/apis/bloodhound-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/specterops/bloodhound-api/revisions/b7bbf50b77e7/schema)