@@ -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.
0 commit comments