Skip to content

Commit 13980fe

Browse files
author
ci.datadog-api-spec
committed
Regenerate client from commit 897b6dd of spec repo
1 parent 226f784 commit 13980fe

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
@@ -44173,6 +44173,16 @@ components:
4417344173
items:
4417444174
type: string
4417544175
type: array
44176+
triage_state:
44177+
description: "Current triage state of the indicator: not_reviewed or reviewed."
44178+
type: string
44179+
triaged_at:
44180+
description: Timestamp when the indicator was last triaged.
44181+
format: date-time
44182+
type: string
44183+
triaged_by:
44184+
description: UUID of the user who last triaged the indicator.
44185+
type: string
4417644186
type: object
4417744187
IoCIndicatorDetailed:
4417844188
description: An indicator of compromise with extended context from your environment.
@@ -44291,6 +44301,21 @@ components:
4429144301
items:
4429244302
type: string
4429344303
type: array
44304+
triage_history:
44305+
description: Full triage history timeline. Returned only when `include_triage_history` is true.
44306+
items:
44307+
$ref: "#/components/schemas/IoCTriageEvent"
44308+
type: array
44309+
triage_state:
44310+
description: "Current triage state of the indicator: not_reviewed or reviewed."
44311+
type: string
44312+
triaged_at:
44313+
description: Timestamp when the indicator was last triaged.
44314+
format: date-time
44315+
type: string
44316+
triaged_by:
44317+
description: UUID of the user who last triaged the indicator.
44318+
type: string
4429444319
users:
4429544320
additionalProperties:
4429644321
description: List of user identifiers in this category.
@@ -44329,6 +44354,97 @@ components:
4432944354
description: Name of the threat intelligence source.
4433044355
type: string
4433144356
type: object
44357+
IoCTriageEvent:
44358+
description: A single entry in an indicator's triage history timeline.
44359+
properties:
44360+
triage_state:
44361+
description: "Triage state set by this action: not_reviewed or reviewed."
44362+
type: string
44363+
triaged_at:
44364+
description: Timestamp when this triage action occurred.
44365+
format: date-time
44366+
type: string
44367+
triaged_by:
44368+
description: UUID of the user who performed this triage action.
44369+
type: string
44370+
type: object
44371+
IoCTriageWriteRequest:
44372+
description: Request body for creating or updating an indicator triage state.
44373+
properties:
44374+
data:
44375+
$ref: "#/components/schemas/IoCTriageWriteRequestData"
44376+
required:
44377+
- data
44378+
type: object
44379+
IoCTriageWriteRequestAttributes:
44380+
description: Attributes for setting an indicator's triage state.
44381+
properties:
44382+
indicator:
44383+
description: The indicator value to triage (for example, an IP address or domain).
44384+
example: "192.0.2.1"
44385+
type: string
44386+
triage_state:
44387+
description: "The triage state to set: not_reviewed or reviewed."
44388+
example: reviewed
44389+
type: string
44390+
required:
44391+
- indicator
44392+
- triage_state
44393+
type: object
44394+
IoCTriageWriteRequestData:
44395+
description: Data object for the triage write request.
44396+
properties:
44397+
attributes:
44398+
$ref: "#/components/schemas/IoCTriageWriteRequestAttributes"
44399+
type:
44400+
default: ioc_triage_state
44401+
description: Triage state resource type.
44402+
example: ioc_triage_state
44403+
type: string
44404+
required:
44405+
- type
44406+
- attributes
44407+
type: object
44408+
IoCTriageWriteResponse:
44409+
description: Response for the create indicator triage state endpoint.
44410+
properties:
44411+
data:
44412+
$ref: "#/components/schemas/IoCTriageWriteResponseData"
44413+
type: object
44414+
IoCTriageWriteResponseAttributes:
44415+
description: Attributes of a created or updated triage state.
44416+
properties:
44417+
created_at:
44418+
description: Timestamp when the triage record was created.
44419+
format: date-time
44420+
type: string
44421+
indicator:
44422+
description: The indicator value that was triaged.
44423+
type: string
44424+
triage_state:
44425+
description: "The triage state that was set: not_reviewed or reviewed."
44426+
type: string
44427+
triaged_at:
44428+
description: Timestamp when the triage state was set.
44429+
format: date-time
44430+
type: string
44431+
triaged_by:
44432+
description: UUID of the user who set the triage state.
44433+
type: string
44434+
type: object
44435+
IoCTriageWriteResponseData:
44436+
description: Data object of the triage write response.
44437+
properties:
44438+
attributes:
44439+
$ref: "#/components/schemas/IoCTriageWriteResponseAttributes"
44440+
id:
44441+
description: Unique identifier for the triage state record.
44442+
type: string
44443+
type:
44444+
default: ioc_triage_state
44445+
description: Triage state resource type.
44446+
type: string
44447+
type: object
4433244448
Issue:
4433344449
description: The issue matching the request.
4433444450
properties:
@@ -158508,6 +158624,25 @@ paths:
158508158624
schema:
158509158625
default: desc
158510158626
type: string
158627+
- description: When true, return only OCSF field-based matches. When false, return regex/message-based matches.
158628+
in: query
158629+
name: ocsf
158630+
required: false
158631+
schema:
158632+
default: true
158633+
type: boolean
158634+
- description: Filter indicators whose triage state was updated by a specific user UUID.
158635+
in: query
158636+
name: worked_by
158637+
required: false
158638+
schema:
158639+
type: string
158640+
- description: "Filter by triage state: not_reviewed or reviewed."
158641+
in: query
158642+
name: triage_state
158643+
required: false
158644+
schema:
158645+
type: string
158511158646
responses:
158512158647
"200":
158513158648
content:
@@ -158559,6 +158694,38 @@ paths:
158559158694
required: true
158560158695
schema:
158561158696
type: string
158697+
- description: When true, return only OCSF field-based matches. When false, return regex/message-based matches.
158698+
in: query
158699+
name: ocsf
158700+
required: false
158701+
schema:
158702+
default: true
158703+
type: boolean
158704+
- description: Include full triage history for the indicator.
158705+
in: query
158706+
name: include_triage_history
158707+
required: false
158708+
schema:
158709+
default: false
158710+
type: boolean
158711+
- description: Maximum number of triage history events returned. Only applied when `include_triage_history` is true.
158712+
in: query
158713+
name: triage_history_limit
158714+
required: false
158715+
schema:
158716+
default: 50
158717+
format: int32
158718+
maximum: 1000
158719+
minimum: 1
158720+
type: integer
158721+
- description: Pagination offset into the triage history. Only applied when `include_triage_history` is true.
158722+
in: query
158723+
name: triage_history_offset
158724+
required: false
158725+
schema:
158726+
default: 0
158727+
format: int32
158728+
type: integer
158562158729
responses:
158563158730
"200":
158564158731
content:
@@ -158596,6 +158763,62 @@ paths:
158596158763
x-unstable: |-
158597158764
**Note**: This endpoint is in beta and may be subject to changes.
158598158765
Please check the documentation regularly for updates.
158766+
/api/v2/security/siem/ioc-explorer/triage:
158767+
post:
158768+
description: |-
158769+
Set the triage state of an indicator of compromise (IoC). This creates or
158770+
updates the triage state for the indicator in your organization.
158771+
operationId: CreateIoCTriageState
158772+
requestBody:
158773+
content:
158774+
"application/json":
158775+
examples:
158776+
default:
158777+
value:
158778+
data:
158779+
attributes:
158780+
indicator: "192.0.2.1"
158781+
triage_state: reviewed
158782+
type: ioc_triage_state
158783+
schema:
158784+
$ref: "#/components/schemas/IoCTriageWriteRequest"
158785+
description: The triage state to set for the indicator.
158786+
required: true
158787+
responses:
158788+
"201":
158789+
content:
158790+
"application/json":
158791+
examples:
158792+
default:
158793+
value:
158794+
data:
158795+
attributes:
158796+
created_at: "2026-06-04T12:00:00Z"
158797+
indicator: "192.0.2.1"
158798+
triage_state: reviewed
158799+
triaged_at: "2026-06-04T12:00:00Z"
158800+
triaged_by: 11111111-2222-3333-4444-555555555555
158801+
id: abc-123
158802+
type: ioc_triage_state
158803+
schema:
158804+
$ref: "#/components/schemas/IoCTriageWriteResponse"
158805+
description: Created
158806+
"400":
158807+
$ref: "#/components/responses/BadRequestResponse"
158808+
"403":
158809+
$ref: "#/components/responses/NotAuthorizedResponse"
158810+
"429":
158811+
$ref: "#/components/responses/TooManyRequestsResponse"
158812+
security:
158813+
- apiKeyAuth: []
158814+
appKeyAuth: []
158815+
- AuthZ:
158816+
- security_monitoring_signals_write
158817+
summary: Create or update an indicator triage state
158818+
tags: ["Security Monitoring"]
158819+
x-unstable: |-
158820+
**Note**: This endpoint is in beta and may be subject to changes.
158821+
Please check the documentation regularly for updates.
158599158822
/api/v2/security/signals/notification_rules:
158600158823
get:
158601158824
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)