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