Merge pull request #7 from crowdsecurity/$main-a24dfe8

he2ss · web-flow · commit d0a07a32179d · 2026-01-06T12:18:37.000+01:00
Update python SDK version: 1.95.1
diff --git a/LICENSE b/LICENSE
@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Crowdsec
+Copyright (c) 2026 Crowdsec
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
diff --git a/crowdsec_tracker_api/__init__.py b/crowdsec_tracker_api/__init__.py
@@ -52,7 +52,9 @@ class Server(Enum):
     'Reference',
     'ScoreBreakdown',
     'Scores',
+    'SinceOptions',
     'SubscribeCVEIntegrationRequest',
+    'TimelineItem',
     'ApiKeyAuth',
     'Server',
     'Page'
diff --git a/crowdsec_tracker_api/__pycache__/base_model.cpython-311.pyc b/crowdsec_tracker_api/__pycache__/base_model.cpython-311.pyc
diff --git a/crowdsec_tracker_api/__pycache__/http_client.cpython-311.pyc b/crowdsec_tracker_api/__pycache__/http_client.cpython-311.pyc
diff --git a/crowdsec_tracker_api/models.py b/crowdsec_tracker_api/models.py
@@ -1,11 +1,11 @@
 # generated by datamodel-codegen:
 #   filename:  <stdin>
-#   timestamp: 2025-12-31T15:56:47+00:00
+#   timestamp: 2026-01-06T11:14:02+00:00
 
 from __future__ import annotations
 
 from datetime import datetime
-from enum import StrEnum
+from enum import IntEnum, StrEnum
 from typing import Annotated, Dict, List, Optional, Union
 
 from pydantic import AnyUrl, ConfigDict, Field, RootModel
@@ -418,6 +418,12 @@ class Scores(BaseModelSdk):
     last_month: Annotated[ScoreBreakdown, Field(description='Last month scores')]
 
 
+class SinceOptions(IntEnum):
+    INTEGER_1 = 1
+    INTEGER_7 = 7
+    INTEGER_30 = 30
+
+
 class SubscribeCVEIntegrationRequest(BaseModelSdk):
     model_config = ConfigDict(
         extra='forbid',
@@ -427,6 +433,16 @@ class SubscribeCVEIntegrationRequest(BaseModelSdk):
     ]
 
 
