---
title: "Create Job"
method: POST
path: "/spaces/{spaceId}/jobs"
tags: ["Manage Jobs"]
---

# Create Job

`POST /spaces/{spaceId}/jobs`

## Path parameters

- `spaceId` string, required

## Request body

- Job — A job which can be executed by the XYZ Job API. There are different kinds of tasks to be executed by a job depending on its specified source and target dataset-descriptions.
  - `type` string — The type of the job (deprecated)
  - `id` string — The unique identifier of the job. NOTE: The id will always be generated by the service. It can not be defined by the client.
  - `description` string — A human readable description of the purpose of the job
  - `source` DatasetDescription
    - `type` 'Space' | 'Spaces' | 'Files' — The type of the dataset
  - `target` DatasetDescription
    - `type` 'Space' | 'Spaces' | 'Files' — The type of the dataset

## Response `201`

The Job

- Job — A job which can be executed by the XYZ Job API. There are different kinds of tasks to be executed by a job depending on its specified source and target dataset-descriptions.
  - `type` string — The type of the job (deprecated)
  - `id` string — The unique identifier of the job. NOTE: The id will always be generated by the service. It can not be defined by the client.
  - `description` string — A human readable description of the purpose of the job
  - `source` DatasetDescription
    - `type` 'Space' | 'Spaces' | 'Files' — The type of the dataset
  - `target` DatasetDescription
    - `type` 'Space' | 'Spaces' | 'Files' — The type of the dataset

## Other responses

- `400` — Malformed or Bad Request.
- `401` — Unauthorized to perform the request.
- `403` — Forbidden request. Insufficient rights to perform the request.

## Changes

- **2025-07-30** `f6c73245e446` — 1 breaking
  - api path removed without deprecation
- **2025-01-08** `c39c865eea00` — 2 warning
  - removed the request property `process`
  - removed the optional property `process` from the response with the `201` status
- **2025-01-08** `ac3f4744a9a9` — 2 breaking, 2 warning
  - the `process` request property type changed from `object` to no type
  - the `process` response's property type changed from `object` to no type for status `201`
  - removed the request property `process/type`
  - removed the optional property `process/type` from the response with the `201` status
- **2025-01-07** `03b55a5a94e5` — 2 info
  - added the new optional request property `process`
  - added the optional property `process` to the response with the `201` status
- **2023-11-22** `bbe8fa8e63e9` — 2 warning, 4 info
  - removed the request property `csvFormat`
  - removed the optional property `csvFormat` from the response with the `201` status
  - added the new optional request property `source`
  - added the new optional request property `target`
  - …2 more

[Full history](https://skmtc.dev/here/apis/here-xyz-hub/changes/spaces/:spaceId/jobs/post.md)

---

[API](https://skmtc.dev/here/apis/here-xyz-hub.md) · [All operations](https://skmtc.dev/here/apis/here-xyz-hub/llms.txt) · [OpenAPI document](https://skmtc.dev/here/apis/here-xyz-hub/revisions/a5a97b4943e2?raw)