---
title: "Create a job input"
method: POST
path: "/jobs/{jobId}/inputs"
tags: ["Manage Jobs"]
---

# Create a job input

`POST /jobs/{jobId}/inputs`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/jobs/{jobId}/inputs`
- Auth: one of:
  - API key in query parameter `access_token`
  - HTTP bearer

Creates a new input for a job

## Path parameters

- `jobId` string, required

## Headers

- `X-Response-Mode` 'regular' | 'paginated'

## Request body

- UploadUrl: Contains the uplaod url for import jobs.
  - `type` 'UploadUrl', required: The type is "UploadUrl"
  - `s3Key` string: The type of the Input
  - `url` string: The presigned url for uploading the data.

## Response `201`

The job inputs

- union
  - UploadUrl: Contains the uplaod url for import jobs.
    - `type` 'UploadUrl', required: The type is "UploadUrl"
    - `s3Key` string: The type of the Input
    - `url` string: The presigned url for uploading the data.
  - JobPayloads: Summary of grouped payloads (inputs/outputs) for a job.
    - `groups` object
    - `itemCount` number: Total items across all groups.
    - `byteSize` number: Total size of items across all groups in bytes.

## Other responses

- `400`: Malformed or Bad Request.
- `404`: Not found.
- `412`: An error response which indicates a failed precondition.

## Changes

- **2026-10-28** `88b5563c7e8b`: 1 info
  - added the non-success response with the status `412`
- **2025-09-26** `b0f3c1c4fc93`: 1 breaking, 1 info
  - added `#/components/schemas/JobPayloads` to the response body `oneOf` list for the response status `201`
  - added the new optional `header` request parameter `X-Response-Mode`
- **2024-05-21** `f590d51a45be`: 1 warning, 1 info
  - deleted the `header` request parameter `X-Response-Mode`
  - removed `#/components/schemas/JobPayloads` from the response body `oneOf` list for the response status `201`

[Operation history](https://skmtc.dev/here/apis/here-xyz-job-service/changes/jobs/:jobId/inputs/post.md)

---

[API](https://skmtc.dev/here/apis/here-xyz-job-service.md) - [All operations](https://skmtc.dev/here/apis/here-xyz-job-service/llms.txt) - [OpenAPI document](https://skmtc.dev/here/apis/here-xyz-job-service/revisions/88b5563c7e8b?raw)