Skip to content

Commit f31bdae

Browse files
author
ci.datadog-api-spec
committed
Regenerate client from commit e6354d0 of spec repo
1 parent 06f047a commit f31bdae

26 files changed

Lines changed: 929 additions & 12 deletions

.generator/schemas/v2/openapi.yaml

Lines changed: 223 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44181,6 +44181,16 @@ components:
4418144181
items:
4418244182
type: string
4418344183
type: array
44184+
triage_state:
44185+
description: "Current triage state of the indicator: not_reviewed or reviewed."
44186+
type: string
44187+
triaged_at:
44188+
description: Timestamp when the indicator was last triaged.
44189+
format: date-time
44190+
type: string
44191+
triaged_by:
44192+
description: UUID of the user who last triaged the indicator.
44193+
type: string
4418444194
type: object
4418544195
IoCIndicatorDetailed:
4418644196
description: An indicator of compromise with extended context from your environment.
@@ -44299,6 +44309,21 @@ components:
4429944309
items:
4430044310
type: string
4430144311
type: array
44312+
triage_history:
44313+
description: Full triage history timeline. Returned only when `include_triage_history` is true.
44314+
items:
44315+
$ref: "#/components/schemas/IoCTriageEvent"
44316+
type: array
44317+
triage_state:
44318+
description: "Current triage state of the indicator: not_reviewed or reviewed."
44319+
type: string
44320+
triaged_at:
44321+
description: Timestamp when the indicator was last triaged.
44322+
format: date-time
44323+
type: string
44324+
triaged_by:
44325+
description: UUID of the user who last triaged the indicator.
44326+
type: string
4430244327
users:
4430344328
additionalProperties:
4430444329
description: List of user identifiers in this category.
@@ -44337,6 +44362,97 @@ components:
4433744362
description: Name of the threat intelligence source.
4433844363
type: string
4433944364
type: object
44365+
IoCTriageEvent:
44366+
description: A single entry in an indicator's triage history timeline.
44367+
properties:
44368+
triage_state:
44369+
description: "Triage state set by this action: not_reviewed or reviewed."
44370+
type: string
44371+
triaged_at:
44372+
description: Timestamp when this triage action occurred.
44373+
format: date-time
44374+
type: string
44375+
triaged_by:
44376+
description: UUID of the user who performed this triage action.
44377+
type: string
44378+
type: object
44379+
IoCTriageWriteRequest:
44380+
description: Request body for creating or updating an indicator triage state.
44381+
properties:
44382+
data:
44383+
$ref: "#/components/schemas/IoCTriageWriteRequestData"
44384+
required:
44385+
- data
44386+
type: object
44387+
IoCTriageWriteRequestAttributes:
44388+
description: Attributes for setting an indicator's triage state.
44389+
properties:
44390+
indicator:
44391+
description: The indicator value to triage (for example, an IP address or domain).
44392+
example: "192.0.2.1"
44393+
type: string
44394+
triage_state:
44395+
description: "The triage state to set: not_reviewed or reviewed."
44396+
example: reviewed
44397+
type: string
44398+
required:
44399+
- indicator
44400+
- triage_state
44401+
type: object
44402+
IoCTriageWriteRequestData:
44403+
description: Data object for the triage write request.
44404+
properties:
44405+
attributes:
44406+
$ref: "#/components/schemas/IoCTriageWriteRequestAttributes"
44407+
type:
44408+
default: ioc_triage_state
44409+
description: Triage state resource type.
44410+
example: ioc_triage_state
44411+
type: string
44412+
required:
44413+
- type
44414+
- attributes
44415+
type: object
44416+
IoCTriageWriteResponse:
44417+
description: Response for the create indicator triage state endpoint.
44418+
properties:
44419+
data:
44420+
$ref: "#/components/schemas/IoCTriageWriteResponseData"
44421+
type: object
44422+
IoCTriageWriteResponseAttributes:
44423+
description: Attributes of a created or updated triage state.
44424+
properties:
44425+
created_at:
44426+
description: Timestamp when the triage record was created.
44427+
format: date-time
44428+
type: string
44429+
indicator:
44430+
description: The indicator value that was triaged.
44431+
type: string
44432+
triage_state:
44433+
description: "The triage state that was set: not_reviewed or reviewed."
44434+
type: string
44435+
triaged_at:
44436+
description: Timestamp when the triage state was set.
44437+
format: date-time
44438+
type: string
44439+
triaged_by:
44440+
description: UUID of the user who set the triage state.
44441+
type: string
44442+
type: object
44443+
IoCTriageWriteResponseData:
44444+
description: Data object of the triage write response.
44445+
properties:
44446+
attributes:
44447+
$ref: "#/components/schemas/IoCTriageWriteResponseAttributes"
44448+
id:
44449+
description: Unique identifier for the triage state record.
44450+
type: string
44451+
type:
44452+
default: ioc_triage_state
44453+
description: Triage state resource type.
44454+
type: string
44455+
type: object
4434044456
Issue:
4434144457
description: The issue matching the request.
4434244458
properties:
@@ -159560,6 +159676,25 @@ paths:
159560159676
schema:
159561159677
default: desc
159562159678
type: string
159679+
- description: When true, return only OCSF field-based matches. When false, return regex/message-based matches.
159680+
in: query
159681+
name: ocsf
159682+
required: false
159683+
schema:
159684+
default: true
159685+
type: boolean
159686+
- description: Filter indicators whose triage state was updated by a specific user UUID.
159687+
in: query
159688+
name: worked_by
159689+
required: false
159690+
schema:
159691+
type: string
159692+
- description: "Filter by triage state: not_reviewed or reviewed."
159693+
in: query
159694+
name: triage_state
159695+
required: false
159696+
schema:
159697+
type: string
159563159698
responses:
159564159699
"200":
159565159700
content:
@@ -159611,6 +159746,38 @@ paths:
159611159746
required: true
159612159747
schema:
159613159748
type: string
159749+
- description: When true, return only OCSF field-based matches. When false, return regex/message-based matches.
159750+
in: query
159751+
name: ocsf
159752+
required: false
159753+
schema:
159754+
default: true
159755+
type: boolean
159756+
- description: Include full triage history for the indicator.
159757+
in: query
159758+
name: include_triage_history
159759+
required: false
159760+
schema:
159761+
default: false
159762+
type: boolean
159763+
- description: Maximum number of triage history events returned. Only applied when `include_triage_history` is true.
159764+
in: query
159765+
name: triage_history_limit
159766+
required: false
159767+
schema:
159768+
default: 50
159769+
format: int32
159770+
maximum: 1000
159771+
minimum: 1
159772+
type: integer
159773+
- description: Pagination offset into the triage history. Only applied when `include_triage_history` is true.
159774+
in: query
159775+
name: triage_history_offset
159776+
required: false
159777+
schema:
159778+
default: 0
159779+
format: int32
159780+
type: integer
159614159781
responses:
159615159782
"200":
159616159783
content:
@@ -159648,6 +159815,62 @@ paths:
159648159815
x-unstable: |-
159649159816
**Note**: This endpoint is in beta and may be subject to changes.
159650159817
Please check the documentation regularly for updates.
159818+
/api/v2/security/siem/ioc-explorer/triage:
159819+
post:
159820+
description: |-
159821+
Set the triage state of an indicator of compromise (IoC). This creates or
159822+
updates the triage state for the indicator in your organization.
159823+
operationId: CreateIoCTriageState
159824+
requestBody:
159825+
content:
159826+
"application/json":
159827+
examples:
159828+
default:
159829+
value:
159830+
data:
159831+
attributes:
159832+
indicator: "192.0.2.1"
159833+
triage_state: reviewed
159834+
type: ioc_triage_state
159835+
schema:
159836+
$ref: "#/components/schemas/IoCTriageWriteRequest"
159837+
description: The triage state to set for the indicator.
159838+
required: true
159839+
responses:
159840+
"201":
159841+
content:
159842+
"application/json":
159843+
examples:
159844+
default:
159845+
value:
159846+
data:
159847+
attributes:
159848+
created_at: "2026-06-04T12:00:00Z"
159849+
indicator: "192.0.2.1"
159850+
triage_state: reviewed
159851+
triaged_at: "2026-06-04T12:00:00Z"
159852+
triaged_by: 11111111-2222-3333-4444-555555555555
159853+
id: abc-123
159854+
type: ioc_triage_state
159855+
schema:
159856+
$ref: "#/components/schemas/IoCTriageWriteResponse"
159857+
description: Created
159858+
"400":
159859+
$ref: "#/components/responses/BadRequestResponse"
159860+
"403":
159861+
$ref: "#/components/responses/NotAuthorizedResponse"
159862+
"429":
159863+
$ref: "#/components/responses/TooManyRequestsResponse"
159864+
security:
159865+
- apiKeyAuth: []
159866+
appKeyAuth: []
159867+
- AuthZ:
159868+
- security_monitoring_signals_write
159869+
summary: Create or update an indicator triage state
159870+
tags: ["Security Monitoring"]
159871+
x-unstable: |-
159872+
**Note**: This endpoint is in beta and may be subject to changes.
159873+
Please check the documentation regularly for updates.
159651159874
/api/v2/security/signals/notification_rules:
159652159875
get:
159653159876
description: Returns the list of notification rules for security signals.

