---
title: "Create new Workload"
method: POST
path: "/v1/workload-definition/create"
tags: ["WorkloadDefinitions"]
---

# Create new Workload

`POST /v1/workload-definition/create`

Create a new Workload Definition. The definition is used to manage a set of versions. This request takes no body

## Response `200`

Created

- WorkloadDefinition
  - `sysId` string — Identifier of the definition
  - `createdOn` string, date-time — Definition created on
  - `updatedOn` string, date-time — Definition updated on
  - `headVersion` RecordIdentity
    - `sysId` string — Unique Identifier of the tracked item
    - `lastUpdate` string, date-time — Last update of the tracked item
    - `table` string — Context of the tracked item
  - `releaseVersion` RecordIdentity
    - `sysId` string — Unique Identifier of the tracked item
    - `lastUpdate` string, date-time — Last update of the tracked item
    - `table` string — Context of the tracked item
  - `tenant_id` string, required — Tenant owning the workload
  - `owner` string — Owner of the workload
  - `name` string — Name of the workload
  - `description` string — Description of the workload
  - `workload_type` string — Type of the workload
  - `is_active` boolean, required — States if the workload is active or not
  - `attachments` string[] — List of attachment IDs associated with this workload

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.net/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/versions/bf2cdf20826d/schema)