+class TimelineItem(BaseModelSdk):
+    timestamp: Annotated[
+        datetime,
+        Field(description='Timestamp of the timeline event', title='Timestamp'),
+    ]
+    count: Annotated[
+        int, Field(description='Count of occurrences at the timestamp', title='Count')
+    ]
+
+
 class IntegrationsGetIntegrationsQueryParameters(BaseModelSdk):
     tag: Annotated[
         Optional[List[str]],
@@ -591,6 +607,19 @@ class CvesUnsubscribeIntegrationFromCvePathParameters(BaseModelSdk):
     integration_name: Annotated[str, Field(title='Integration Name')]
 
 
+class CvesGetCveTimelineQueryParameters(BaseModelSdk):
+    since_days: Annotated[
+        Optional[SinceOptions],
+        Field(
+            description='Time range for the timeline data (in days). Options: 1 (1 day), 7 (1 week), 30 (1 month). Default is 7 days.'
+        ),
+    ] = 7
+
+
+class CvesGetCveTimelinePathParameters(BaseModelSdk):
+    cve_id: Annotated[str, Field(title='Cve Id')]
+
+
 class HTTPValidationError(BaseModelSdk):
     detail: Annotated[Optional[List[ValidationError]], Field(title='Detail')] = None
 
diff --git a/crowdsec_tracker_api/services/__pycache__/__init__.cpython-311.pyc b/crowdsec_tracker_api/services/__pycache__/__init__.cpython-311.pyc
diff --git a/crowdsec_tracker_api/services/cves.py b/crowdsec_tracker_api/services/cves.py
@@ -11,7 +11,7 @@
 
 class Cves(Service):
     def __init__(self, auth: Auth, base_url: str = "https://admin.api.crowdsec.net/v1") -> None:
-        super().__init__(base_url=base_url, auth=auth, user_agent="crowdsec_tracker_api/1.95.0")
+        super().__init__(base_url=base_url, auth=auth, user_agent="crowdsec_tracker_api/1.95.1")
     
     def get_cves(
         self,
@@ -176,4 +176,29 @@ def unsubscribe_integration_from_cve(
         )
         
         return None
+    
+    def get_cve_timeline(
+        self,
+        cve_id: str,
+        since_days: SinceOptions,
+    )-> list[TimelineItem]:
+        endpoint_url = "/cves/{cve_id}/timeline"
+        loc = locals()
+        headers = {}
+        params = json.loads(
+            CvesGetCveTimelineQueryParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        path_params = json.loads(
+            CvesGetCveTimelinePathParameters(**loc).model_dump_json(
+                exclude_none=True
+            )
+        )
+        
+        response = self.http_client.get(
+            url=endpoint_url, path_params=path_params, params=params, headers=headers
+        )
+        
+        return list[TimelineItem](**response.json())
     
diff --git a/crowdsec_tracker_api/services/integrations.py b/crowdsec_tracker_api/services/integrations.py
@@ -11,7 +11,7 @@
 
 class Integrations(Service):
     def __init__(self, auth: Auth, base_url: str = "https://admin.api.crowdsec.net/v1") -> None:
-        super().__init__(base_url=base_url, auth=auth, user_agent="crowdsec_tracker_api/1.95.0")
+        super().__init__(base_url=base_url, auth=auth, user_agent="crowdsec_tracker_api/1.95.1")
     
     def get_integrations(
         self,
diff --git a/doc/Cves.md b/doc/Cves.md
@@ -10,6 +10,7 @@
 | [get_cve_subscribed_integrations](#get_cve_subscribed_integrations) | Get the list of integrations subscribed to a specific CVE ID |
 | [subscribe_integration_to_cve](#subscribe_integration_to_cve) | Subscribe an integration to receive threats related to a specific CVE ID |
 | [unsubscribe_integration_from_cve](#unsubscribe_integration_from_cve) | Unsubscribe an integration from receiving threats related to a specific CVE ID |
+| [get_cve_timeline](#get_cve_timeline) | Get timeline data of occurrences for a specific CVE ID |
 
 ## **get_cves**
 ### Get a paginated list of CVEs that CrowdSec is tracking 
@@ -285,3 +286,41 @@ except HTTPStatusError as e:
     print(f"An error occurred: {e.response.status_code} - {e.response.text}")
 ```
 
+
+## **get_cve_timeline**
+### Get timeline data of occurrences for a specific CVE ID 
+- Endpoint: `/cves/{cve_id}/timeline`
+- Method: `GET`
+
+### Parameters:
+| Parameter | Type | Description | Required | Default |
+| --------- | ---- | ----------- | -------- | ------- |
+| cve_id | str |  | True |  |
+| since_days | SinceOptions | Time range for the timeline data (in days). Options: 1 (1 day), 7 (1 week), 30 (1 month). Default is 7 days. | False |  |
+### Returns:
+[list[TimelineItem]](./Models.md#list[timelineitem])
+### Errors:
+| Code | Description |
+| ---- | ----------- |
+| 404 | CVE Not Found |
+| 422 | Validation Error |
+### Usage
+
+```python
+from crowdsec_tracker_api import (
+    Cves,
+    ApiKeyAuth,
+)
+from httpx import HTTPStatusError
+auth = ApiKeyAuth(api_key='your_api_key')
+client = Cves(auth=auth)
+try:
+    response = client.get_cve_timeline(
+        cve_id='cve_id',
+        since_days=None,
+    )
+    print(response)
+except HTTPStatusError as e:
+    print(f"An error occurred: {e.response.status_code} - {e.response.text}")
+```
+
diff --git a/doc/Models.md b/doc/Models.md
@@ -463,10 +463,21 @@ overall, last_day, last_week, last_month
 | last_week | ScoreBreakdown | None ||
 | last_month | ScoreBreakdown | None ||
 
+# **SinceOptions**
+
 # **SubscribeCVEIntegrationRequest**
 ## Required: 
 name
 ## Properties
 | Property | Type | Description | Example |
 |----------|------|-------------|---------|
-| name | str | Name of the integration to subscribe ||
+| name | str | Name of the integration to subscribe ||
+
+# **TimelineItem**
+## Required: 
+timestamp, count
+## Properties
+| Property | Type | Description | Example |
+|----------|------|-------------|---------|
+| timestamp | str | Timestamp of the timeline event ||
+| count | int | Count of occurrences at the timestamp ||
diff --git a/doc/README.md b/doc/README.md
@@ -99,4 +99,8 @@ You can find a Quickstart about this SDK, following this [documentation](https:/
 
 [Scores](./Models.md#scores)
 
-[SubscribeCVEIntegrationRequest](./Models.md#subscribecveintegrationrequest)
+[SinceOptions](./Models.md#sinceoptions)
+
+[SubscribeCVEIntegrationRequest](./Models.md#subscribecveintegrationrequest)
+
+[TimelineItem](./Models.md#timelineitem)
diff --git a/let-openapi.json b/let-openapi.json
diff --git a/pyproject.toml b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "crowdsec_tracker_api"
-version = "1.95.0"
+version = "1.95.1"
 license = { text = "MIT" }
 authors = [
 	{ name="crowdsec", email="info@crowdsec.net" }
