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
selectionrequiredobject
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.
| Name | Type | Description |
|---|---|---|
| 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
| Status | Meaning |
|---|---|
| 400 | Invalid selection or descriptor filter. |
| 401 | Invalid API key or missing organization/user context. |
| 403 | Missing companies:write scope. |
| 404 | No companies found for an explicit ID selection. |
| 409 | A conflicting company workspace mutation is already active. |
