---
title: "Create a new work item"
method: POST
path: "/work-center-service/work-items"
tags: ["Work Center Service"]
---

# Create a new work item

`POST /work-center-service/work-items`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/work-center-service/work-items`
- Auth: none declared

Creates a new work item.

## Request body

- object
  - `body` WorkCenterServiceWorkItemsPostRequestBodyContentApplicationJsonSchemaBody
    - `appId` string, required: Application identifier that is creating the work item.
    - `resourceId` string, required: Resource identifier for tracking across application boundaries. Combined with appId to enforce uniqueness constraint.
    - `name` string, required: Human-readable name of the work item.
    - `summary` string, required: Brief summary of the work item.
    - `description` string: Optional detailed description of the work item.
    - `view` string, required: Relative URL path to the UI view for this task.
    - `groups` WorkCenterServiceWorkItemsPostRequestBodyContentApplicationJsonSchemaBodyGroups, required: Access control groups defining read and write permissions.
      - `read` string[], required: Array of group identifiers with read access to the work item.
      - `write` string[], required: Array of group identifiers with write access to the work item.
    - `execution` WorkCenterServiceWorkItemsPostRequestBodyContentApplicationJsonSchemaBodyExecution, required: Identifies the running job or session that invoked createWorkItem. Ancestry-derived fields (name, root execution metadata) are resolved internally.
      - `id` string, required: Unique identifier of the running job or session that invoked createWorkItem.
      - `type` string, required: Opaque execution type passed to the ancestry adapter (e.g. job, session).
      - `description` string: Optional description of the execution, useful for differentiating between concurrent executions.
    - `variables` WorkCenterServiceWorkItemsPostRequestBodyContentApplicationJsonSchemaBodyVariables, required: Variables payload containing incoming workflow data.
      - `incoming` WorkCenterServiceWorkItemsPostRequestBodyContentApplicationJsonSchemaBodyVariablesIncoming, required: JSON object containing incoming variables from the workflow.

## Response `200`

Work item created successfully

- WorkCenterServiceCreateWorkItemResponse200
  - `workItemId` string, uuid, required: Unique identifier (UUID) of the work item.

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Work Center Service` added
  - api tag `workCenterService` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/work-center-service/work-items/post.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)