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

# Bulk Organizations

`POST /api/companies/{company_uuid}/organizations/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}/organizations/bulk`
- Auth: HTTP bearer

## Path parameters

- `company_uuid` string, uuid, required

## Headers

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

## Request body

- CompanyOrganizationBulkRequest: Request schema for bulk organization operations.
  - `action` 'delete' | 'select' | 'deselect' | 'add_collections' | 'remove_collections' | 'restore' | 'add_groups' | 'remove_groups' | 'replace_groups', required: Supported bulk actions for organizations.
  - `selected` boolean, nullable: Current list filter by selection status
  - `search` string, nullable: Current list search term
  - `country_id` integer, nullable: Current list country filter
  - `organization_type` TypeEnum[], nullable: Current list organization type filters
  - `government_body_type` GovernmentBodyTypeEnum[], nullable: Current list government body role filters
  - `service_provider_type` ServiceProviderTypeEnum[], nullable: Current list service provider subtype filters
  - `regulatory_scope` RegulatoryScopeEnum[], nullable: Current list regulatory scope filters
  - `regulatory_power` RegulatoryPowerEnum[], nullable: Current list regulatory power filters
  - `institutional_form` InstitutionalFormEnum[], nullable: Current list institutional form filters
  - `collection_list` string[], nullable: Current list collection name filters
  - `sort_by` string, nullable: Current list sort field
  - `sort_order` string, nullable: Current list sort order
  - `user_uuid` string, uuid4, nullable: Current list owner filter
  - `include_organization_uuids` string[], nullable: Manual organization UUID selection. When present, filters are ignored.
  - `exclude_organization_uuids` string[], nullable: Organization UUIDs excluded from a filtered bulk selection
  - `group_uuid_list` string[], nullable: Current list area (group) filter
  - `unassigned_group` boolean: Current list filter: organizations without area
  - `group_uuids` string[], nullable: Areas (groups) applied by add_groups/remove_groups/replace_groups
  - `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

- CompanyOrganizationBulkResponse: Response schema for bulk organization preview and execution.
  - `action` 'delete' | 'select' | 'deselect' | 'add_collections' | 'remove_collections' | 'restore' | 'add_groups' | 'remove_groups' | 'replace_groups', required: Supported bulk actions for organizations.
  - `eligible_count` integer, required
  - `blocked_count` integer, required
  - `processed_count` integer, nullable
  - `processed_uuids` string[]: UUIDs of organizations effectively processed by execute
  - `blocked_examples` CompanyOrganizationBulkBlockedExample[]
    - `organization_uuid` string, uuid4, nullable
    - `name` string, nullable
    - `reason` string, required
  - `blocked_reasons` object
  - `eligible_examples` CompanyOrganizationBulkSample[]: Amostra (até 20) das organizações afetadas; usada no dry run
    - `organization_uuid` string, uuid4, required
    - `name` string, nullable

## Other responses

- `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)