---
title: "Company Watchlist Batch Delete Entries"
method: POST
path: "/watchlists/companies/{id_or_urn}/entries:batchDelete"
tags: ["companies"]
---

# Company Watchlist Batch Delete Entries

`POST /watchlists/companies/{id_or_urn}/entries:batchDelete`

## Request

- Base URL: `https://api.harmonic.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.harmonic.ai/watchlists/companies/{id_or_urn}/entries:batchDelete`
- Auth: none declared
- TypeScript: <https://skmtc.dev/harmonic/apis/harmonic-ai-public-api/docs/watchlists/companies/:id_or_urn/entries:batchDelete/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id_or_urn` union, required
  - integer
  - string, uuid
  - string

## Request body

- CompanyListEntriesBatchDeleteInput
  - `entries` CompanyListEntryInput[], required
    - `company_urn` string, nullable
    - `canonical` CompanyCanonicalParameter
      - `linkedin_url` string, nullable
      - `crunchbase_url` string, nullable
      - `pitchbook_url` string, nullable
      - `website_url` string, nullable
    - `values` CompanyFieldInputValue[]
      - `custom_field_urn` union, required
        - string
        - string
        - string
        - string
      - `data` union, required
        - CheckboxListCustomFieldValue
          - `value` boolean, nullable
        - NumberListCustomFieldValue
          - `value` number, nullable
        - TextListCustomFieldValue
          - `value` string, nullable
        - SingleListSelectCustomFieldValue
          - `value` string, nullable
        - MultiSelectListCustomFieldValue
          - `value` string[]
        - PersonSelectCustomFieldValue
          - `value` string[]
        - DateListCustomFieldValue
          - `value` string, nullable
        - WebsiteListCustomFieldValue
          - `value` string, nullable
        - StatusListCustomFieldValue
          - `value` string, nullable
        - PersonSelectCustomFieldValueInput
          - `value` union[]
            - union
              - …
        - RecordReferenceListCustomFieldValue
          - `value` string[]
    - `external_display_name` string, nullable
    - `external_id` string, nullable
    - `external_entry` UnifiedExternalCompanyListEntryModel
      - `id` string, nullable
      - `list_id` string, required
      - `target_list_urn` string, required
      - `entity_id` string, nullable
      - `entity_type` string, nullable
      - `added_at` string, nullable
      - `updated_at` string, nullable
      - `canonical` CompanyCanonicalParameter
        - `linkedin_url` string, nullable
        - `crunchbase_url` string, nullable
        - `pitchbook_url` string, nullable
        - `website_url` string, nullable
      - `label` string, nullable
      - `integration_provider` string, required

## Response `200`

Successful Response

- CompanyListEntriesBatchDeleteOutput
  - `urns` string[]

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-16** `c6f98176f3d7`: 1 info
  - added `subschema #4: IntegrationAttributeUrn` to the `entries/items/values/items/custom_field_urn` request property `anyOf` list
- **2026-08-19** `fbef1ba78f96`: 1 breaking
  - removed `#/components/schemas/OwnerListCustomFieldValue, #/components/schemas/EmailListCustomFieldValue, #/components/schemas/OwnerSelectCustomFieldValueInput` from the `entries/items/values/items/data` request property `anyOf` list
- **2026-08-19** `2100d53a6676`: 1 info
  - added `#/components/schemas/OwnerListCustomFieldValue, #/components/schemas/EmailListCustomFieldValue, #/components/schemas/OwnerSelectCustomFieldValueInput` to the `entries/items/values/items/data` request property `anyOf` list
- **2026-07-26** `fcf35c98e097`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/harmonic/apis/harmonic-ai-public-api/changes/watchlists/companies/:id_or_urn/entries:batchDelete/post.md)

---

[API](https://skmtc.dev/harmonic/apis/harmonic-ai-public-api.md) - [All operations](https://skmtc.dev/harmonic/apis/harmonic-ai-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/harmonic/apis/harmonic-ai-public-api/revisions/3aef619bb9e3?raw)