@@ -45707,6 +45707,15 @@ components:
4570745707 items:
4570845708 type: string
4570945709 type: array
45710+ triage_state:
45711+ $ref: "#/components/schemas/IoCTriageState"
45712+ triaged_at:
45713+ description: Timestamp when the indicator was last triaged.
45714+ format: date-time
45715+ type: string
45716+ triaged_by:
45717+ description: UUID of the user who last triaged the indicator.
45718+ type: string
4571045719 type: object
4571145720 IoCIndicatorDetailed:
4571245721 description: An indicator of compromise with extended context from your environment.
@@ -45825,6 +45834,20 @@ components:
4582545834 items:
4582645835 type: string
4582745836 type: array
45837+ triage_history:
45838+ description: Full triage history timeline. Returned only when `include_triage_history` is true.
45839+ items:
45840+ $ref: "#/components/schemas/IoCTriageEvent"
45841+ type: array
45842+ triage_state:
45843+ $ref: "#/components/schemas/IoCTriageState"
45844+ triaged_at:
45845+ description: Timestamp when the indicator was last triaged.
45846+ format: date-time
45847+ type: string
45848+ triaged_by:
45849+ description: UUID of the user who last triaged the indicator.
45850+ type: string
4582845851 users:
4582945852 additionalProperties:
4583045853 description: List of user identifiers in this category.
@@ -45863,6 +45886,103 @@ components:
4586345886 description: Name of the threat intelligence source.
4586445887 type: string
4586545888 type: object
45889+ IoCTriageEvent:
45890+ description: A single entry in an indicator's triage history timeline.
45891+ properties:
45892+ triage_state:
45893+ $ref: "#/components/schemas/IoCTriageState"
45894+ triaged_at:
45895+ description: Timestamp when this triage action occurred.
45896+ format: date-time
45897+ type: string
45898+ triaged_by:
45899+ description: UUID of the user who performed this triage action.
45900+ type: string
45901+ type: object
45902+ IoCTriageState:
45903+ description: Current triage state of the indicator.
45904+ enum:
45905+ - not_reviewed
45906+ - reviewed
45907+ example: not_reviewed
45908+ type: string
45909+ x-enum-varnames:
45910+ - NOT_REVIEWED
45911+ - REVIEWED
45912+ IoCTriageWriteRequest:
45913+ description: Request body for creating or updating an indicator triage state.
45914+ properties:
45915+ data:
45916+ $ref: "#/components/schemas/IoCTriageWriteRequestData"
45917+ required:
45918+ - data
45919+ type: object
45920+ IoCTriageWriteRequestAttributes:
45921+ description: Attributes for setting an indicator's triage state.
45922+ properties:
45923+ indicator:
45924+ description: The indicator value to triage (for example, an IP address or domain).
45925+ example: "192.0.2.1"
45926+ type: string
45927+ triage_state:
45928+ $ref: "#/components/schemas/IoCTriageState"
45929+ required:
45930+ - indicator
45931+ - triage_state
45932+ type: object
45933+ IoCTriageWriteRequestData:
45934+ description: Data object for the triage write request.
45935+ properties:
45936+ attributes:
45937+ $ref: "#/components/schemas/IoCTriageWriteRequestAttributes"
45938+ type:
45939+ default: ioc_triage_state
45940+ description: Triage state resource type.
45941+ example: ioc_triage_state
45942+ type: string
45943+ required:
45944+ - type
45945+ - attributes
45946+ type: object
45947+ IoCTriageWriteResponse:
45948+ description: Response for the create indicator triage state endpoint.
45949+ properties:
45950+ data:
45951+ $ref: "#/components/schemas/IoCTriageWriteResponseData"
45952+ type: object
45953+ IoCTriageWriteResponseAttributes:
45954+ description: Attributes of a created or updated triage state.
45955+ properties:
45956+ created_at:
45957+ description: Timestamp when the triage record was created.
45958+ format: date-time
45959+ type: string
45960+ indicator:
45961+ description: The indicator value that was triaged.
45962+ type: string
45963+ triage_state:
45964+ $ref: "#/components/schemas/IoCTriageState"
45965+ triaged_at:
45966+ description: Timestamp when the triage state was set.
45967+ format: date-time
45968+ type: string
45969+ triaged_by:
45970+ description: UUID of the user who set the triage state.
45971+ type: string
45972+ type: object
45973+ IoCTriageWriteResponseData:
45974+ description: Data object of the triage write response.
45975+ properties:
45976+ attributes:
45977+ $ref: "#/components/schemas/IoCTriageWriteResponseAttributes"
45978+ id:
45979+ description: Unique identifier for the triage state record.
45980+ type: string
45981+ type:
45982+ default: ioc_triage_state
45983+ description: Triage state resource type.
45984+ type: string
45985+ type: object
4586645986 Issue:
4586745987 description: The issue matching the request.
4586845988 properties:
@@ -166859,6 +166979,9 @@ paths:
166859166979 permissions:
166860166980 - security_monitoring_findings_write
166861166981 - appsec_vm_write
166982+ x-unstable: |-
166983+ **Note**: This endpoint is in preview and is subject to change.
166984+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
166862166985 post:
166863166986 description: >-
166864166987 Create ServiceNow tickets for security findings.
@@ -166929,6 +167052,9 @@ paths:
166929167052 permissions:
166930167053 - security_monitoring_findings_write
166931167054 - appsec_vm_write
167055+ x-unstable: |-
167056+ **Note**: This endpoint is in preview and is subject to change.
167057+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
166932167058 /api/v2/security/sboms:
166933167059 get:
166934167060 description: |-
@@ -167323,6 +167449,25 @@ paths:
167323167449 schema:
167324167450 default: desc
167325167451 type: string
167452+ - description: When true, return only OCSF field-based matches. When false, return regex/message-based matches.
167453+ in: query
167454+ name: ocsf
167455+ required: false
167456+ schema:
167457+ default: true
167458+ type: boolean
167459+ - description: Filter indicators whose triage state was updated by a specific user UUID.
167460+ in: query
167461+ name: worked_by
167462+ required: false
167463+ schema:
167464+ type: string
167465+ - description: Filter by triage state.
167466+ in: query
167467+ name: triage_state
167468+ required: false
167469+ schema:
167470+ $ref: "#/components/schemas/IoCTriageState"
167326167471 responses:
167327167472 "200":
167328167473 content:
@@ -167374,6 +167519,39 @@ paths:
167374167519 required: true
167375167520 schema:
167376167521 type: string
167522+ - description: When true, return only OCSF field-based matches. When false, return regex/message-based matches.
167523+ in: query
167524+ name: ocsf
167525+ required: false
167526+ schema:
167527+ default: true
167528+ type: boolean
167529+ - description: Include full triage history for the indicator.
167530+ in: query
167531+ name: include_triage_history
167532+ required: false
167533+ schema:
167534+ default: false
167535+ type: boolean
167536+ - description: Maximum number of triage history events returned. Only applied when `include_triage_history` is true.
167537+ in: query
167538+ name: triage_history_limit
167539+ required: false
167540+ schema:
167541+ default: 50
167542+ format: int32
167543+ maximum: 1000
167544+ minimum: 1
167545+ type: integer
167546+ - description: Pagination offset into the triage history. Only applied when `include_triage_history` is true.
167547+ in: query
167548+ name: triage_history_offset
167549+ required: false
167550+ schema:
167551+ default: 0
167552+ format: int32
167553+ maximum: 2147483647
167554+ type: integer
167377167555 responses:
167378167556 "200":
167379167557 content:
@@ -167411,6 +167589,62 @@ paths:
167411167589 x-unstable: |-
167412167590 **Note**: This endpoint is in beta and may be subject to changes.
167413167591 Please check the documentation regularly for updates.
167592+ /api/v2/security/siem/ioc-explorer/triage:
167593+ post:
167594+ description: |-
167595+ Set the triage state of an indicator of compromise (IoC). This creates or
167596+ updates the triage state for the indicator in your organization.
167597+ operationId: CreateIoCTriageState
167598+ requestBody:
167599+ content:
167600+ "application/json":
167601+ examples:
167602+ default:
167603+ value:
167604+ data:
167605+ attributes:
167606+ indicator: "192.0.2.1"
167607+ triage_state: reviewed
167608+ type: ioc_triage_state
167609+ schema:
167610+ $ref: "#/components/schemas/IoCTriageWriteRequest"
167611+ description: The triage state to set for the indicator.
167612+ required: true
167613+ responses:
167614+ "201":
167615+ content:
167616+ "application/json":
167617+ examples:
167618+ default:
167619+ value:
167620+ data:
167621+ attributes:
167622+ created_at: "2026-06-04T12:00:00Z"
167623+ indicator: "192.0.2.1"
167624+ triage_state: reviewed
167625+ triaged_at: "2026-06-04T12:00:00Z"
167626+ triaged_by: 11111111-2222-3333-4444-555555555555
167627+ id: abc-123
167628+ type: ioc_triage_state
167629+ schema:
167630+ $ref: "#/components/schemas/IoCTriageWriteResponse"
167631+ description: Created
167632+ "400":
167633+ $ref: "#/components/responses/BadRequestResponse"
167634+ "403":
167635+ $ref: "#/components/responses/NotAuthorizedResponse"
167636+ "429":
167637+ $ref: "#/components/responses/TooManyRequestsResponse"
167638+ security:
167639+ - apiKeyAuth: []
167640+ appKeyAuth: []
167641+ - AuthZ:
167642+ - security_monitoring_signals_write
167643+ summary: Create or update an indicator triage state
167644+ tags: ["Security Monitoring"]
167645+ x-unstable: |-
167646+ **Note**: This endpoint is in beta and may be subject to changes.
167647+ Please check the documentation regularly for updates.
167414167648 /api/v2/security/signals/notification_rules:
167415167649 get:
167416167650 description: Returns the list of notification rules for security signals.
0 commit comments