# Mass action on companies

Perform a bulk action on companies matching a filter.

Endpoint: PUT /leads/api/companies/mass-action
Version: 2.0.0
Security: bearerAuth

## Request fields (application/json):

  - `type` (string, required)
    Action type.
    Enum: "company_add_tags", "company_remove_tags", "company_replace_tags", "company_change_pipeline_stage", "company_delete"

  - `filter` (object, required)
    Filter to select companies.

  - `payload` (object)
    Action-specific payload.

## Response 422 fields (application/json):

  - `error` (object)

  - `error.reason` (string)
    Machine-readable error code: validation_error, bad_request, auth_exception, access_denied, payment_required.
    Example: "validation_error"

  - `error.message` (string)
    Example: "The name field is required."

  - `error.data` (object)
    Field-level validation errors (field name → messages).

  - `message` (string)
    Example: "The given data was invalid."

  - `code` (integer)
    Example: 422


## Response 200 fields