---
title: "Complete a work item by submitting the operator response"
method: PATCH
path: "/work-center-service/work-items/{id}/complete"
tags: ["Work Center Service"]
---

# Complete a work item by submitting the operator response

`PATCH /work-center-service/work-items/{id}/complete`

## Request

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

Completes a work item by submitting the operator response.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `finishState` string: Opaque finish state string emitted by the view component.
  - `variables` WorkCenterServiceWorkItemsIdCompletePatchRequestBodyContentApplicationJsonSchemaVariables: Flat key-value pairs representing the operator's raw submission. Omitted for read-only task types.

## Response `200`

Work item completed successfully

- WorkCenterServiceCompleteWorkItemResponse200
  - `id` string, uuid, required: Unique identifier (UUID) of the work item.
  - `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.
  - `status` 'pending' | 'completed' | 'canceled', required: Current status of the work item.
  - `groups` WorkCenterServiceWorkItemsIdCompletePatchResponsesContentApplicationJsonSchemaGroups, required: Access control groups.
    - `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.
  - `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.
  - `rootExecution` WorkCenterServiceWorkItemsIdCompletePatchResponsesContentApplicationJsonSchemaRootExecution, required: Root execution metadata for the detail view header.
    - `id` string, required: Unique identifier of the root execution that started the ancestry chain.
    - `name` string, required: Human-readable name of the root execution.
    - `url` string: Optional URL to access the root execution (e.g., workflow execution UI link).
    - `trigger` WorkCenterServiceWorkItemsIdCompletePatchResponsesContentApplicationJsonSchemaRootExecutionTrigger, required: Trigger information defining what initiated the root execution.
      - `type` 'manual' | 'endpoint' | 'schedule' | 'eventSystem' | 'job' | 'session', required: Type of trigger that initiated the work item.
      - `label` string, required: Human-readable label for the trigger.
    - `startTime` string, date-time, required: ISO 8601 timestamp when the root execution started.
  - `execution` WorkCenterServiceWorkItemsIdCompletePatchResponsesContentApplicationJsonSchemaExecution, required: Execution that invoked createWorkItem.
    - `id` string, required: Unique identifier of the running job or session that invoked createWorkItem.
    - `name` string, required: Human-readable name of the parent job or session.
    - `type` string, required: Opaque execution type passed to the ancestry adapter (e.g. job, session).
    - `url` string: Optional URL to access the execution.
    - `description` string: Optional description of the execution, useful for differentiating between concurrent executions.
  - `view` string, required: Relative URL path to the UI view for this task.
  - `variables` WorkCenterServiceWorkItemsIdCompletePatchResponsesContentApplicationJsonSchemaVariables, required: Variables for the renderer.
    - `incoming` WorkCenterServiceWorkItemsIdCompletePatchResponsesContentApplicationJsonSchemaVariablesIncoming, required: JSON object containing incoming variables from the workflow.
    - `outgoing` WorkCenterServiceWorkItemsIdCompletePatchResponsesContentApplicationJsonSchemaVariablesOutgoing, required: JSON object containing outgoing variables set after completion.
    - `outgoingOmittedReason` 'size_exceeded': Reason outgoing variables were omitted from the response.
  - `metrics` WorkCenterServiceWorkItemsIdCompletePatchResponsesContentApplicationJsonSchemaMetrics, required: Work item operational metrics.
    - `owner` string, required: Account ID of the operator who claimed the work item.
    - `ownerUsername` string: Resolved username of the operator who claimed the work item.
    - `claimTime` string, required: ISO 8601 timestamp when the work item was claimed.
    - `finishState` string, required: Opaque finish state string emitted by the view component on completion.
  - `createdAt` string, required: ISO 8601 creation timestamp.
  - `isIncomingClaimChecked` boolean, required: Whether the incoming variables are stored as a claim check (large data).
  - `updatedAt` string, required: ISO 8601 last updated timestamp.

## 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/:id/complete/patch.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)