---
title: "Bulk add audits with item values"
method: POST
path: "/api/audit/bulk"
tags: ["Audits"]
---

# Bulk add audits with item values

`POST /api/audit/bulk`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/audit/bulk`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/audit/bulk/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates multiple audits with item values across companies, properties, and events in a single operation

## Request body

- BulkAddAuditsRequest
  - `companies` object[], required: Companies/brands to create audits for
    - `id` integer, nullable, required: Brand ID. May be null only when partial is true.
  - `properties` object[], required: Properties with their associated events
    - `id` integer, required: Property / team ID
    - `events` object[], required
  - `items` object[], required: Items with their values
    - `id` integer, nullable, required: Item ID. May be null only when partial is true.
    - `detectionConfidence` number, float, nullable: A detector's 0-1 score for this asset. Omit it unless the caller scored the asset itself: an absent score is stored as no detection row at all, which reads as nobody scored this rather than scored low.
  - `synonyms` object[]: Synonyms to add to events
  - `isQuickAdd` boolean: Whether this is a quick-add operation
  - `partial` boolean: Marks the payload as partial rows (Scout by Image, Scout by Audio). With it, companies and items may be empty and their id may be null: a missing brand is saved as the Unknown Brand and a missing asset as the Unknown Asset, one row per image. Without it, a missing id is rejected.
  - `curated_news_id` integer: The news article these assets were added from, when the quick add was opened from the news queue. Optional: this endpoint is shared with seven other quick-add entry points that have no article. Supplying it stamps assets_added_at on the article the first time.

## Response `200`

Created item values

## Other responses

- `401`: Unauthenticated
- `422`: Validation error

---

[API](https://skmtc.dev/sponsorunited/apis/sponsorunited-api.md) - [All operations](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/revisions/cbf1ca5bff8f?raw)