@@ -85994,6 +85994,229 @@ components:
8599485994 example: "report_id"
8599585995 type: string
8599685996 type: object
85997+ STIXBundleRequest:
85998+ additionalProperties: {}
85999+ description: A STIX 2.1 bundle containing threat intelligence indicator objects.
86000+ properties:
86001+ id:
86002+ description: The STIX bundle identifier.
86003+ example: bundle--11111111-1111-4111-8111-111111111111
86004+ type: string
86005+ objects:
86006+ description: The indicator objects included in the bundle.
86007+ example:
86008+ - created: "2026-07-22T12:00:00Z"
86009+ id: indicator--22222222-2222-4222-8222-222222222222
86010+ modified: "2026-07-22T12:00:00Z"
86011+ pattern: "[ipv4-addr:value = '198.51.100.42']"
86012+ pattern_type: stix
86013+ spec_version: "2.1"
86014+ type: indicator
86015+ valid_from: "2026-07-22T12:00:00Z"
86016+ items:
86017+ $ref: "#/components/schemas/STIXIndicatorObject"
86018+ type: array
86019+ spec_version:
86020+ $ref: "#/components/schemas/STIXSpecVersion"
86021+ type:
86022+ $ref: "#/components/schemas/STIXBundleType"
86023+ required:
86024+ - type
86025+ - id
86026+ - objects
86027+ type: object
86028+ STIXBundleType:
86029+ description: The STIX object type for a bundle.
86030+ enum:
86031+ - bundle
86032+ example: bundle
86033+ type: string
86034+ x-enum-varnames:
86035+ - BUNDLE
86036+ STIXContentEncoding:
86037+ description: The content encoding applied to the request body.
86038+ enum:
86039+ - gzip
86040+ example: gzip
86041+ type: string
86042+ x-enum-varnames:
86043+ - GZIP
86044+ STIXIndicatorObject:
86045+ additionalProperties: {}
86046+ description: A STIX 2.1 indicator object.
86047+ properties:
86048+ confidence:
86049+ description: The confidence in the correctness of the indicator, from 0 through 100.
86050+ example: 80
86051+ format: int32
86052+ maximum: 100
86053+ minimum: 0
86054+ type: integer
86055+ created:
86056+ description: The time when the indicator was created.
86057+ example: "2026-07-22T12:00:00Z"
86058+ format: date-time
86059+ type: string
86060+ external_references:
86061+ description: Optional external reference metadata preserved with the indicator but not interpreted during ingestion.
86062+ items:
86063+ $ref: "#/components/schemas/STIXMetadataObject"
86064+ type: array
86065+ id:
86066+ description: The STIX indicator identifier.
86067+ example: indicator--22222222-2222-4222-8222-222222222222
86068+ type: string
86069+ indicator_types:
86070+ description: The open vocabulary terms that categorize the indicator.
86071+ example:
86072+ - malicious-activity
86073+ items:
86074+ type: string
86075+ type: array
86076+ kill_chain_phases:
86077+ description: Optional kill chain metadata preserved with the indicator but not interpreted during ingestion.
86078+ items:
86079+ $ref: "#/components/schemas/STIXMetadataObject"
86080+ type: array
86081+ labels:
86082+ description: Labels associated with the indicator.
86083+ example:
86084+ - synthetic
86085+ items:
86086+ type: string
86087+ type: array
86088+ modified:
86089+ description: The time when the indicator was last modified.
86090+ example: "2026-07-22T12:00:00Z"
86091+ format: date-time
86092+ type: string
86093+ object_marking_refs:
86094+ description: References to marking definition objects that apply to the indicator.
86095+ example:
86096+ - marking-definition--33333333-3333-4333-8333-333333333333
86097+ items:
86098+ type: string
86099+ type: array
86100+ pattern:
86101+ description: The STIX pattern that identifies the observable.
86102+ example: "[ipv4-addr:value = '198.51.100.42']"
86103+ type: string
86104+ pattern_type:
86105+ $ref: "#/components/schemas/STIXPatternType"
86106+ revoked:
86107+ description: Whether the indicator has been revoked.
86108+ example: false
86109+ type: boolean
86110+ spec_version:
86111+ $ref: "#/components/schemas/STIXSpecVersion"
86112+ type:
86113+ $ref: "#/components/schemas/STIXIndicatorType"
86114+ valid_from:
86115+ description: The time from which the indicator is considered valid.
86116+ example: "2026-07-22T12:00:00Z"
86117+ format: date-time
86118+ type: string
86119+ valid_until:
86120+ description: The time until which the indicator is considered valid.
86121+ example: "2027-07-22T12:00:00Z"
86122+ format: date-time
86123+ type: string
86124+ required:
86125+ - type
86126+ - id
86127+ - spec_version
86128+ - created
86129+ - modified
86130+ - pattern
86131+ - pattern_type
86132+ - valid_from
86133+ type: object
86134+ STIXIndicatorType:
86135+ description: The STIX object type for an indicator.
86136+ enum:
86137+ - indicator
86138+ example: indicator
86139+ type: string
86140+ x-enum-varnames:
86141+ - INDICATOR
86142+ STIXIngestResponse:
86143+ description: The response from a completed STIX ingestion request.
86144+ properties:
86145+ data:
86146+ $ref: "#/components/schemas/STIXIngestResponseData"
86147+ required:
86148+ - data
86149+ type: object
86150+ STIXIngestResponseAttributes:
86151+ description: Counters describing the result of the STIX ingestion request.
86152+ properties:
86153+ added:
86154+ description: The number of supported indicators added.
86155+ example: 1
86156+ format: int64
86157+ minimum: 0
86158+ type: integer
86159+ invalid:
86160+ description: The number of indicators with patterns that could not be parsed.
86161+ example: 0
86162+ format: int64
86163+ minimum: 0
86164+ type: integer
86165+ unsupported:
86166+ description: The number of unsupported objects or patterns.
86167+ example: 0
86168+ format: int64
86169+ minimum: 0
86170+ type: integer
86171+ required:
86172+ - added
86173+ - unsupported
86174+ - invalid
86175+ type: object
86176+ STIXIngestResponseData:
86177+ description: The JSON:API resource describing the completed STIX ingestion request.
86178+ properties:
86179+ attributes:
86180+ $ref: "#/components/schemas/STIXIngestResponseAttributes"
86181+ id:
86182+ description: The normalized vendor identifier.
86183+ example: acme
86184+ type: string
86185+ type:
86186+ $ref: "#/components/schemas/STIXIngestResponseType"
86187+ required:
86188+ - type
86189+ - id
86190+ - attributes
86191+ type: object
86192+ STIXIngestResponseType:
86193+ description: The STIX ingestion resource type.
86194+ enum:
86195+ - threat-intel-stix-ingest
86196+ example: threat-intel-stix-ingest
86197+ type: string
86198+ x-enum-varnames:
86199+ - THREAT_INTEL_STIX_INGEST
86200+ STIXMetadataObject:
86201+ additionalProperties: {}
86202+ description: An opaque STIX metadata object.
86203+ type: object
86204+ STIXPatternType:
86205+ description: The supported STIX pattern language.
86206+ enum:
86207+ - stix
86208+ example: stix
86209+ type: string
86210+ x-enum-varnames:
86211+ - STIX
86212+ STIXSpecVersion:
86213+ description: The supported STIX specification version.
86214+ enum:
86215+ - "2.1"
86216+ example: "2.1"
86217+ type: string
86218+ x-enum-varnames:
86219+ - VERSION_2_1
8599786220 SalesforceIncidentsOrganizationResponseAttributes:
8599886221 description: Attributes of a Salesforce organization connected to the Datadog Salesforce integration.
8599986222 properties:
@@ -181423,6 +181646,114 @@ paths:
181423181646 operator: OR
181424181647 permissions:
181425181648 - security_monitoring_notification_profiles_write
181649+ /api/v2/security/threat-intel/stix:
181650+ post:
181651+ description: |-
181652+ Ingest a STIX 2.1 bundle containing threat intelligence indicators. Only indicator objects are supported. Supported indicator patterns contain IPv4 addresses, IPv6 addresses, domain names, or SHA-256 file hashes.
181653+
181654+ Unsupported objects and patterns increment the `unsupported` counter. Patterns that cannot be parsed increment the `invalid` counter. Processing is best effort, so valid supported indicators in the same bundle are still added.
181655+
181656+ A successful response means ingestion has completed. Reference-table materialization and enrichment happen asynchronously. Requests are limited to 50 MB and 10 requests per second per API key. Gzip-compressed request bodies are supported.
181657+ operationId: IngestStixThreatIntel
181658+ parameters:
181659+ - description: >-
181660+ Vendor identifier for the feed. The value must not exceed 10 characters. Datadog normalizes the accepted value to lowercase, converts non-alphanumeric characters to underscores, and trims leading and trailing underscores.
181661+ example: acme
181662+ in: header
181663+ name: ti_vendor
181664+ required: true
181665+ schema:
181666+ maxLength: 10
181667+ minLength: 1
181668+ type: string
181669+ - description: Content encoding for the request body. Use gzip for a compressed STIX bundle.
181670+ in: header
181671+ name: Content-Encoding
181672+ required: false
181673+ schema:
181674+ $ref: "#/components/schemas/STIXContentEncoding"
181675+ requestBody:
181676+ content:
181677+ application/json:
181678+ examples:
181679+ default:
181680+ value:
181681+ id: bundle--11111111-1111-4111-8111-111111111111
181682+ objects:
181683+ - created: "2026-07-22T12:00:00Z"
181684+ id: indicator--22222222-2222-4222-8222-222222222222
181685+ modified: "2026-07-22T12:00:00Z"
181686+ pattern: "[ipv4-addr:value = '198.51.100.42']"
181687+ pattern_type: stix
181688+ spec_version: "2.1"
181689+ type: indicator
181690+ valid_from: "2026-07-22T12:00:00Z"
181691+ spec_version: "2.1"
181692+ type: bundle
181693+ schema:
181694+ $ref: "#/components/schemas/STIXBundleRequest"
181695+ description: >-
181696+ A STIX 2.1 bundle containing indicator objects. The maximum request size is 50 MB. When `Content-Encoding: gzip` is used, the limit applies to the compressed bytes received.
181697+ required: true
181698+ responses:
181699+ "200":
181700+ content:
181701+ application/json:
181702+ examples:
181703+ default:
181704+ value:
181705+ data:
181706+ attributes:
181707+ added: 1
181708+ invalid: 0
181709+ unsupported: 0
181710+ id: acme
181711+ type: threat-intel-stix-ingest
181712+ schema:
181713+ $ref: "#/components/schemas/STIXIngestResponse"
181714+ description: OK
181715+ "400":
181716+ $ref: "#/components/responses/BadRequestResponse"
181717+ "401":
181718+ $ref: "#/components/responses/UnauthorizedResponse"
181719+ "403":
181720+ $ref: "#/components/responses/ForbiddenResponse"
181721+ "413":
181722+ content:
181723+ application/json:
181724+ schema:
181725+ $ref: "#/components/schemas/APIErrorResponse"
181726+ description: Payload Too Large
181727+ "429":
181728+ $ref: "#/components/responses/TooManyRequestsResponse"
181729+ "502":
181730+ content:
181731+ application/json:
181732+ schema:
181733+ $ref: "#/components/schemas/APIErrorResponse"
181734+ description: Bad Gateway
181735+ "503":
181736+ content:
181737+ application/json:
181738+ schema:
181739+ $ref: "#/components/schemas/APIErrorResponse"
181740+ description: Service Unavailable
181741+ security:
181742+ - apiKeyAuth: []
181743+ appKeyAuth: []
181744+ - AuthZ:
181745+ - reference_tables_write
181746+ summary: Ingest STIX threat intelligence
181747+ tags:
181748+ - Threat Intelligence
181749+ x-codegen-request-body-name: body
181750+ x-permission:
181751+ operator: OR
181752+ permissions:
181753+ - reference_tables_write
181754+ x-unstable: |-
181755+ **Note**: This endpoint is in preview and is subject to change.
181756+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
181426181757 /api/v2/security/vulnerabilities:
181427181758 get:
181428181759 deprecated: true
@@ -204572,6 +204903,8 @@ tags:
204572204903 - description: |-
204573204904 Search and manage flaky tests through Test Optimization. See the [Test Optimization page](https://docs.datadoghq.com/tests/) for more information.
204574204905 name: Test Optimization
204906+ - description: Ingest and manage threat intelligence data for security enrichment and investigation.
204907+ name: Threat Intelligence
204575204908 - description: |-
204576204909 The usage metering API allows you to get hourly, daily, and
204577204910 monthly usage across multiple facets of Datadog.
0 commit comments