@@ -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:
@@ -166940,6 +167060,9 @@ paths:
166940167060 permissions:
166941167061 - security_monitoring_findings_write
166942167062 - appsec_vm_write
167063+ x-unstable: |-
167064+ **Note**: This endpoint is in preview and is subject to change.
167065+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
166943167066 post:
166944167067 description: >-
166945167068 Create ServiceNow tickets for security findings.
@@ -167010,6 +167133,9 @@ paths:
167010167133 permissions:
167011167134 - security_monitoring_findings_write
167012167135 - appsec_vm_write
167136+ x-unstable: |-
167137+ **Note**: This endpoint is in preview and is subject to change.
167138+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
167013167139 /api/v2/security/sboms:
167014167140 get:
167015167141 description: |-
@@ -167404,6 +167530,25 @@ paths:
167404167530 schema:
167405167531 default: desc
167406167532 type: string
167533+ - description: When true, return only OCSF field-based matches. When false, return regex/message-based matches.
167534+ in: query
167535+ name: ocsf
167536+ required: false
167537+ schema:
167538+ default: true
167539+ type: boolean
167540+ - description: Filter indicators whose triage state was updated by a specific user UUID.
167541+ in: query
167542+ name: worked_by
167543+ required: false
167544+ schema:
167545+ type: string
167546+ - description: Filter by triage state.
167547+ in: query
167548+ name: triage_state
167549+ required: false
167550+ schema:
167551+ $ref: "#/components/schemas/IoCTriageState"
167407167552 responses:
167408167553 "200":
167409167554 content:
@@ -167455,6 +167600,39 @@ paths:
167455167600 required: true
167456167601 schema:
167457167602 type: string
167603+ - description: When true, return only OCSF field-based matches. When false, return regex/message-based matches.
167604+ in: query
167605+ name: ocsf
167606+ required: false
167607+ schema:
167608+ default: true
167609+ type: boolean
167610+ - description: Include full triage history for the indicator.
167611+ in: query
167612+ name: include_triage_history
167613+ required: false
167614+ schema:
167615+ default: false
167616+ type: boolean
167617+ - description: Maximum number of triage history events returned. Only applied when `include_triage_history` is true.
167618+ in: query
167619+ name: triage_history_limit
167620+ required: false
167621+ schema:
167622+ default: 50
167623+ format: int32
167624+ maximum: 1000
167625+ minimum: 1
167626+ type: integer
167627+ - description: Pagination offset into the triage history. Only applied when `include_triage_history` is true.
167628+ in: query
167629+ name: triage_history_offset
167630+ required: false
167631+ schema:
167632+ default: 0
167633+ format: int32
167634+ maximum: 2147483647
167635+ type: integer
167458167636 responses:
167459167637 "200":
167460167638 content:
@@ -167492,6 +167670,62 @@ paths:
167492167670 x-unstable: |-
167493167671 **Note**: This endpoint is in beta and may be subject to changes.
167494167672 Please check the documentation regularly for updates.
167673+ /api/v2/security/siem/ioc-explorer/triage:
167674+ post:
167675+ description: |-
167676+ Set the triage state of an indicator of compromise (IoC). This creates or
167677+ updates the triage state for the indicator in your organization.
167678+ operationId: CreateIoCTriageState
167679+ requestBody:
167680+ content:
167681+ "application/json":
167682+ examples:
167683+ default:
167684+ value:
167685+ data:
167686+ attributes:
167687+ indicator: "192.0.2.1"
167688+ triage_state: reviewed
167689+ type: ioc_triage_state
167690+ schema:
167691+ $ref: "#/components/schemas/IoCTriageWriteRequest"
167692+ description: The triage state to set for the indicator.
167693+ required: true
167694+ responses:
167695+ "201":
167696+ content:
167697+ "application/json":
167698+ examples:
167699+ default:
167700+ value:
167701+ data:
167702+ attributes:
167703+ created_at: "2026-06-04T12:00:00Z"
167704+ indicator: "192.0.2.1"
167705+ triage_state: reviewed
167706+ triaged_at: "2026-06-04T12:00:00Z"
167707+ triaged_by: 11111111-2222-3333-4444-555555555555
167708+ id: abc-123
167709+ type: ioc_triage_state
167710+ schema:
167711+ $ref: "#/components/schemas/IoCTriageWriteResponse"
167712+ description: Created
167713+ "400":
167714+ $ref: "#/components/responses/BadRequestResponse"
167715+ "403":
167716+ $ref: "#/components/responses/NotAuthorizedResponse"
167717+ "429":
167718+ $ref: "#/components/responses/TooManyRequestsResponse"
167719+ security:
167720+ - apiKeyAuth: []
167721+ appKeyAuth: []
167722+ - AuthZ:
167723+ - security_monitoring_signals_write
167724+ summary: Create or update an indicator triage state
167725+ tags: ["Security Monitoring"]
167726+ x-unstable: |-
167727+ **Note**: This endpoint is in beta and may be subject to changes.
167728+ Please check the documentation regularly for updates.
167495167729 /api/v2/security/signals/notification_rules:
167496167730 get:
167497167731 description: Returns the list of notification rules for security signals.
0 commit comments