---
title: "Preview Bulk Contents"
method: POST
path: "/api/companies/{company_uuid}/contents/bulk/preview"
tags: ["contents"]
---

# Preview Bulk Contents

`POST /api/companies/{company_uuid}/contents/bulk/preview`

## Request

- Base URL: `https://api.regdoor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.regdoor.com/api/companies/{company_uuid}/contents/bulk/preview`
- Auth: HTTP bearer

## Path parameters

- `company_uuid` string, uuid, required

## Headers

- `X-User-Email` string, nullable
- `X-User-Name` string, nullable

## Request body

- CompanyContentBulkRequest: Request schema for bulk content operations.
  - `action` 'delete' | 'add_collections' | 'remove_collections', required: Supported bulk actions for library contents.
  - `collections_to_add` string[], nullable: Collection names to merge for add_collections bulk action
  - `collections_to_remove` string[], nullable: Collection names to remove for remove_collections bulk action
  - `search` string, nullable: Current list search term
  - `only_company` boolean, nullable: Only company private documents
  - `list_selected_contents` boolean, nullable: Only contents selected for the company
  - `collection_list` string[], nullable: Current list collection name filters
  - `collections_unassigned_only` boolean, nullable: Only documents with no collections
  - `user_uuid_list` string[], nullable: Filter by content authors
  - `created_from` string, date-time, nullable: Filter by created_at from
  - `created_to` string, date-time, nullable: Filter by created_at to
  - `updated_from` string, date-time, nullable: Filter by updated_at from
  - `updated_to` string, date-time, nullable: Filter by updated_at to
  - `type_list` string[], nullable: Filter by content type names
  - `type` string, nullable: Filter by a single content type name
  - `type_uuid` string, uuid, nullable: Filter by content type UUID
  - `organization_list` string[], nullable: Filter by organization UUIDs (OR)
  - `jurisdiction_list` integer[], nullable: Filter by jurisdiction IDs (OR)
  - `sector_uuid_list` string[], nullable: Filter by sector UUIDs (OR)
  - `subsector_uuid_list` string[], nullable: Filter by subsector UUIDs (OR)
  - `group_uuid_list` string[], nullable: Filter by responsible area (group) UUIDs (OR), via the documents' organizations
  - `mine_groups` boolean, nullable: When true, adds the authenticated user's areas (leader or member) to group_uuid_list. Ignored when the user has no area.
  - `unassigned_group` boolean, nullable: Only documents whose organizations have no area in this company
  - `only_public` boolean, nullable: Only public (global) contents
  - `evaluation_status` 'pending' | 'in_treatment' | 'treated' | 'not_applicable', nullable: Company evaluation status of the document (Inbox slices)
  - `relevances` CompanyContentRelevanceEnum[], nullable: Company relevance filter (OR)
  - `sort_by` string, nullable: Current list sort field
  - `sort_order` string, nullable: Current list sort order
  - `include_content_uuids` string[], nullable: Manual content UUID selection. When present, filters are ignored.
  - `exclude_content_uuids` string[], nullable: Content UUIDs excluded from a filtered bulk selection

## Response `200`

Successful Response

- CompanyContentBulkResponse: Response schema for bulk content preview and execution.
  - `action` 'delete' | 'add_collections' | 'remove_collections', required: Supported bulk actions for library contents.
  - `eligible_count` integer, required
  - `blocked_count` integer, required
  - `processed_count` integer, nullable
  - `processed_uuids` string[]: UUIDs of contents effectively processed by execute
  - `blocked_examples` CompanyContentBulkBlockedExample[]
    - `content_uuid` string, uuid4, nullable
    - `name` string, nullable
    - `reason` string, required
  - `blocked_reasons` object

## Other responses

- `404`: Not found
- `422`: Validation Error

---

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