newscatcher-catchall-sdk 2.0.0 → 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>
@@ -492,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,13 +630,7 @@ await client.monitors.createMonitor({
     reference_job_id: "5f0c9087-85cb-4917-b3c7-e5a5eff73a0c",
     schedule: "every day at 12 PM",
     timezone: "UTC",
-    webhook: {
-        url: "https://your-endpoint.com/webhook",
-        method: "POST",
-        headers: {
-            "Authorization": "Bearer your_token_here"
-        }
-    },
+    webhook_ids: ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
     limit: 10,
     backfill: true
 });
@@ -1031,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"]
 });
 
 ```
@@ -1074,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>
 
@@ -1087,7 +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>
@@ -1102,9 +1161,7 @@ Returns a paginated list of entities belonging to the authenticated organization
 <dd>
 
 ```typescript
-await client.entities.listEntities({
-    search: "NewsCatcher"
-});
+await client.webhooks.listWebhooks();
 
 ```
 </dd>
@@ -1120,7 +1177,7 @@ await client.entities.listEntities({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.ListEntitiesRequest` 
+**request:** `CatchAllApi.ListWebhooksRequest` 
     
 </dd>
 </dl>
@@ -1128,7 +1185,7 @@ await client.entities.listEntities({
 <dl>
 <dd>
 
-**requestOptions:** `EntitiesClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1140,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>
 
@@ -1152,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>
@@ -1172,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"
 });
 
 ```
@@ -1199,7 +1245,7 @@ await client.entities.createEntity({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.CreateEntityRequest` 
+**request:** `CatchAllApi.CreateWebhookRequestDto` 
     
 </dd>
 </dl>
@@ -1207,7 +1253,7 @@ await client.entities.createEntity({
 <dl>
 <dd>
 
-**requestOptions:** `EntitiesClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1219,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>
 
@@ -1231,9 +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>
@@ -1248,29 +1292,8 @@ Returns an array of `{id, status}` objects in the same order as 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"
 });
 
 ```
@@ -1287,7 +1310,7 @@ await client.entities.createEntitiesBatch({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.CreateEntitiesBatchRequest` 
+**request:** `CatchAllApi.GetWebhookRequest` 
     
 </dd>
 </dl>
@@ -1295,7 +1318,7 @@ await client.entities.createEntitiesBatch({
 <dl>
 <dd>
 
-**requestOptions:** `EntitiesClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1307,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>
 
@@ -1319,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>
@@ -1334,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"
 });
 
 ```
@@ -1352,7 +1377,7 @@ await client.entities.getEntity({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.GetEntityRequest` 
+**request:** `CatchAllApi.DeleteWebhookRequest` 
     
 </dd>
 </dl>
@@ -1360,7 +1385,7 @@ await client.entities.getEntity({
 <dl>
 <dd>
 
-**requestOptions:** `EntitiesClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1372,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>
 
@@ -1384,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>
@@ -1400,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
 });
 
 ```
@@ -1418,7 +1444,7 @@ await client.entities.deleteEntity({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.DeleteEntityRequest` 
+**request:** `CatchAllApi.UpdateWebhookRequestDto` 
     
 </dd>
 </dl>
@@ -1426,7 +1452,7 @@ await client.entities.deleteEntity({
 <dl>
 <dd>
 
-**requestOptions:** `EntitiesClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1438,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>
 
@@ -1450,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>
@@ -1465,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"
     }
 });
 
@@ -1489,7 +1515,7 @@ await client.entities.updateEntity({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.UpdateEntityRequest` 
+**request:** `CatchAllApi.TestWebhookRequestDto` 
     
 </dd>
 </dl>
@@ -1497,7 +1523,7 @@ await client.entities.updateEntity({
 <dl>
 <dd>
 
-**requestOptions:** `EntitiesClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1509,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>
 
@@ -1522,7 +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>
@@ -1537,8 +1562,8 @@ Returns a paginated list of datasets belonging to the authenticated organization
 <dd>
 
 ```typescript
-await client.datasets.listDatasets({
-    search: "Portfolio"
+await client.webhooks.listWebhookResources({
+    webhook_id: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
 });
 
 ```
@@ -1555,7 +1580,7 @@ await client.datasets.listDatasets({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.ListDatasetsRequest` 
+**request:** `CatchAllApi.ListWebhookResourcesRequest` 
     
 </dd>
 </dl>
@@ -1563,7 +1588,7 @@ await client.datasets.listDatasets({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1575,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>
 
@@ -1587,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>
@@ -1609,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"
 });
 
 ```
@@ -1629,7 +1651,7 @@ await client.datasets.createDataset({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.CreateDatasetRequest` 
+**request:** `CatchAllApi.AssignWebhookResourceRequestDto` 
     
 </dd>
 </dl>
@@ -1637,7 +1659,7 @@ await client.datasets.createDataset({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1649,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>
 
@@ -1661,18 +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` 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`. 
+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>
@@ -1687,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"
 });
 
 ```
@@ -1706,7 +1720,7 @@ await client.datasets.createDatasetFromCsv({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.CreateDatasetFromCsvRequest` 
+**request:** `CatchAllApi.RemoveWebhookResourceRequest` 
     
 </dd>
 </dl>
@@ -1714,7 +1728,7 @@ await client.datasets.createDatasetFromCsv({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1726,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>
 
@@ -1738,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>
@@ -1753,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"
 });
 
 ```
@@ -1771,7 +1786,7 @@ await client.datasets.getDataset({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.GetDatasetRequest` 
+**request:** `CatchAllApi.ListWebhooksForResourceRequest` 
     
 </dd>
 </dl>
@@ -1779,7 +1794,7 @@ await client.datasets.getDataset({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1791,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>
 
@@ -1803,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>
@@ -1820,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"
 });
 
 ```
@@ -1838,7 +1854,7 @@ await client.datasets.deleteDataset({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.DeleteDatasetRequest` 
+**request:** `CatchAllApi.GetWebhookDeliveryHistoryRequest` 
     
 </dd>
 </dl>
@@ -1846,7 +1862,7 @@ await client.datasets.deleteDataset({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `WebhooksClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1858,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>
 
@@ -1870,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>
@@ -1885,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"
 });
 
 ```
@@ -1905,7 +1920,7 @@ await client.datasets.updateDataset({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.UpdateDatasetRequest` 
+**request:** `CatchAllApi.ListEntitiesRequest` 
     
 </dd>
 </dl>
@@ -1913,7 +1928,7 @@ await client.datasets.updateDataset({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `EntitiesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1925,7 +1940,7 @@ await client.datasets.updateDataset({
 </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">createEntity</a>({ ...params }) -> CatchAllApi.CreateEntityResponse</code></summary>
 <dl>
 <dd>
 
@@ -1937,7 +1952,12 @@ await client.datasets.updateDataset({
 <dl>
 <dd>
 
-Adds one or more existing entities to a dataset. Returns the number of entities added.
+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>
@@ -1952,10 +1972,16 @@ 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"]
+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"]
+        }
     }
 });
 
@@ -1973,7 +1999,7 @@ await client.datasets.addEntitiesToDataset({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.AddEntitiesToDatasetRequest` 
+**request:** `CatchAllApi.CreateEntityRequest` 
     
 </dd>
 </dl>
@@ -1981,7 +2007,7 @@ await client.datasets.addEntitiesToDataset({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `EntitiesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -1993,7 +2019,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">createEntitiesBatch</a>({ ...params }) -> CatchAllApi.CreateEntitiesBatchResponse</code></summary>
 <dl>
 <dd>
 
@@ -2005,7 +2031,9 @@ 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.
+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>
@@ -2020,13 +2048,31 @@ Removes one or more entities from a dataset. The entities themselves are not del
 <dd>
 
 ```typescript
-await client.datasets.removeEntitiesFromDataset({
-    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2",
-    body: {
-        entity_ids: ["854198fa-f702-49db-a381-0427fa87f173"]
-    }
-});
-
+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>
@@ -2041,7 +2087,7 @@ await client.datasets.removeEntitiesFromDataset({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.RemoveEntitiesFromDatasetRequest` 
+**request:** `CatchAllApi.CreateEntitiesBatchRequest` 
     
 </dd>
 </dl>
@@ -2049,7 +2095,7 @@ await client.datasets.removeEntitiesFromDataset({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `EntitiesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -2061,7 +2107,7 @@ await client.datasets.removeEntitiesFromDataset({
 </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">getEntity</a>({ ...params }) -> CatchAllApi.EntityResponse</code></summary>
 <dl>
 <dd>
 
@@ -2073,7 +2119,7 @@ await client.datasets.removeEntitiesFromDataset({
 <dl>
 <dd>
 
-Returns a paginated list of entities in a dataset. Supports filtering by status, entity type, and name search.
+Returns a single entity by ID with all attributes and current status.
 </dd>
 </dl>
 </dd>
@@ -2088,15 +2134,8 @@ 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",
-    page: 1,
-    page_size: 100,
-    search: "OpenAI",
-    status: "ready",
-    entity_type: "company",
-    sort_by: "created_at",
-    sort_order: "desc"
+await client.entities.getEntity({
+    entity_id: "854198fa-f702-49db-a381-0427fa87f173"
 });
 
 ```
@@ -2113,7 +2152,7 @@ await client.datasets.listEntitiesInDataset({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.ListDatasetEntitiesRequest` 
+**request:** `CatchAllApi.GetEntityRequest` 
     
 </dd>
 </dl>
@@ -2121,7 +2160,7 @@ await client.datasets.listEntitiesInDataset({
 <dl>
 <dd>
 
-**requestOptions:** `DatasetsClient.RequestOptions` 
+**requestOptions:** `EntitiesClient.RequestOptions` 
     
 </dd>
 </dl>
@@ -2133,7 +2172,7 @@ await client.datasets.listEntitiesInDataset({
 </dl>
 </details>
 
-<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">getDatasetStatusHistory</a>({ ...params }) -> CatchAllApi.DatasetStatusHistoryResponse</code></summary>
+<details><summary><code>client.entities.<a href="/src/api/resources/entities/client/Client.ts">deleteEntity</a>({ ...params }) -> void</code></summary>
 <dl>
 <dd>
 
@@ -2145,7 +2184,8 @@ await client.datasets.listEntitiesInDataset({
 <dl>
 <dd>
 
-Returns the full status change history for a dataset, ordered chronologically from oldest to newest.
+Permanently deletes an entity. The entity is removed from all
+datasets and the search index. This operation cannot be undone.
 </dd>
 </dl>
 </dd>
@@ -2160,8 +2200,8 @@ Returns the full status change history for a dataset, ordered chronologically fr
 <dd>
 
 ```typescript
-await client.datasets.getDatasetStatusHistory({
-    dataset_id: "ccabb755-afc2-4047-b84c-78d1f23d49b2"
+await client.entities.deleteEntity({
+    entity_id: "854198fa-f702-49db-a381-0427fa87f173"
 });
 
 ```
@@ -2178,7 +2218,145 @@ await client.datasets.getDatasetStatusHistory({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.GetDatasetStatusHistoryRequest` 
+**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"]
+        }
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.UpdateEntityRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `EntitiesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+## Datasets
+<details><summary><code>client.datasets.<a href="/src/api/resources/datasets/client/Client.ts">listDatasets</a>({ ...params }) -> CatchAllApi.DatasetListResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<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.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.datasets.listDatasets({
+    search: "Portfolio",
+    project_id: "60a85db4-78ec-4b78-876a-bc7d9cdadd04"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `CatchAllApi.ListDatasetsRequest` 
     
 </dd>
 </dl>
@@ -2198,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>
 
@@ -2210,9 +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.
 
-The response omits `dataset_name` compared to the create-from-CSV endpoint since the dataset already exists.
+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.
+
+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>
@@ -2227,9 +2410,10 @@ The response omits `dataset_name` compared to the create-from-CSV endpoint since
 <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"]
 });
 
 ```
@@ -2246,7 +2430,7 @@ await client.datasets.uploadCsvToDataset({
 <dl>
 <dd>
 
-**request:** `CatchAllApi.UploadCsvToDatasetRequest` 
+**request:** `CatchAllApi.CreateDatasetRequest` 
     
 </dd>
 </dl>
@@ -2262,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>