---
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`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/payroll-engine/apis/payroll-engine-backend-api-v1/docs/api/tenants/:tenantId/payrolls/:payrollId/cases/post.ts> (a function with typed inputs; its response is checked against the schema)

## 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

## Changes

- **2026-03-09** `642427b60b7a`: 76 warning
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredEvents/items/addMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredEvents/items/raiseMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredEvents/items/removeMethod/methodImplementationFlags` response property for the response status `422`
  - …72 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/payroll-engine/apis/payroll-engine-backend-api-v1/changes/api/tenants/:tenantId/payrolls/:payrollId/cases/post.md)

---

[API](https://skmtc.dev/payroll-engine/apis/payroll-engine-backend-api-v1.md) - [All operations](https://skmtc.dev/payroll-engine/apis/payroll-engine-backend-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/payroll-engine/apis/payroll-engine-backend-api-v1/revisions/7e8994a2c5bb?raw)