---
title: "POST /api/rpc/createReports"
method: POST
path: "/api/rpc/createReports"
tags: ["sites"]
---

# POST /api/rpc/createReports

`POST /api/rpc/createReports`

## Request

- Base URL: `https://21risk.com`
- URL: `https://21risk.com/api/rpc/createReports`
- Auth: OAuth 2 (client credentials, token URL `/api/v1/oauth/token`)

Create audit reports for selected sites using a risk model. Selected sites outside the calling user's site access are skipped; the response reports how many reports were created and how many sites were skipped.

## Request body

- object
  - `tenant` unknown, required
  - `model` string, required: The risk model to use
  - `strategy` 'startAllCompliant' | 'startAllNonCompliant' | 'startAuditBasedOnCurrentIfNoneThenCompliant', required: The strategy to use when creating the report
  - `auditor` string, nullable
  - `date` unknown
  - `selectionContext` object, required
    - `tenant` unknown, required
    - `query` string
    - `boardId` union
      - string
      - object
        - `type` 'id', required
        - `hasAnyValue` boolean
        - `include` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
        - `exclude` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
    - `name` union
      - string
      - object
        - `type` 'id', required
        - `hasAnyValue` boolean
        - `include` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
        - `exclude` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
    - `country` union
      - string
      - object
        - `type` 'id', required
        - `hasAnyValue` boolean
        - `include` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
        - `exclude` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
    - `city` union
      - string
      - object
        - `type` 'id', required
        - `hasAnyValue` boolean
        - `include` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
        - `exclude` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
    - `region` union
      - string
      - object
        - `type` 'id', required
        - `hasAnyValue` boolean
        - `include` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
        - `exclude` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
    - `district` union
      - string
      - object
        - `type` 'id', required
        - `hasAnyValue` boolean
        - `include` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
        - `exclude` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
    - `postcode` union
      - string
      - object
        - `type` 'id', required
        - `hasAnyValue` boolean
        - `include` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
        - `exclude` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
    - `locality` union
      - string
      - object
        - `type` 'id', required
        - `hasAnyValue` boolean
        - `include` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
        - `exclude` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
    - `neighborhood` union
      - string
      - object
        - `type` 'id', required
        - `hasAnyValue` boolean
        - `include` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
        - `exclude` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
    - `tags` union
      - string
      - object
        - `type` 'id', required
        - `hasAnyValue` boolean
        - `include` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
        - `exclude` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
    - `insurance` object
      - `type` 'id', required
      - `hasAnyValue` boolean
      - `include` object
        - `operator` 'OR' | 'AND', required
        - `values` object[], required
          - `id` boolean, required
          - `directOnly` boolean, required
      - `exclude` object
        - `operator` 'OR' | 'AND', required
        - `values` object[], required
          - `id` boolean, required
          - `directOnly` boolean, required
    - `status` union
      - string
      - object
        - `type` 'id', required
        - `hasAnyValue` boolean
        - `include` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` 'active' | 'inactive', required
            - `directOnly` boolean, required
        - `exclude` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` 'active' | 'inactive', required
            - `directOnly` boolean, required
    - `groups` union
      - string
      - object
        - `type` 'id', required
        - `hasAnyValue` boolean
        - `include` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` integer, required
            - `directOnly` boolean, required
        - `exclude` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` integer, required
            - `directOnly` boolean, required
    - `parent` union
      - string
      - object
        - `type` 'id', required
        - `hasAnyValue` boolean
        - `include` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
        - `exclude` object
          - `operator` 'OR' | 'AND', required
          - `values` object[], required
            - `id` string, required
            - `directOnly` boolean, required
    - `hasAccess` object
      - `type` 'id', required
      - `hasAnyValue` boolean
      - `include` object
        - `operator` 'OR' | 'AND', required
        - `values` object[], required
          - `id` boolean, required
          - `directOnly` boolean, required
      - `exclude` object
        - `operator` 'OR' | 'AND', required
        - `values` object[], required
          - `id` boolean, required
          - `directOnly` boolean, required
    - `createdDate` union
      - string
      - object
        - `type` 'date', required
        - `opr` '>' | '>=' | '=' | '!=' | '<' | '<=', required
        - `value` unknown, required
        - `precision` 'year' | 'month' | 'day'
      - object
        - `type` 'date', required
        - `opr` '=' | '!=', required
        - `value` unknown, required
      - object
        - `type` 'date', required
        - `opr` '>' | '>=' | '=' | '!=' | '<' | '<=', required
        - `relativeSign` unknown, required
        - `relativeAmount` 0, required
        - `relativeUnit` unknown, required
      - object
        - `type` 'date', required
        - `opr` '>' | '>=' | '=' | '!=' | '<' | '<=', required
        - `relativeSign` '+' | '-', required
        - `relativeAmount` integer, required
        - `relativeUnit` 'd' | 'w' | 'm' | 'y', required
      - object
        - `type` 'date', required
        - `opr` '..', required
        - `startValue` unknown, required
        - `startPrecision` 'year' | 'month' | 'day'
        - `startRelativeSign` '+' | '-', nullable, required
        - `startRelativeAmount` integer, nullable, required
        - `startRelativeUnit` 'd' | 'w' | 'm' | 'y', nullable, required
        - `endValue` unknown, required
        - `endPrecision` 'year' | 'month' | 'day'
        - `endRelativeSign` '+' | '-', nullable, required
        - `endRelativeAmount` integer, nullable, required
        - `endRelativeUnit` 'd' | 'w' | 'm' | 'y', nullable, required
    - `includes` string[]
    - `excludes` string[]
    - `after` string
    - `before` string
    - `first` union
      - unknown
      - 'all'
    - `last` unknown
    - `sort` union
      - 'name' | 'country' | 'address' | 'city' | 'region' | 'district' | 'postcode' | 'locality' | 'neighborhood' | 'street' | 'latitude' | 'longitude' | 'createdDate' | 'status' | 'parent'
      - string
      - union[]
        - union
          - 'name' | 'country' | 'address' | 'city' | 'region' | 'district' | 'postcode' | 'locality' | 'neighborhood' | 'street' | 'latitude' | 'longitude' | 'createdDate' | 'status' | 'parent'
          - string
    - `direction` union
      - 'asc' | 'desc'
      - string[]
    - `q` union
      - string
      - object[]

## Response `200`

Successful response

---

[API](https://skmtc.dev/21risk/apis/21risk-api.md) · [All operations](https://skmtc.dev/21risk/apis/21risk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/21risk/apis/21risk-api/revisions/273a727dfd49?raw)