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

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

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

## 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/bulk/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 `200`

OK

- integer

## Other responses

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

## Changes

- **2026-03-09** `97ae205209e8`: 1 info
  - endpoint added
- **2023-07-23** `fd1b5146be4a`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/payroll-engine/apis/payroll-engine-backend-api-v1/changes/api/tenants/:tenantId/payrolls/:payrollId/cases/bulk/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)