newscatcher-catchall-sdk 1.5.1 → 3.0.0

package/reference.md

@@ -27,7 +27,9 @@ Returns all jobs created by the authenticated user.
 <dd>
 
 ```typescript
-await client.jobs.getUserJobs();
+await client.jobs.getUserJobs({
+    project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+});
 
 ```
 </dd>
@@ -59,6 +61,73 @@ await client.jobs.getUserJobs();
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.jobs.<a href="/src/api/resources/jobs/client/Client.ts">validateQuery</a>({ ...params }) -> CatchAllApi.ValidateQueryResponseDto</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Checks whether a query is well-formed and likely to produce good results before submitting a job.
+
+Returns a quality assessment with a status level, identified issues, and actionable suggestions.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.jobs.validateQuery({
+    query: "Series B funding rounds for SaaS startups"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.ValidateQueryRequestDto` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `JobsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -407,11 +476,9 @@ await client.jobs.continueJob({
 <dl>
 <dd>
 
-Soft-deletes a job. The job is flagged as deleted and no longer
-appears in list results. The underlying data is retained.
+Soft-deletes a job. The job is flagged as deleted and no longer appears in list results. The underlying data is retained.
 
-Only the job owner can delete a job. Returns `404` if the job is not
-found or does not belong to the authenticated user.
+Only the job owner can delete a job. Returns `404` if the job is not found or does not belong to the authenticated user.
 
 Deleting an already-deleted job returns `200`.
 </dd>
@@ -494,7 +561,9 @@ Returns all monitors created by the authenticated user.
 <dd>
 
 ```typescript
-await client.monitors.listMonitors();
+await client.monitors.listMonitors({
+    project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+});
 
 ```
 </dd>
@@ -559,14 +628,9 @@ Create a scheduled monitor based on a reference job.
 ```typescript
 await client.monitors.createMonitor({
     reference_job_id: "5f0c9087-85cb-4917-b3c7-e5a5eff73a0c",
-    schedule: "every day at 12 PM UTC",
-    webhook: {
-        url: "https://your-endpoint.com/webhook",
-        method: "POST",
-        headers: {
-            "Authorization": "Bearer your_token_here"
-        }
-    },
+    schedule: "every day at 12 PM",
+    timezone: "UTC",
+    webhook_ids: ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
     limit: 10,
     backfill: true
 });
@@ -1032,13 +1096,7 @@ Update the webhook configuration for an existing monitor.
 ```typescript
 await client.monitors.updateMonitor({
     monitor_id: "monitor_id",
-    webhook: {
-        url: "https://new-endpoint.com/webhook",
-        method: "POST",
-        headers: {
-            "Authorization": "Bearer new_token_xyz"
-        }
-    }
+    webhook_ids: ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"]
 });
 
 ```
@@ -1075,8 +1133,8 @@ await client.monitors.updateMonitor({
 </dl>
 </details>
 
-## Entities
-<details><summary><code>client.entities.<a href="/src/api/resources/entities/client/Client.ts">listEntities</a>({ ...params }) -> CatchAllApi.EntityListResponse</code></summary>
+## Webhooks
+<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">listWebhooks</a>({ ...params }) -> CatchAllApi.ListWebhooksResponseDto</code></summary>
 <dl>
 <dd>
 
@@ -1088,9 +1146,7 @@ await client.monitors.updateMonitor({
 <dl>
 <dd>
 
-Returns a paginated list of entities belonging to the authenticated
-organization. Supports filtering by status and entity type, and
-sorting by name, status, or creation date.
+Returns a paginated list of webhooks belonging to the organization.
 </dd>
 </dl>
 </dd>
@@ -1105,9 +1161,7 @@ sorting by name, status, or creation date.
 <dd>
 
 ```typescript
-await client.entities.listEntities({
-    search: "NewsCatcher"
-});
+await client.webhooks.listWebhooks();
 
 ```
 </dd>
@@ -1123,7 +1177,7 @@ await client.entities.listEntities({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.ListEntitiesRequest` 
+**request:** `CatchAllApi.ListWebhooksRequest` 
     
 </dd>
 </dl>
@@ -1131,7 +1185,7 @@ await client.entities.listEntities({
 <dl>
 <dd>
 
-**requestOptions:** `EntitiesClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1143,7 +1197,7 @@ await client.entities.listEntities({
 </dl>
 </details>
 
-<details><summary><code>client.entities.<a href="/src/api/resources/entities/client/Client.ts">createEntity</a>({ ...params }) -> CatchAllApi.CreateEntityResponse</code></summary>
+<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">createWebhook</a>({ ...params }) -> CatchAllApi.CreateWebhookResponseDto</code></summary>
 <dl>
 <dd>
 
@@ -1155,12 +1209,7 @@ await client.entities.listEntities({
 <dl>
 <dd>
 
-Creates a new company entity and begins background enrichment.
-
-The entity status starts as `pending` and transitions to `ready` once
-enrichment completes. Provide as much identifying information as
-possible — `domain` is the highest-signal field because it is
-unambiguous.
+Creates a new webhook endpoint for the organization.
 </dd>
 </dl>
 </dd>
@@ -1175,17 +1224,11 @@ unambiguous.
 <dd>
 
 ```typescript
-await client.entities.createEntity({
-    name: "NewsCatcher",
-    entity_type: "company",
-    description: "AI-powered news data provider",
-    additional_attributes: {
-        company_attributes: {
-            domain: "newscatcherapi.com",
-            key_persons: ["Artem Bugara", "Maksym Sugonyaka"],
-            alternative_names: ["NC", "NewsCatcher API"]
-        }
-    }
+await client.webhooks.createWebhook({
+    name: "Layoffs Alert",
+    url: "https://hooks.slack.com/services/T000/B000/xxx",
+    type: "slack",
+    delivery_mode: "full"
 });
 
 ```
@@ -1202,7 +1245,7 @@ await client.entities.createEntity({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.CreateEntityRequest` 
+**request:** `CatchAllApi.CreateWebhookRequestDto` 
     
 </dd>
 </dl>
@@ -1210,7 +1253,7 @@ await client.entities.createEntity({
 <dl>
 <dd>
 
-**requestOptions:** `EntitiesClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1222,7 +1265,7 @@ await client.entities.createEntity({
 </dl>
 </details>
 
-<details><summary><code>client.entities.<a href="/src/api/resources/entities/client/Client.ts">createEntitiesBatch</a>({ ...params }) -> CatchAllApi.CreateEntitiesBatchResponse</code></summary>
+<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">getWebhook</a>({ ...params }) -> CatchAllApi.GetWebhookResponseDto</code></summary>
 <dl>
 <dd>
 
@@ -1234,11 +1277,7 @@ await client.entities.createEntity({
 <dl>
 <dd>
 
-Creates multiple entities in a single request. Each entity is
-processed independently — a failure in one does not affect others.
-
-Returns an array of `{id, status}` objects in the same order as
-the input array.
+Returns the full configuration of a single webhook by ID.
 </dd>
 </dl>
 </dd>
@@ -1253,29 +1292,8 @@ the input array.
 <dd>
 
 ```typescript
-await client.entities.createEntitiesBatch({
-    entities: [{
-            name: "OpenAI",
-            entity_type: "company",
-            description: "Artificial intelligence research company",
-            additional_attributes: {
-                company_attributes: {
-                    domain: "openai.com",
-                    key_persons: ["Sam Altman"],
-                    alternative_names: ["Open AI"]
-                }
-            }
-        }, {
-            name: "Stripe",
-            entity_type: "company",
-            description: "Online payment processing platform",
-            additional_attributes: {
-                company_attributes: {
-                    domain: "stripe.com",
-                    key_persons: ["Patrick Collison", "John Collison"]
-                }
-            }
-        }]
+await client.webhooks.getWebhook({
+    webhook_id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
 });
 
 ```
@@ -1292,7 +1310,7 @@ await client.entities.createEntitiesBatch({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.CreateEntitiesBatchRequest` 
+**request:** `CatchAllApi.GetWebhookRequest` 
     
 </dd>
 </dl>
@@ -1300,7 +1318,7 @@ await client.entities.createEntitiesBatch({
 <dl>
 <dd>
 
-**requestOptions:** `EntitiesClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1312,7 +1330,7 @@ await client.entities.createEntitiesBatch({
 </dl>
 </details>
 
-<details><summary><code>client.entities.<a href="/src/api/resources/entities/client/Client.ts">getEntity</a>({ ...params }) -> CatchAllApi.EntityResponse</code></summary>
+<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">deleteWebhook</a>({ ...params }) -> void</code></summary>
 <dl>
 <dd>
 
@@ -1324,7 +1342,9 @@ await client.entities.createEntitiesBatch({
 <dl>
 <dd>
 
-Returns a single entity by ID with all attributes and current status.
+Permanently deletes a webhook and removes all resource assignments. 
+
+Assigned jobs and monitors no longer trigger delivery to this webhook. This operation cannot be undone.
 </dd>
 </dl>
 </dd>
@@ -1339,8 +1359,8 @@ Returns a single entity by ID with all attributes and current status.
 <dd>
 
 ```typescript
-await client.entities.getEntity({
-    entity_id: "854198fa-f702-49db-a381-0427fa87f173"
+await client.webhooks.deleteWebhook({
+    webhook_id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
 });
 
 ```
@@ -1357,7 +1377,7 @@ await client.entities.getEntity({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.GetEntityRequest` 
+**request:** `CatchAllApi.DeleteWebhookRequest` 
     
 </dd>
 </dl>
@@ -1365,7 +1385,7 @@ await client.entities.getEntity({
 <dl>
 <dd>
 
-**requestOptions:** `EntitiesClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1377,7 +1397,7 @@ await client.entities.getEntity({
 </dl>
 </details>
 
-<details><summary><code>client.entities.<a href="/src/api/resources/entities/client/Client.ts">deleteEntity</a>({ ...params }) -> void</code></summary>
+<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">updateWebhook</a>({ ...params }) -> CatchAllApi.UpdateWebhookResponseDto</code></summary>
 <dl>
 <dd>
 
@@ -1389,8 +1409,7 @@ await client.entities.getEntity({
 <dl>
 <dd>
 
-Permanently deletes an entity. The entity is removed from all
-datasets and the search index. This operation cannot be undone.
+Updates one or more fields of an existing webhook.
 </dd>
 </dl>
 </dd>
@@ -1405,8 +1424,10 @@ datasets and the search index. This operation cannot be undone.
 <dd>
 
 ```typescript
-await client.entities.deleteEntity({
-    entity_id: "854198fa-f702-49db-a381-0427fa87f173"
+await client.webhooks.updateWebhook({
+    webhook_id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+    name: "Layoffs Alert (EU)",
+    is_active: false
 });
 
 ```
@@ -1423,7 +1444,7 @@ await client.entities.deleteEntity({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.DeleteEntityRequest` 
+**request:** `CatchAllApi.UpdateWebhookRequestDto` 
     
 </dd>
 </dl>
@@ -1431,7 +1452,7 @@ await client.entities.deleteEntity({
 <dl>
 <dd>
 
-**requestOptions:** `EntitiesClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1443,7 +1464,7 @@ await client.entities.deleteEntity({
 </dl>
 </details>
 
-<details><summary><code>client.entities.<a href="/src/api/resources/entities/client/Client.ts">updateEntity</a>({ ...params }) -> CatchAllApi.EntityResponse</code></summary>
+<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">testWebhook</a>({ ...params }) -> CatchAllApi.TestWebhookResponseDto</code></summary>
 <dl>
 <dd>
 
@@ -1455,7 +1476,9 @@ await client.entities.deleteEntity({
 <dl>
 <dd>
 
-Updates one or more fields of an existing entity.
+Sends a test HTTP request to the webhook URL using the webhook's configured method, headers, and auth. Returns the response from the target endpoint.
+
+Use this to verify URL reachability and authentication before attaching the webhook to a live job or monitor.
 </dd>
 </dl>
 </dd>
@@ -1470,13 +1493,11 @@ Updates one or more fields of an existing entity.
 <dd>
 
 ```typescript
-await client.entities.updateEntity({
-    entity_id: "854198fa-f702-49db-a381-0427fa87f173",
-    description: "Updated description",
-    additional_attributes: {
-        company_attributes: {
-            alternative_names: ["NC", "NewsCatcher API", "NCA"]
-        }
+await client.webhooks.testWebhook({
+    webhook_id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+    payload: {
+        "test": true,
+        "message": "CatchAll webhook test"
     }
 });
 
@@ -1494,7 +1515,7 @@ await client.entities.updateEntity({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.UpdateEntityRequest` 
+**request:** `CatchAllApi.TestWebhookRequestDto` 
     
 </dd>
 </dl>
@@ -1502,7 +1523,7 @@ await client.entities.updateEntity({
 <dl>
 <dd>
 
-**requestOptions:** `EntitiesClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1514,8 +1535,7 @@ await client.entities.updateEntity({
 </dl>
 </details>
 
-## Datasets
-<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">listDatasets</a>({ ...params }) -> CatchAllApi.DatasetListResponse</code></summary>
+<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">listWebhookResources</a>({ ...params }) -> CatchAllApi.ListWebhookResourcesResponseDto</code></summary>
 <dl>
 <dd>
 
@@ -1527,9 +1547,7 @@ await client.entities.updateEntity({
 <dl>
 <dd>
 
-Returns a paginated list of datasets belonging to the authenticated
-organization. Supports filtering by status and sorting by name,
-status, or creation date.
+Returns a paginated list of resources currently assigned to this webhook.
 </dd>
 </dl>
 </dd>
@@ -1544,8 +1562,8 @@ status, or creation date.
 <dd>
 
 ```typescript
-await client.datasets.listDatasets({
-    search: "Portfolio"
+await client.webhooks.listWebhookResources({
+    webhook_id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
 });
 
 ```
@@ -1562,7 +1580,7 @@ await client.datasets.listDatasets({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.ListDatasetsRequest` 
+**request:** `CatchAllApi.ListWebhookResourcesRequest` 
     
 </dd>
 </dl>
@@ -1570,7 +1588,7 @@ await client.datasets.listDatasets({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1582,7 +1600,7 @@ await client.datasets.listDatasets({
 </dl>
 </details>
 
-<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">createDataset</a>({ ...params }) -> CatchAllApi.DatasetResponse</code></summary>
+<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">assignWebhookResource</a>({ ...params }) -> CatchAllApi.AssignWebhookResourceResponseDto</code></summary>
 <dl>
 <dd>
 
@@ -1594,14 +1612,11 @@ await client.datasets.listDatasets({
 <dl>
 <dd>
 
-Creates a new dataset from a list of existing entity IDs.
-
-If any of the provided entity IDs do not exist or do not belong to
-your organization, the request fails with `400`. All entity IDs must
-be valid before the dataset is created.
+Attaches a job, monitor, or monitor group to the webhook. When the
+resource completes, the webhook receives a delivery.
 
-To create a dataset and entities in one step, use the [`Create dataset from CSV`](https://www.newscatcherapi.com/docs/web-search-api/api-reference/datasets/create-dataset-from-csv)
-endpoint instead.
+A single webhook can be assigned to multiple resources. Each resource
+can have up to 5 webhooks assigned.
 </dd>
 </dl>
 </dd>
@@ -1616,10 +1631,10 @@ endpoint instead.
 <dd>
 
 ```typescript
-await client.datasets.createDataset({
-    name: "My Portfolio",
-    description: "Companies in our investment portfolio",
-    entity_ids: ["854198fa-f702-49db-a381-0427fa87f173", "a1b2c3d4-e5f6-7890-abcd-ef1234567890"]
+await client.webhooks.assignWebhookResource({
+    webhook_id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+    resource_type: "monitor",
+    resource_id: "3fec5b07-8786-46d7-9486-d43ff67eccd4"
 });
 
 ```
@@ -1636,7 +1651,7 @@ await client.datasets.createDataset({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.CreateDatasetRequest` 
+**request:** `CatchAllApi.AssignWebhookResourceRequestDto` 
     
 </dd>
 </dl>
@@ -1644,7 +1659,7 @@ await client.datasets.createDataset({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1656,7 +1671,7 @@ await client.datasets.createDataset({
 </dl>
 </details>
 
-<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">createDatasetFromCsv</a>({ ...params }) -> CatchAllApi.CreateDatasetCsvResponse</code></summary>
+<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">removeWebhookResource</a>({ ...params }) -> void</code></summary>
 <dl>
 <dd>
 
@@ -1668,20 +1683,9 @@ await client.datasets.createDataset({
 <dl>
 <dd>
 
-Creates a new dataset by uploading a CSV file. Each row in the CSV
-becomes an entity. The `name` column is required; all other columns
-are optional.
-
-**CSV format:**
-```csv
-name,description,domain,alternative_names,key_persons
-NewsCatcher,"AI-powered news data provider",newscatcherapi.com,"NC;NewsCatcher API","Artem Bugara;Maksym Sugonyaka"
-OpenAI,"Artificial intelligence research company",openai.com,"Open AI","Sam Altman"
-```
-
-Use semicolons (`;`) to separate multiple values in `alternative_names` and `key_persons`. Rows with empty `name` are skipped and reported in `validation_report`. 
+Detaches a resource from this webhook. Completions of the resource no longer trigger delivery to this webhook.
 
-**Note**: The response shape differs from the JSON dataset creation endpoint: it returns `dataset_id` (not `id`) and includes a `validation_report` with details on skipped rows.
+The webhook and the resource itself are not deleted.
 </dd>
 </dl>
 </dd>
@@ -1696,9 +1700,10 @@ Use semicolons (`;`) to separate multiple values in `alternative_names` and `key
 <dd>
 
 ```typescript
-await client.datasets.createDatasetFromCsv({
-    file: fs.createReadStream("/path/to/your/file"),
-    name: "name"
+await client.webhooks.removeWebhookResource({
+    webhook_id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+    resource_type: "job",
+    resource_id: "3fec5b07-8786-46d7-9486-d43ff67eccd4"
 });
 
 ```
@@ -1715,7 +1720,7 @@ await client.datasets.createDatasetFromCsv({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.CreateDatasetFromCsvRequest` 
+**request:** `CatchAllApi.RemoveWebhookResourceRequest` 
     
 </dd>
 </dl>
@@ -1723,7 +1728,7 @@ await client.datasets.createDatasetFromCsv({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1735,7 +1740,7 @@ await client.datasets.createDatasetFromCsv({
 </dl>
 </details>
 
-<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">getDataset</a>({ ...params }) -> CatchAllApi.DatasetResponse</code></summary>
+<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">listWebhooksForResource</a>({ ...params }) -> CatchAllApi.ListWebhooksResponseDto</code></summary>
 <dl>
 <dd>
 
@@ -1747,7 +1752,7 @@ await client.datasets.createDatasetFromCsv({
 <dl>
 <dd>
 
-Returns a single dataset by ID including entity count and current status.
+Returns all webhooks currently assigned to the given resource.
 </dd>
 </dl>
 </dd>
@@ -1762,8 +1767,9 @@ Returns a single dataset by ID including entity count and current status.
 <dd>
 
 ```typescript
-await client.datasets.getDataset({
-    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2"
+await client.webhooks.listWebhooksForResource({
+    resource_type: "job",
+    resource_id: "3fec5b07-8786-46d7-9486-d43ff67eccd4"
 });
 
 ```
@@ -1780,7 +1786,7 @@ await client.datasets.getDataset({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.GetDatasetRequest` 
+**request:** `CatchAllApi.ListWebhooksForResourceRequest` 
     
 </dd>
 </dl>
@@ -1788,7 +1794,7 @@ await client.datasets.getDataset({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1800,7 +1806,7 @@ await client.datasets.getDataset({
 </dl>
 </details>
 
-<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">deleteDataset</a>({ ...params }) -> void</code></summary>
+<details><summary><code>client.webhooks.<a href="/src/api/resources/webhooks/client/Client.ts">getWebhookDeliveryHistory</a>({ ...params }) -> CatchAllApi.DeliveryHistoryResponseDto</code></summary>
 <dl>
 <dd>
 
@@ -1812,9 +1818,9 @@ await client.datasets.getDataset({
 <dl>
 <dd>
 
-Permanently deletes a dataset. The entities within the dataset are
-not deleted — only the dataset itself. This operation cannot be
-undone.
+Returns a paginated delivery log for a given resource, ordered by timestamp descending. 
+
+Each record shows the webhook dispatched, the HTTP status code returned, delivery outcome, and any error or warning messages. Use this to debug failed deliveries or audit dispatch activity.
 </dd>
 </dl>
 </dd>
@@ -1829,8 +1835,9 @@ undone.
 <dd>
 
 ```typescript
-await client.datasets.deleteDataset({
-    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2"
+await client.webhooks.getWebhookDeliveryHistory({
+    resource_type: "job",
+    resource_id: "3fec5b07-8786-46d7-9486-d43ff67eccd4"
 });
 
 ```
@@ -1847,7 +1854,7 @@ await client.datasets.deleteDataset({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.DeleteDatasetRequest` 
+**request:** `CatchAllApi.GetWebhookDeliveryHistoryRequest` 
     
 </dd>
 </dl>
@@ -1855,7 +1862,7 @@ await client.datasets.deleteDataset({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1867,7 +1874,8 @@ await client.datasets.deleteDataset({
 </dl>
 </details>
 
-<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">updateDataset</a>({ ...params }) -> CatchAllApi.DatasetResponse</code></summary>
+## Entities
+<details><summary><code>client.entities.<a href="/src/api/resources/entities/client/Client.ts">listEntities</a>({ ...params }) -> CatchAllApi.EntityListResponse</code></summary>
 <dl>
 <dd>
 
@@ -1879,7 +1887,7 @@ await client.datasets.deleteDataset({
 <dl>
 <dd>
 
-Updates the name or description of a dataset.
+Returns a paginated list of entities belonging to the authenticated organization. Supports filtering by status and entity type, and sorting by name, status, or creation date.
 </dd>
 </dl>
 </dd>
@@ -1894,10 +1902,8 @@ Updates the name or description of a dataset.
 <dd>
 
 ```typescript
-await client.datasets.updateDataset({
-    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2",
-    name: "My Portfolio (updated)",
-    description: "Updated Q1 2026 watchlist"
+await client.entities.listEntities({
+    search: "NewsCatcher"
 });
 
 ```
@@ -1914,7 +1920,7 @@ await client.datasets.updateDataset({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.UpdateDatasetRequest` 
+**request:** `CatchAllApi.ListEntitiesRequest` 
     
 </dd>
 </dl>
@@ -1922,7 +1928,7 @@ await client.datasets.updateDataset({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `EntitiesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1934,7 +1940,7 @@ await client.datasets.updateDataset({
 </dl>
 </details>
 
-<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">listEntitiesInDataset</a>({ ...params }) -> CatchAllApi.DatasetEntityListResponse</code></summary>
+<details><summary><code>client.entities.<a href="/src/api/resources/entities/client/Client.ts">createEntity</a>({ ...params }) -> CatchAllApi.CreateEntityResponse</code></summary>
 <dl>
 <dd>
 
@@ -1946,7 +1952,12 @@ await client.datasets.updateDataset({
 <dl>
 <dd>
 
-Returns a paginated list of entities in a dataset. Supports filtering by status and entity type.
+Creates a new company entity and begins background enrichment.
+
+The entity status starts as `pending` and transitions to `ready` once
+enrichment completes. Provide as much identifying information as
+possible — `domain` is the highest-signal field because it is
+unambiguous.
 </dd>
 </dl>
 </dd>
@@ -1961,8 +1972,17 @@ Returns a paginated list of entities in a dataset. Supports filtering by status
 <dd>
 
 ```typescript
-await client.datasets.listEntitiesInDataset({
-    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2"
+await client.entities.createEntity({
+    name: "NewsCatcher",
+    entity_type: "company",
+    description: "AI-powered news data provider",
+    additional_attributes: {
+        company_attributes: {
+            domain: "newscatcherapi.com",
+            key_persons: ["Artem Bugara", "Maksym Sugonyaka"],
+            alternative_names: ["NC", "NewsCatcher API"]
+        }
+    }
 });
 
 ```
@@ -1979,7 +1999,7 @@ await client.datasets.listEntitiesInDataset({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.ListEntitiesInDatasetRequest` 
+**request:** `CatchAllApi.CreateEntityRequest` 
     
 </dd>
 </dl>
@@ -1987,7 +2007,7 @@ await client.datasets.listEntitiesInDataset({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `EntitiesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1999,7 +2019,7 @@ await client.datasets.listEntitiesInDataset({
 </dl>
 </details>
 
-<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">addEntitiesToDataset</a>({ ...params }) -> CatchAllApi.ManageEntitiesResponse</code></summary>
+<details><summary><code>client.entities.<a href="/src/api/resources/entities/client/Client.ts">createEntitiesBatch</a>({ ...params }) -> CatchAllApi.CreateEntitiesBatchResponse</code></summary>
 <dl>
 <dd>
 
@@ -2011,7 +2031,9 @@ await client.datasets.listEntitiesInDataset({
 <dl>
 <dd>
 
-Adds one or more existing entities to a dataset. Returns the number of entities added.
+Creates multiple entities in a single request. Each entity is processed independently — a failure in one does not affect others.
+
+Returns an array of `{id, status}` objects in the same order as the input array.
 </dd>
 </dl>
 </dd>
@@ -2026,28 +2048,46 @@ Adds one or more existing entities to a dataset. Returns the number of entities
 <dd>
 
 ```typescript
-await client.datasets.addEntitiesToDataset({
-    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2",
-    body: {
-        entity_ids: ["854198fa-f702-49db-a381-0427fa87f173"]
-    }
-});
-
-```
-</dd>
-</dl>
-</dd>
-</dl>
-
-#### ⚙️ Parameters
-
-<dl>
-<dd>
-
+await client.entities.createEntitiesBatch({
+    entities: [{
+            name: "OpenAI",
+            entity_type: "company",
+            description: "Artificial intelligence research company",
+            additional_attributes: {
+                company_attributes: {
+                    domain: "openai.com",
+                    key_persons: ["Sam Altman"],
+                    alternative_names: ["Open AI"]
+                }
+            }
+        }, {
+            name: "Stripe",
+            entity_type: "company",
+            description: "Online payment processing platform",
+            additional_attributes: {
+                company_attributes: {
+                    domain: "stripe.com",
+                    key_persons: ["Patrick Collison", "John Collison"]
+                }
+            }
+        }]
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
 <dl>
 <dd>
 
-**request:** `CatchAllApi.AddEntitiesToDatasetRequest` 
+<dl>
+<dd>
+
+**request:** `CatchAllApi.CreateEntitiesBatchRequest` 
     
 </dd>
 </dl>
@@ -2055,7 +2095,7 @@ await client.datasets.addEntitiesToDataset({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `EntitiesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -2067,7 +2107,7 @@ await client.datasets.addEntitiesToDataset({
 </dl>
 </details>
 
-<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">removeEntitiesFromDataset</a>({ ...params }) -> CatchAllApi.ManageEntitiesResponse</code></summary>
+<details><summary><code>client.entities.<a href="/src/api/resources/entities/client/Client.ts">getEntity</a>({ ...params }) -> CatchAllApi.EntityResponse</code></summary>
 <dl>
 <dd>
 
@@ -2079,9 +2119,7 @@ await client.datasets.addEntitiesToDataset({
 <dl>
 <dd>
 
-Removes one or more entities from a dataset. The entities themselves
-are not deleted — they are only removed from this dataset. Returns
-the number of entities removed.
+Returns a single entity by ID with all attributes and current status.
 </dd>
 </dl>
 </dd>
@@ -2096,10 +2134,144 @@ the number of entities removed.
 <dd>
 
 ```typescript
-await client.datasets.removeEntitiesFromDataset({
-    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2",
-    body: {
-        entity_ids: ["854198fa-f702-49db-a381-0427fa87f173"]
+await client.entities.getEntity({
+    entity_id: "854198fa-f702-49db-a381-0427fa87f173"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.GetEntityRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `EntitiesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.entities.<a href="/src/api/resources/entities/client/Client.ts">deleteEntity</a>({ ...params }) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Permanently deletes an entity. The entity is removed from all
+datasets and the search index. This operation cannot be undone.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.entities.deleteEntity({
+    entity_id: "854198fa-f702-49db-a381-0427fa87f173"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.DeleteEntityRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `EntitiesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.entities.<a href="/src/api/resources/entities/client/Client.ts">updateEntity</a>({ ...params }) -> CatchAllApi.EntityResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Updates one or more fields of an existing entity.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.entities.updateEntity({
+    entity_id: "854198fa-f702-49db-a381-0427fa87f173",
+    description: "Updated description",
+    additional_attributes: {
+        company_attributes: {
+            alternative_names: ["NC", "NewsCatcher API", "NCA"]
+        }
     }
 });
 
@@ -2117,7 +2289,7 @@ await client.datasets.removeEntitiesFromDataset({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.RemoveEntitiesFromDatasetRequest` 
+**request:** `CatchAllApi.UpdateEntityRequest` 
     
 </dd>
 </dl>
@@ -2125,7 +2297,7 @@ await client.datasets.removeEntitiesFromDataset({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `EntitiesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -2137,7 +2309,8 @@ await client.datasets.removeEntitiesFromDataset({
 </dl>
 </details>
 
-<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">getDatasetStatusHistory</a>({ ...params }) -> CatchAllApi.DatasetStatusHistoryResponse</code></summary>
+## Datasets
+<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">listDatasets</a>({ ...params }) -> CatchAllApi.DatasetListResponse</code></summary>
 <dl>
 <dd>
 
@@ -2149,8 +2322,7 @@ await client.datasets.removeEntitiesFromDataset({
 <dl>
 <dd>
 
-Returns the full status change history for a dataset, ordered
-chronologically from oldest to newest.
+Returns a paginated list of datasets belonging to the authenticated organization. Supports filtering by status and sorting by name, status, or creation date.
 </dd>
 </dl>
 </dd>
@@ -2165,8 +2337,9 @@ chronologically from oldest to newest.
 <dd>
 
 ```typescript
-await client.datasets.getDatasetStatusHistory({
-    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2"
+await client.datasets.listDatasets({
+    search: "Portfolio",
+    project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
 });
 
 ```
@@ -2183,7 +2356,7 @@ await client.datasets.getDatasetStatusHistory({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.GetDatasetStatusHistoryRequest` 
+**request:** `CatchAllApi.ListDatasetsRequest` 
     
 </dd>
 </dl>
@@ -2203,7 +2376,7 @@ await client.datasets.getDatasetStatusHistory({
 </dl>
 </details>
 
-<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">uploadCsvToDataset</a>({ ...params }) -> CatchAllApi.UploadCsvToDatasetResponse</code></summary>
+<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">createDataset</a>({ ...params }) -> CatchAllApi.DatasetResponse</code></summary>
 <dl>
 <dd>
 
@@ -2215,11 +2388,14 @@ await client.datasets.getDatasetStatusHistory({
 <dl>
 <dd>
 
-Appends new companies to an existing dataset by uploading a CSV file.
-Uses the same CSV format as the dataset creation endpoint.
+Creates a new dataset from a list of existing entity IDs.
+
+If any of the provided entity IDs do not exist or do not belong to
+your organization, the request fails with `400`. All entity IDs must
+be valid before the dataset is created.
 
-The response omits `dataset_name` compared to the create-from-CSV
-endpoint since the dataset already exists.
+To create a dataset and entities in one step, use the [`Create dataset from CSV`](https://www.newscatcherapi.com/docs/web-search-api/api-reference/datasets/create-dataset-from-csv)
+endpoint instead.
 </dd>
 </dl>
 </dd>
@@ -2234,9 +2410,10 @@ endpoint since the dataset already exists.
 <dd>
 
 ```typescript
-await client.datasets.uploadCsvToDataset({
-    file: fs.createReadStream("/path/to/your/file"),
-    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2"
+await client.datasets.createDataset({
+    name: "My Portfolio",
+    description: "Companies in our investment portfolio",
+    entity_ids: ["854198fa-f702-49db-a381-0427fa87f173", "a1b2c3d4-e5f6-7890-abcd-ef1234567890"]
 });
 
 ```
@@ -2253,7 +2430,7 @@ await client.datasets.uploadCsvToDataset({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.UploadCsvToDatasetRequest` 
+**request:** `CatchAllApi.CreateDatasetRequest` 
     
 </dd>
 </dl>
@@ -2269,6 +2446,1220 @@ await client.datasets.uploadCsvToDataset({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">createDatasetFromCsv</a>({ ...params }) -> CatchAllApi.CreateDatasetCsvResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Creates a new dataset by uploading a CSV file. Each row in the CSV becomes an entity. The `name` and `domain`columns are required; all other columns are optional.
+
+**CSV format:**
+```csv
+name,description,domain,alternative_names,key_persons
+NewsCatcher,"AI-powered news data provider",newscatcherapi.com,"NC;NewsCatcher API","Artem Bugara;Maksym Sugonyaka"
+OpenAI,"Artificial intelligence research company",openai.com,"Open AI","Sam Altman"
+```
+
+Use semicolons (`;`) to separate multiple values in `alternative_names` and `key_persons`. Rows with empty `name` are skipped and reported in `validation_report`. 
+
+**Note**: The response shape differs from the JSON dataset creation endpoint: it returns `dataset_id` (not `id`) and includes a `validation_report` with details on skipped rows.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.datasets.createDatasetFromCsv({
+    file: fs.createReadStream("/path/to/your/file"),
+    name: "name"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.CreateDatasetFromCsvRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `DatasetsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">getDataset</a>({ ...params }) -> CatchAllApi.DatasetResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns a single dataset by ID including entity count and current status.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.datasets.getDataset({
+    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.GetDatasetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `DatasetsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">deleteDataset</a>({ ...params }) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Permanently deletes a dataset. The entities within the dataset are
+not deleted — only the dataset itself. This operation cannot be
+undone.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.datasets.deleteDataset({
+    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.DeleteDatasetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `DatasetsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">updateDataset</a>({ ...params }) -> CatchAllApi.DatasetResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Updates the name or description of a dataset.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.datasets.updateDataset({
+    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2",
+    name: "My Portfolio (updated)",
+    description: "Updated Q1 2026 watchlist"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.UpdateDatasetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `DatasetsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">addEntitiesToDataset</a>({ ...params }) -> CatchAllApi.ManageEntitiesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Adds one or more existing entities to a dataset. Returns the number of entities added.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.datasets.addEntitiesToDataset({
+    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2",
+    body: {
+        entity_ids: ["854198fa-f702-49db-a381-0427fa87f173"]
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.AddEntitiesToDatasetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `DatasetsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">removeEntitiesFromDataset</a>({ ...params }) -> CatchAllApi.ManageEntitiesResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Removes one or more entities from a dataset. The entities themselves are not deleted — they are only removed from this dataset. Returns the number of entities removed.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.datasets.removeEntitiesFromDataset({
+    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2",
+    body: {
+        entity_ids: ["854198fa-f702-49db-a381-0427fa87f173"]
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.RemoveEntitiesFromDatasetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `DatasetsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">listEntitiesInDataset</a>({ ...params }) -> CatchAllApi.DatasetEntityListResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns a paginated list of entities in a dataset. Supports filtering by status, entity type, and name search.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.datasets.listEntitiesInDataset({
+    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2",
+    page: 1,
+    page_size: 100,
+    search: "OpenAI",
+    status: "ready",
+    entity_type: "company",
+    sort_by: "created_at",
+    sort_order: "desc"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.ListDatasetEntitiesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `DatasetsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">getDatasetStatusHistory</a>({ ...params }) -> CatchAllApi.DatasetStatusHistoryResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns the full status change history for a dataset, ordered chronologically from oldest to newest.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.datasets.getDatasetStatusHistory({
+    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.GetDatasetStatusHistoryRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `DatasetsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">uploadCsvToDataset</a>({ ...params }) -> CatchAllApi.UploadCsvToDatasetResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Appends new companies to an existing dataset by uploading a CSV file. Uses the same CSV format as the dataset creation endpoint.
+
+The response omits `dataset_name` compared to the create-from-CSV endpoint since the dataset already exists.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.datasets.uploadCsvToDataset({
+    file: fs.createReadStream("/path/to/your/file"),
+    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.UploadCsvToDatasetRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `DatasetsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Projects
+<details><summary><code>client.projects.<a href="/src/api/resources/projects/client/Client.ts">listProjects</a>({ ...params }) -> CatchAllApi.ProjectListResponseDto</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns all projects visible to the authenticated user.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.projects.listProjects({
+    search: "M&A"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.ListProjectsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ProjectsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.projects.<a href="/src/api/resources/projects/client/Client.ts">createProject</a>({ ...params }) -> CatchAllApi.CreateProjectResponseDto</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Creates a new project.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.projects.createProject({
+    name: "AI M&A Tracking",
+    description: "Tracks AI-related M&A activity for our investment team."
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.CreateProjectRequestDto` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ProjectsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.projects.<a href="/src/api/resources/projects/client/Client.ts">getProject</a>({ ...params }) -> CatchAllApi.ProjectResponseDto</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns a single project by ID.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.projects.getProject({
+    project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.GetProjectRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ProjectsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.projects.<a href="/src/api/resources/projects/client/Client.ts">deleteProject</a>({ ...params }) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Deletes a project. By default, assigned resources are unassigned but not deleted. 
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.projects.deleteProject({
+    project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.DeleteProjectRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ProjectsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.projects.<a href="/src/api/resources/projects/client/Client.ts">updateProject</a>({ ...params }) -> CatchAllApi.UpdateProjectResponseDto</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Updates the name or description of an existing project.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.projects.updateProject({
+    project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04",
+    name: "AI M&A Tracking (Q2 2026)"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.UpdateProjectRequestDto` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ProjectsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.projects.<a href="/src/api/resources/projects/client/Client.ts">getProjectOverview</a>({ ...params }) -> CatchAllApi.ProjectOverviewResponseDto</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns resource counts for a project, grouped by type and status.
+
+For `jobs` and `monitors`, counts are broken down by status (for example, `completed`, `failed`). For `datasets` and `monitor_groups`, only a `total` count is returned.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.projects.getProjectOverview({
+    project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.GetProjectOverviewRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ProjectsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.projects.<a href="/src/api/resources/projects/client/Client.ts">listProjectResources</a>({ ...params }) -> CatchAllApi.ProjectResourceListResponseDto</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns all resources assigned to a project, with optional filtering by type.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.projects.listProjectResources({
+    project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.ListProjectResourcesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ProjectsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.projects.<a href="/src/api/resources/projects/client/Client.ts">addResourceToProject</a>({ ...params }) -> CatchAllApi.AddResourceResponseDto</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Assigns one or more existing resources to a project in a single request.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.projects.addResourceToProject({
+    project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04",
+    resources: [{
+            resource_type: "job",
+            resource_id: "48421e16-1f50-4048-b62c-d3bc0789d30d"
+        }]
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.AddResourceRequestDto` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ProjectsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.projects.<a href="/src/api/resources/projects/client/Client.ts">removeResourceFromProject</a>({ ...params }) -> CatchAllApi.RemoveResourceResponseDto</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Removes a resource from a project. The resource itself is not
+deleted — it becomes unassigned and continues to exist.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.projects.removeResourceFromProject({
+    project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04",
+    resource_type: "job",
+    resource_id: "48421e16-1f50-4048-b62c-d3bc0789d30d"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.RemoveResourceFromProjectRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ProjectsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>