---
title: "POST /api/tenants/{tenantId}/payrolls/{payrollId}/cases"
method: POST
path: "/api/tenants/{tenantId}/payrolls/{payrollId}/cases"
tags: ["Payrolls"]
---

# POST /api/tenants/{tenantId}/payrolls/{payrollId}/cases

`POST /api/tenants/{tenantId}/payrolls/{payrollId}/cases`

## Path parameters

- `tenantId` integer, required
- `payrollId` integer, required

## Request body

- CaseChangeSetup
  - `userId` integer, required
  - `employeeId` integer, nullable
  - `divisionId` integer, nullable
  - `cancellationId` integer, nullable
  - `forecast` string, nullable
  - `created` string, date-time, nullable
  - `reason` string, nullable
  - `case` CaseSetup, required
    - `id` integer
    - `status` 'Active' | 'Inactive'
    - `created` string, date-time
    - `updated` string, date-time
    - `caseName` string, required
    - `caseSlot` string, nullable
    - `values` CaseValueSetup[], nullable
      - `id` integer
      - `status` 'Active' | 'Inactive'
      - `created` string, date-time
      - `updated` string, date-time
      - `divisionId` integer, nullable
      - `employeeId` integer, nullable
      - `caseName` string, nullable
      - `caseNameLocalizations` object, nullable
      - `caseFieldName` string, required
      - `caseFieldNameLocalizations` object, nullable
      - `caseSlot` string, nullable
      - `caseSlotLocalizations` object, nullable
      - `valueType` 'String' | 'Boolean' | 'Integer' | 'NumericBoolean' | 'Decimal' | 'DateTime' | 'None' | 'Date' | 'Weekday' | 'Month' | 'Year' | 'Money' | 'Percent' | 'WebResource'
      - `value` string, nullable
      - `numericValue` number, double, nullable
      - `culture` string, nullable
      - `caseRelation` CaseRelationReference
        - `sourceCaseName` string, nullable
        - `sourceCaseSlot` string, nullable
        - `targetCaseName` string, nullable
        - `targetCaseSlot` string, nullable
      - `cancellationDate` string, date-time, nullable
      - `start` string, date-time, nullable
      - `end` string, date-time, nullable
      - `forecast` string, nullable
      - `tags` string[], nullable
      - `attributes` object, nullable
      - `documents` CaseDocument[], nullable
        - `id` integer
        - `status` 'Active' | 'Inactive'
        - `created` string, date-time
        - `updated` string, date-time
        - `name` string, required
        - `content` string, required
        - `contentType` string, required
    - `relatedCases` CaseSetup[], nullable
  - `issues` CaseValidationIssue[], nullable
    - `issueType` 'Unknown' | 'CaseInvalid' | 'CaseUnknown' | 'CaseRelationInvalid' | 'CaseFieldDuplicated' | 'CaseValueIncomplete' | 'CaseValueMissing' | 'CaseValueStartInvalid' | 'CaseValueEndInvalid' | 'CaseValueEndMissing' | 'CaseValueWeekdayInvalid' | 'CaseValueMonthInvalid', required
    - `number` integer
    - `caseName` string, required
    - `caseNameLocalizations` object, nullable
    - `caseSlot` string, nullable
    - `caseSlotLocalizations` object, nullable
    - `caseFieldName` string, nullable
    - `caseFieldNameLocalizations` object, nullable
    - `sourceCaseName` string, nullable
    - `sourceCaseNameLocalizations` object, nullable
    - `sourceCaseSlot` string, nullable
    - `sourceCaseSlotLocalizations` object, nullable
    - `targetCaseName` string, nullable
    - `targetCaseNameLocalizations` object, nullable
    - `targetCaseSlot` string, nullable
    - `targetCaseSlotLocalizations` object, nullable
    - `message` string, required

## Response `201`

Created

- CaseChange
  - `id` integer
  - `status` 'Active' | 'Inactive'
  - `created` string, date-time
  - `updated` string, date-time
  - `userId` integer, required
  - `employeeId` integer, nullable
  - `divisionId` integer, nullable
  - `cancellationType` 'None' | 'Case'
  - `cancellationId` integer, nullable
  - `cancellationDate` string, date-time, nullable
  - `reason` string, nullable
  - `validationCaseName` string, nullable
  - `forecast` string, nullable
  - `values` CaseValue[], nullable
    - `id` integer
    - `status` 'Active' | 'Inactive'
    - `created` string, date-time
    - `updated` string, date-time
    - `divisionId` integer, nullable
    - `employeeId` integer, nullable
    - `caseName` string, nullable
    - `caseNameLocalizations` object, nullable
    - `caseFieldName` string, required
    - `caseFieldNameLocalizations` object, nullable
    - `caseSlot` string, nullable
    - `caseSlotLocalizations` object, nullable
    - `valueType` 'String' | 'Boolean' | 'Integer' | 'NumericBoolean' | 'Decimal' | 'DateTime' | 'None' | 'Date' | 'Weekday' | 'Month' | 'Year' | 'Money' | 'Percent' | 'WebResource'
    - `value` string, nullable
    - `numericValue` number, double, nullable
    - `culture` string, nullable
    - `caseRelation` CaseRelationReference
      - `sourceCaseName` string, nullable
      - `sourceCaseSlot` string, nullable
      - `targetCaseName` string, nullable
      - `targetCaseSlot` string, nullable
    - `cancellationDate` string, date-time, nullable
    - `start` string, date-time, nullable
    - `end` string, date-time, nullable
    - `forecast` string, nullable
    - `tags` string[], nullable
    - `attributes` object, nullable
  - `ignoredValues` CaseValue[], nullable
    - `id` integer
    - `status` 'Active' | 'Inactive'
    - `created` string, date-time
    - `updated` string, date-time
    - `divisionId` integer, nullable
    - `employeeId` integer, nullable
    - `caseName` string, nullable
    - `caseNameLocalizations` object, nullable
    - `caseFieldName` string, required
    - `caseFieldNameLocalizations` object, nullable
    - `caseSlot` string, nullable
    - `caseSlotLocalizations` object, nullable
    - `valueType` 'String' | 'Boolean' | 'Integer' | 'NumericBoolean' | 'Decimal' | 'DateTime' | 'None' | 'Date' | 'Weekday' | 'Month' | 'Year' | 'Money' | 'Percent' | 'WebResource'
    - `value` string, nullable
    - `numericValue` number, double, nullable
    - `culture` string, nullable
    - `caseRelation` CaseRelationReference
      - `sourceCaseName` string, nullable
      - `sourceCaseSlot` string, nullable
      - `targetCaseName` string, nullable
      - `targetCaseSlot` string, nullable
    - `cancellationDate` string, date-time, nullable
    - `start` string, date-time, nullable
    - `end` string, date-time, nullable
    - `forecast` string, nullable
    - `tags` string[], nullable
    - `attributes` object, nullable

## Other responses

- `404` — Not Found
- `422` — Unprocessable Content

---

[API](https://skmtc.net/payroll-engine/apis/payroll-engine-backend-api-v1.md) · [All operations](https://skmtc.net/payroll-engine/apis/payroll-engine-backend-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payroll-engine/payroll-engine-backend-api-v1/versions/34e260deaa2c/schema)