Skip to main content

Remove companies from workspace

Queue removal of selected promoted Companies from the Companies workspace without deleting Company memory.

POST/api/companies/delete
HTTP referenceScope companies:writeUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

Despite the legacy /delete path, this command does not delete Company memory. It queues removal/demotion of promoted Company workspace records; a successful response confirms job admission, not completion. With mode=ids, the response includes matched/queued counts; descriptor selections are resolved asynchronously and those counts may be null.

Body parameters

  • selectionrequired

    object

    BulkSelectionModel. mode is ids (requires non-empty ids) or descriptor (requires descriptor); optional fields include search, sort, limit, scope, source_table_id, source_table_scope, and include_skipped. Do not send filter/filters aliases inside selection; descriptor selection must not include ids.

Errors

StatusMeaning
400Invalid selection or descriptor filter.
401Invalid API key or missing organization/user context.
403Missing companies:write scope.
404No companies found for an explicit ID selection.
409A conflicting company workspace mutation is already active.

Docs