Company Lists

Remove Companies From List

Changed on

Remove companies from one of the team's company lists by their company IDs. Only their place in this list goes: the companies, and any other list that holds them, are not affected.

post/v0/company_lists/{list_id}/remove_companies

Request

  • Base URL
    https://api.theirstack.com
  • URL
    https://api.theirstack.com/v0/company_lists/{list_id}/remove_companies
  • Auth
    HTTP bearer

Path parameters

list_idinteger required

Request body

company_idsstring[]

Company IDs to remove, the id of each company in a company search result

Example request

{
  "company_ids": [
    "jzZtZUAlXO/EX2wK4o6/Jw=="
  ]
}

Response

Successful Response

namestring required

Name of the company list

idinteger required
created_atstring date-time required
deletableboolean nullable

Whether the list can be deleted

companies_countinteger

Number of companies in the list

user_idinteger nullable

User ID of the list owner

type'REVEALED_COMPANIES' | 'WEBHOOK_TRIGGERED' | 'MANUAL_CREATION' | 'EXPORT_SNAPSHOT' | 'INTERNAL_WEBHOOK_TRIGGERED' | 'CUSTOMER_CRM_SYNC'
webhook_idinteger nullable

Webhook ID of the list

customer_crm_connection_idinteger nullable

CRM connection that keeps this list in sync (CUSTOMER_CRM_SYNC lists)

Changes

  • 419602bcfbf6Revision changes
    • warning

      added the new CUSTOMER_CRM_SYNC enum value to the / response property for the response status

    • info

      added the optional property to the response with the status

  • acc7d199f39aRevision changes
    • warning

      added the new INTERNAL_WEBHOOK_TRIGGERED enum value to the / response property for the response status