---
title: "POST /api/tenants/{tenantId}/regulations/{regulationId}/reports"
method: POST
path: "/api/tenants/{tenantId}/regulations/{regulationId}/reports"
tags: ["Reports"]
---

# POST /api/tenants/{tenantId}/regulations/{regulationId}/reports

`POST /api/tenants/{tenantId}/regulations/{regulationId}/reports`

## 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/regulations/:regulationId/reports/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `tenantId` integer, required
- `regulationId` integer, required

## Request body

- Report
  - `id` integer
  - `status` 'Active' | 'Inactive'
  - `created` string, date-time
  - `updated` string, date-time
  - `name` string, required
  - `nameLocalizations` object, nullable
  - `description` string, nullable
  - `descriptionLocalizations` object, nullable
  - `category` string, nullable
  - `attributeMode` 'Json' | 'Table'
  - `userType` 'Employee' | 'User' | 'TenantAdministrator' | 'SystemAdministrator'
  - `reportIsolation` 'None' | 'Global' | 'Company' | 'Division' | 'Employee'
  - `queries` object, nullable
  - `relations` DataRelation[], nullable
    - `name` string, nullable
    - `parentTable` string, nullable
    - `parentColumn` string, nullable
    - `childTable` string, nullable
    - `childColumn` string, nullable
  - `buildExpression` string, nullable
  - `startExpression` string, nullable
  - `endExpression` string, nullable
  - `overrideType` 'Active' | 'Inactive'
  - `attributes` object, nullable
  - `clusters` string[], nullable

## Response `201`

Created

- Report
  - `id` integer
  - `status` 'Active' | 'Inactive'
  - `created` string, date-time
  - `updated` string, date-time
  - `name` string, required
  - `nameLocalizations` object, nullable
  - `description` string, nullable
  - `descriptionLocalizations` object, nullable
  - `category` string, nullable
  - `attributeMode` 'Json' | 'Table'
  - `userType` 'Employee' | 'User' | 'TenantAdministrator' | 'SystemAdministrator'
  - `reportIsolation` 'None' | 'Global' | 'Company' | 'Division' | 'Employee'
  - `queries` object, nullable
  - `relations` DataRelation[], nullable
    - `name` string, nullable
    - `parentTable` string, nullable
    - `parentColumn` string, nullable
    - `childTable` string, nullable
    - `childColumn` string, nullable
  - `buildExpression` string, nullable
  - `startExpression` string, nullable
  - `endExpression` string, nullable
  - `overrideType` 'Active' | 'Inactive'
  - `attributes` object, nullable
  - `clusters` string[], nullable

## Other responses

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

## Changes

- **2026-04-01** `34e260deaa2c`: 4 info
  - added the new optional request property `reportIsolation` (media type: application/json)
  - added the new optional request property `reportIsolation` (media type: text/json)
  - added the new optional request property `reportIsolation` (media type: application/*+json)
  - added the optional property `reportIsolation` to the response with the `201` status
- …earlier changes not shown

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