---
title: "Changes to Start a job"
method: POST
path: "/api/jobs/{namespace}"
---

# Changes to Start a job

`POST /api/jobs/{namespace}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 82 revisions.

- **2026-09-11** `c447fcdd4d16` — 1 breaking, 2 info
- **2026-09-08** `bd17546f47b8` — 10 breaking, 15 warning, 6 info
- **2026-08-14** `2980c6dae34a` — 1 warning
- **2026-07-27** `05ebd27557fb` — 3 info
- **2026-07-26** `36390f25f00f` — 2 info

## Changes

- **2026-09-11** `c447fcdd4d16` — 1 breaking, 2 info
  - removed `subschema #1, subschema #2` from the request body `oneOf` list
  - added `subschema #1, subschema #2` to the request body `oneOf` list
  - added the optional property `network` to the response with the `200` status
- **2026-09-08** `bd17546f47b8` — 10 breaking, 15 warning, 6 info
  - the request's body type changed from `object` to no type
  - the response property `status/message` became nullable for the status `200`
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `initiator` response property `oneOf` list for the response status `200`
  - the `arch` response's property type changed from no type to `string` for status `200`
  - the `flavor` response's property type changed from no type to `string` for status `200`
  - the `hfToken/tokenRole` response's property type changed from no type to `string` for status `200`
  - the `owner/type` response's property type changed from no type to `string` for status `200`
  - the `status/cancelReason/anyOf[subschema #1]/` response's property type changed from no type to `string` for status `200`
  - the `status/stage` response's property type changed from no type to `string` for status `200`
  - the `type` response's property type changed from no type to `string` for status `200`
  - removed the request property `arch`
  - removed the request property `arguments`
  - removed the request property `attempts`
  - removed the request property `command`
  - removed the request property `dockerImage`
  - removed the request property `environment`
  - removed the request property `expose`
  - removed the request property `flavor`
  - removed the request property `labels`
  - removed the request property `resourceGroupId`
  - removed the request property `secrets`
  - removed the request property `spaceId`
  - removed the request property `ssh`
  - removed the request property `timeoutSeconds`
  - removed the request property `volumes`
  - added `subschema #1, subschema #2` to the request body `oneOf` list
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `initiator` response property `anyOf` list for the response status `200`
  - response property `status/message` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - the `createdAt` response's property pattern was changed from `^((\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-((0[13578]|1[02])-(0[1-9]|[12]\d|3[01])|(0[469]|11)-(0[1-9]|[12]\d|30)|(02)-(0[1-9]|1\d|2[0-8])))T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d+)?(Z)$` to `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$` for the status `200`
  - the `finishedAt` response's property pattern was changed from `^((\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-((0[13578]|1[02])-(0[1-9]|[12]\d|3[01])|(0[469]|11)-(0[1-9]|[12]\d|30)|(02)-(0[1-9]|1\d|2[0-8])))T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d+)?(Z)$` to `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$` for the status `200`
  - the `startedAt` response's property pattern was changed from `^((\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-((0[13578]|1[02])-(0[1-9]|[12]\d|3[01])|(0[469]|11)-(0[1-9]|[12]\d|30)|(02)-(0[1-9]|1\d|2[0-8])))T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(\.\d+)?(Z)$` to `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$` for the status `200`
- **2026-08-14** `2980c6dae34a` — 1 warning
  - added the new `RESOURCE_GROUP_LIMIT` enum value to the `status/cancelReason/anyOf[subschema #1]/` response property for the response status `200`
- **2026-07-27** `05ebd27557fb` — 3 info
  - added the new optional request property `resourceGroupId`
  - added the optional property `resourceGroup` to the response with the `200` status
  - added the optional property `resourceGroupId` to the response with the `200` status
- **2026-07-26** `36390f25f00f` — 2 info
  - added the new optional request property `expose/portsPublic`
  - added the optional property `expose` to the response with the `200` status

---

[Operation](https://skmtc.dev/huggingface/apis/hub-api-endpoints/docs/api/jobs/:namespace/post.md) · [API](https://skmtc.dev/huggingface/apis/hub-api-endpoints.md) · [Page](https://skmtc.dev/huggingface/apis/hub-api-endpoints/changes/api/jobs/:namespace/post)