---
title: "Bulk Interactions"
method: POST
path: "/api/companies/{company_uuid}/interactions/bulk"
tags: ["company-interactions"]
---

# Bulk Interactions

`POST /api/companies/{company_uuid}/interactions/bulk`

## 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}/interactions/bulk`
- Auth: HTTP bearer

## Path parameters

- `company_uuid` string, uuid, required

## Headers

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

## Request body

- CompanyInteractionBulkRequest: Request schema for bulk interaction operations.
  - `action` 'delete' | 'update_sentiment' | 'add_collections' | 'remove_collections', required: Supported bulk actions for company interactions.
  - `sentiment` 'negative' | 'neutral' | 'positive', nullable: Target sentiment for update_sentiment bulk action
  - `search` string, nullable: Current list search term
  - `country_id` integer[], nullable: Current list country ID filters
  - `organization_uuid` string[], nullable: Current list organization UUID filters
  - `contact_uuid` string[], nullable: Current list contact UUID filters
  - `user_uuid` string[], nullable: Current list user UUID filters
  - `start_date` string, date-time, nullable: Current list start date filter
  - `end_date` string, date-time, nullable: Current list end date filter
  - `status` string[], nullable: Current list status filters
  - `sort_by` string, nullable: Current list sort field
  - `sort_order` string, nullable: Current list sort order
  - `include_company_interaction_uuids` string[], nullable: Manual interaction UUID selection. When present, filters are ignored.
  - `exclude_company_interaction_uuids` string[], nullable: Interaction UUIDs excluded from a filtered bulk selection
  - `collection_list` string[], nullable: Current list collection name filters
  - `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

## Response `200`

Successful Response

- CompanyInteractionBulkResponse: Response schema for bulk interaction preview and execution.
  - `action` 'delete' | 'update_sentiment' | 'add_collections' | 'remove_collections', required: Supported bulk actions for company interactions.
  - `eligible_count` integer, required
  - `blocked_count` integer, required
  - `processed_count` integer, nullable
  - `processed_uuids` string[]: UUIDs of interactions effectively processed by execute
  - `blocked_examples` CompanyInteractionBulkBlockedExample[]
    - `company_interaction_uuid` string, uuid4, nullable
    - `title` 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)