docs/datadog_api_client.v2.model.rst

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18169,6 +18169,55 @@ datadog\_api\_client.v2.model.io\_c\_source module
1816918169
:members:
1817018170
:show-inheritance:
1817118171

18172+
datadog\_api\_client.v2.model.io\_c\_triage\_event module
18173+
---------------------------------------------------------
18174+
18175+
.. automodule:: datadog_api_client.v2.model.io_c_triage_event
18176+
:members:
18177+
:show-inheritance:
18178+
18179+
datadog\_api\_client.v2.model.io\_c\_triage\_write\_request module
18180+
------------------------------------------------------------------
18181+
18182+
.. automodule:: datadog_api_client.v2.model.io_c_triage_write_request
18183+
:members:
18184+
:show-inheritance:
18185+
18186+
datadog\_api\_client.v2.model.io\_c\_triage\_write\_request\_attributes module
18187+
------------------------------------------------------------------------------
18188+
18189+
.. automodule:: datadog_api_client.v2.model.io_c_triage_write_request_attributes
18190+
:members:
18191+
:show-inheritance:
18192+
18193+
datadog\_api\_client.v2.model.io\_c\_triage\_write\_request\_data module
18194+
------------------------------------------------------------------------
18195+
18196+
.. automodule:: datadog_api_client.v2.model.io_c_triage_write_request_data
18197+
:members:
18198+
:show-inheritance:
18199+
18200+
datadog\_api\_client.v2.model.io\_c\_triage\_write\_response module
18201+
-------------------------------------------------------------------
18202+
18203+
.. automodule:: datadog_api_client.v2.model.io_c_triage_write_response
18204+
:members:
18205+
:show-inheritance:
18206+
18207+
datadog\_api\_client.v2.model.io\_c\_triage\_write\_response\_attributes module
18208+
-------------------------------------------------------------------------------
18209+
18210+
.. automodule:: datadog_api_client.v2.model.io_c_triage_write_response_attributes
18211+
:members:
18212+
:show-inheritance:
18213+
18214+
datadog\_api\_client.v2.model.io\_c\_triage\_write\_response\_data module
18215+
-------------------------------------------------------------------------
18216+
18217+
.. automodule:: datadog_api_client.v2.model.io_c_triage_write_response_data
18218+
:members:
18219+
:show-inheritance:
18220+
1817218221
datadog\_api\_client.v2.model.ios\_sourcemap\_attributes module
1817318222
---------------------------------------------------------------
1817418223

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
"""
2+
Create or update an indicator triage state returns "Created" response
3+
"""
4+
5+
from datadog_api_client import ApiClient, Configuration
6+
from datadog_api_client.v2.api.security_monitoring_api import SecurityMonitoringApi
7+
from datadog_api_client.v2.model.io_c_triage_write_request import IoCTriageWriteRequest
8+
from datadog_api_client.v2.model.io_c_triage_write_request_attributes import IoCTriageWriteRequestAttributes
9+
from datadog_api_client.v2.model.io_c_triage_write_request_data import IoCTriageWriteRequestData
10+
11+
body = IoCTriageWriteRequest(
12+
data=IoCTriageWriteRequestData(
13+
attributes=IoCTriageWriteRequestAttributes(
14+
indicator="192.0.2.1",
15+
triage_state="reviewed",
16+
),
17+
type="ioc_triage_state",
18+
),
19+
)
20+
21+
configuration = Configuration()
22+
configuration.unstable_operations["create_io_c_triage_state"] = True
23+
with ApiClient(configuration) as api_client:
24+
api_instance = SecurityMonitoringApi(api_client)
25+
response = api_instance.create_io_c_triage_state(body=body)
26+
27+
print(response)

examples/v2/security-monitoring/GetIndicatorOfCompromise.py

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,8 @@
1010
with ApiClient(configuration) as api_client:
1111
api_instance = SecurityMonitoringApi(api_client)
1212
response = api_instance.get_indicator_of_compromise(
13-
indicator="masscan/1.3 (https://github.com/robertdavidgraham/masscan)",
13+
indicator="192.0.2.1",
14+
include_triage_history=True,
1415
)
1516

1617
print(response)

src/datadog_api_client/configuration.py

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -394,6 +394,7 @@ def __init__(
394394
"v2.cancel_historical_job": False,
395395
"v2.convert_job_result_to_signal": False,
396396
"v2.convert_security_monitoring_terraform_resource": False,
397+
"v2.create_io_c_triage_state": False,
397398
"v2.create_sample_log_generation_subscription": False,
398399
"v2.create_security_monitoring_dataset": False,
399400
"v2.create_security_monitoring_integration_config": False,

0 commit comments

Comments
 (0)