@@ -86990,6 +86990,229 @@ components:
8699086990 example: "report_id"
8699186991 type: string
8699286992 type: object
86993+ STIXBundleRequest:
86994+ additionalProperties: {}
86995+ description: A STIX 2.1 bundle containing threat intelligence indicator objects.
86996+ properties:
86997+ id:
86998+ description: The STIX bundle identifier.
86999+ example: bundle--11111111-1111-4111-8111-111111111111
87000+ type: string
87001+ objects:
87002+ description: The indicator objects included in the bundle.
87003+ example:
87004+ - created: "2026-07-22T12:00:00Z"
87005+ id: indicator--22222222-2222-4222-8222-222222222222
87006+ modified: "2026-07-22T12:00:00Z"
87007+ pattern: "[ipv4-addr:value = '198.51.100.42']"
87008+ pattern_type: stix
87009+ spec_version: "2.1"
87010+ type: indicator
87011+ valid_from: "2026-07-22T12:00:00Z"
87012+ items:
87013+ $ref: "#/components/schemas/STIXIndicatorObject"
87014+ type: array
87015+ spec_version:
87016+ $ref: "#/components/schemas/STIXSpecVersion"
87017+ type:
87018+ $ref: "#/components/schemas/STIXBundleType"
87019+ required:
87020+ - type
87021+ - id
87022+ - objects
87023+ type: object
87024+ STIXBundleType:
87025+ description: The STIX object type for a bundle.
87026+ enum:
87027+ - bundle
87028+ example: bundle
87029+ type: string
87030+ x-enum-varnames:
87031+ - BUNDLE
87032+ STIXContentEncoding:
87033+ description: The content encoding applied to the request body.
87034+ enum:
87035+ - gzip
87036+ example: gzip
87037+ type: string
87038+ x-enum-varnames:
87039+ - GZIP
87040+ STIXIndicatorObject:
87041+ additionalProperties: {}
87042+ description: A STIX 2.1 indicator object.
87043+ properties:
87044+ confidence:
87045+ description: The confidence in the correctness of the indicator, from 0 through 100.
87046+ example: 80
87047+ format: int32
87048+ maximum: 100
87049+ minimum: 0
87050+ type: integer
87051+ created:
87052+ description: The time when the indicator was created.
87053+ example: "2026-07-22T12:00:00Z"
87054+ format: date-time
87055+ type: string
87056+ external_references:
87057+ description: Optional external reference metadata preserved with the indicator but not interpreted during ingestion.
87058+ items:
87059+ $ref: "#/components/schemas/STIXMetadataObject"
87060+ type: array
87061+ id:
87062+ description: The STIX indicator identifier.
87063+ example: indicator--22222222-2222-4222-8222-222222222222
87064+ type: string
87065+ indicator_types:
87066+ description: The open vocabulary terms that categorize the indicator.
87067+ example:
87068+ - malicious-activity
87069+ items:
87070+ type: string
87071+ type: array
87072+ kill_chain_phases:
87073+ description: Optional kill chain metadata preserved with the indicator but not interpreted during ingestion.
87074+ items:
87075+ $ref: "#/components/schemas/STIXMetadataObject"
87076+ type: array
87077+ labels:
87078+ description: Labels associated with the indicator.
87079+ example:
87080+ - synthetic
87081+ items:
87082+ type: string
87083+ type: array
87084+ modified:
87085+ description: The time when the indicator was last modified.
87086+ example: "2026-07-22T12:00:00Z"
87087+ format: date-time
87088+ type: string
87089+ object_marking_refs:
87090+ description: References to marking definition objects that apply to the indicator.
87091+ example:
87092+ - marking-definition--33333333-3333-4333-8333-333333333333
87093+ items:
87094+ type: string
87095+ type: array
87096+ pattern:
87097+ description: The STIX pattern that identifies the observable.
87098+ example: "[ipv4-addr:value = '198.51.100.42']"
87099+ type: string
87100+ pattern_type:
87101+ $ref: "#/components/schemas/STIXPatternType"
87102+ revoked:
87103+ description: Whether the indicator has been revoked.
87104+ example: false
87105+ type: boolean
87106+ spec_version:
87107+ $ref: "#/components/schemas/STIXSpecVersion"
87108+ type:
87109+ $ref: "#/components/schemas/STIXIndicatorType"
87110+ valid_from:
87111+ description: The time from which the indicator is considered valid.
87112+ example: "2026-07-22T12:00:00Z"
87113+ format: date-time
87114+ type: string
87115+ valid_until:
87116+ description: The time until which the indicator is considered valid.
87117+ example: "2027-07-22T12:00:00Z"
87118+ format: date-time
87119+ type: string
87120+ required:
87121+ - type
87122+ - id
87123+ - spec_version
87124+ - created
87125+ - modified
87126+ - pattern
87127+ - pattern_type
87128+ - valid_from
87129+ type: object
87130+ STIXIndicatorType:
87131+ description: The STIX object type for an indicator.
87132+ enum:
87133+ - indicator
87134+ example: indicator
87135+ type: string
87136+ x-enum-varnames:
87137+ - INDICATOR
87138+ STIXIngestResponse:
87139+ description: The response from a completed STIX ingestion request.
87140+ properties:
87141+ data:
87142+ $ref: "#/components/schemas/STIXIngestResponseData"
87143+ required:
87144+ - data
87145+ type: object
87146+ STIXIngestResponseAttributes:
87147+ description: Counters describing the result of the STIX ingestion request.
87148+ properties:
87149+ added:
87150+ description: The number of supported indicators added.
87151+ example: 1
87152+ format: int64
87153+ minimum: 0
87154+ type: integer
87155+ invalid:
87156+ description: The number of indicators with patterns that could not be parsed.
87157+ example: 0
87158+ format: int64
87159+ minimum: 0
87160+ type: integer
87161+ unsupported:
87162+ description: The number of unsupported objects or patterns.
87163+ example: 0
87164+ format: int64
87165+ minimum: 0
87166+ type: integer
87167+ required:
87168+ - added
87169+ - unsupported
87170+ - invalid
87171+ type: object
87172+ STIXIngestResponseData:
87173+ description: The JSON:API resource describing the completed STIX ingestion request.
87174+ properties:
87175+ attributes:
87176+ $ref: "#/components/schemas/STIXIngestResponseAttributes"
87177+ id:
87178+ description: The normalized vendor identifier.
87179+ example: acme
87180+ type: string
87181+ type:
87182+ $ref: "#/components/schemas/STIXIngestResponseType"
87183+ required:
87184+ - type
87185+ - id
87186+ - attributes
87187+ type: object
87188+ STIXIngestResponseType:
87189+ description: The STIX ingestion resource type.
87190+ enum:
87191+ - threat-intel-stix-ingest
87192+ example: threat-intel-stix-ingest
87193+ type: string
87194+ x-enum-varnames:
87195+ - THREAT_INTEL_STIX_INGEST
87196+ STIXMetadataObject:
87197+ additionalProperties: {}
87198+ description: An opaque STIX metadata object.
87199+ type: object
87200+ STIXPatternType:
87201+ description: The supported STIX pattern language.
87202+ enum:
87203+ - stix
87204+ example: stix
87205+ type: string
87206+ x-enum-varnames:
87207+ - STIX
87208+ STIXSpecVersion:
87209+ description: The supported STIX specification version.
87210+ enum:
87211+ - "2.1"
87212+ example: "2.1"
87213+ type: string
87214+ x-enum-varnames:
87215+ - VERSION_2_1
8699387216 SalesforceIncidentsOrganizationResponseAttributes:
8699487217 description: Attributes of a Salesforce organization connected to the Datadog Salesforce integration.
8699587218 properties:
@@ -183557,6 +183780,114 @@ paths:
183557183780 operator: OR
183558183781 permissions:
183559183782 - security_monitoring_notification_profiles_write
183783+ /api/v2/security/threat-intel/stix:
183784+ post:
183785+ description: |-
183786+ 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.
183787+
183788+ 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.
183789+
183790+ 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.
183791+ operationId: IngestStixThreatIntel
183792+ parameters:
183793+ - description: >-
183794+ 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.
183795+ example: acme
183796+ in: header
183797+ name: ti_vendor
183798+ required: true
183799+ schema:
183800+ maxLength: 10
183801+ minLength: 1
183802+ type: string
183803+ - description: Content encoding for the request body. Use gzip for a compressed STIX bundle.
183804+ in: header
183805+ name: Content-Encoding
183806+ required: false
183807+ schema:
183808+ $ref: "#/components/schemas/STIXContentEncoding"
183809+ requestBody:
183810+ content:
183811+ application/json:
183812+ examples:
183813+ default:
183814+ value:
183815+ id: bundle--11111111-1111-4111-8111-111111111111
183816+ objects:
183817+ - created: "2026-07-22T12:00:00Z"
183818+ id: indicator--22222222-2222-4222-8222-222222222222
183819+ modified: "2026-07-22T12:00:00Z"
183820+ pattern: "[ipv4-addr:value = '198.51.100.42']"
183821+ pattern_type: stix
183822+ spec_version: "2.1"
183823+ type: indicator
183824+ valid_from: "2026-07-22T12:00:00Z"
183825+ spec_version: "2.1"
183826+ type: bundle
183827+ schema:
183828+ $ref: "#/components/schemas/STIXBundleRequest"
183829+ description: >-
183830+ 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.
183831+ required: true
183832+ responses:
183833+ "200":
183834+ content:
183835+ application/json:
183836+ examples:
183837+ default:
183838+ value:
183839+ data:
183840+ attributes:
183841+ added: 1
183842+ invalid: 0
183843+ unsupported: 0
183844+ id: acme
183845+ type: threat-intel-stix-ingest
183846+ schema:
183847+ $ref: "#/components/schemas/STIXIngestResponse"
183848+ description: OK
183849+ "400":
183850+ $ref: "#/components/responses/BadRequestResponse"
183851+ "401":
183852+ $ref: "#/components/responses/UnauthorizedResponse"
183853+ "403":
183854+ $ref: "#/components/responses/ForbiddenResponse"
183855+ "413":
183856+ content:
183857+ application/json:
183858+ schema:
183859+ $ref: "#/components/schemas/APIErrorResponse"
183860+ description: Payload Too Large
183861+ "429":
183862+ $ref: "#/components/responses/TooManyRequestsResponse"
183863+ "502":
183864+ content:
183865+ application/json:
183866+ schema:
183867+ $ref: "#/components/schemas/APIErrorResponse"
183868+ description: Bad Gateway
183869+ "503":
183870+ content:
183871+ application/json:
183872+ schema:
183873+ $ref: "#/components/schemas/APIErrorResponse"
183874+ description: Service Unavailable
183875+ security:
183876+ - apiKeyAuth: []
183877+ appKeyAuth: []
183878+ - AuthZ:
183879+ - reference_tables_write
183880+ summary: Ingest STIX threat intelligence
183881+ tags:
183882+ - Threat Intelligence
183883+ x-codegen-request-body-name: body
183884+ x-permission:
183885+ operator: OR
183886+ permissions:
183887+ - reference_tables_write
183888+ x-unstable: |-
183889+ **Note**: This endpoint is in preview and is subject to change.
183890+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
183560183891 /api/v2/security/vulnerabilities:
183561183892 get:
183562183893 deprecated: true
@@ -206730,6 +207061,8 @@ tags:
206730207061 - description: |-
206731207062 Search and manage flaky tests through Test Optimization. See the [Test Optimization page](https://docs.datadoghq.com/tests/) for more information.
206732207063 name: Test Optimization
207064+ - description: Ingest and manage threat intelligence data for security enrichment and investigation.
207065+ name: Threat Intelligence
206733207066 - description: |-
206734207067 The usage metering API allows you to get hourly, daily, and
206735207068 monthly usage across multiple facets of Datadog.
0 commit comments