@@ -93640,6 +93640,229 @@ components:
9364093640 example: "report_id"
9364193641 type: string
9364293642 type: object
93643+ STIXBundleRequest:
93644+ additionalProperties: {}
93645+ description: A STIX 2.1 bundle containing threat intelligence indicator objects.
93646+ properties:
93647+ id:
93648+ description: The STIX bundle identifier.
93649+ example: bundle--11111111-1111-4111-8111-111111111111
93650+ type: string
93651+ objects:
93652+ description: The indicator objects included in the bundle.
93653+ example:
93654+ - created: "2026-07-22T12:00:00Z"
93655+ id: indicator--22222222-2222-4222-8222-222222222222
93656+ modified: "2026-07-22T12:00:00Z"
93657+ pattern: "[ipv4-addr:value = '198.51.100.42']"
93658+ pattern_type: stix
93659+ spec_version: "2.1"
93660+ type: indicator
93661+ valid_from: "2026-07-22T12:00:00Z"
93662+ items:
93663+ $ref: "#/components/schemas/STIXIndicatorObject"
93664+ type: array
93665+ spec_version:
93666+ $ref: "#/components/schemas/STIXSpecVersion"
93667+ type:
93668+ $ref: "#/components/schemas/STIXBundleType"
93669+ required:
93670+ - type
93671+ - id
93672+ - objects
93673+ type: object
93674+ STIXBundleType:
93675+ description: The STIX object type for a bundle.
93676+ enum:
93677+ - bundle
93678+ example: bundle
93679+ type: string
93680+ x-enum-varnames:
93681+ - BUNDLE
93682+ STIXContentEncoding:
93683+ description: The content encoding applied to the request body.
93684+ enum:
93685+ - gzip
93686+ example: gzip
93687+ type: string
93688+ x-enum-varnames:
93689+ - GZIP
93690+ STIXIndicatorObject:
93691+ additionalProperties: {}
93692+ description: A STIX 2.1 indicator object.
93693+ properties:
93694+ confidence:
93695+ description: The confidence in the correctness of the indicator, from 0 through 100.
93696+ example: 80
93697+ format: int32
93698+ maximum: 100
93699+ minimum: 0
93700+ type: integer
93701+ created:
93702+ description: The time when the indicator was created.
93703+ example: "2026-07-22T12:00:00Z"
93704+ format: date-time
93705+ type: string
93706+ external_references:
93707+ description: Optional external reference metadata preserved with the indicator but not interpreted during ingestion.
93708+ items:
93709+ $ref: "#/components/schemas/STIXMetadataObject"
93710+ type: array
93711+ id:
93712+ description: The STIX indicator identifier.
93713+ example: indicator--22222222-2222-4222-8222-222222222222
93714+ type: string
93715+ indicator_types:
93716+ description: The open vocabulary terms that categorize the indicator.
93717+ example:
93718+ - malicious-activity
93719+ items:
93720+ type: string
93721+ type: array
93722+ kill_chain_phases:
93723+ description: Optional kill chain metadata preserved with the indicator but not interpreted during ingestion.
93724+ items:
93725+ $ref: "#/components/schemas/STIXMetadataObject"
93726+ type: array
93727+ labels:
93728+ description: Labels associated with the indicator.
93729+ example:
93730+ - synthetic
93731+ items:
93732+ type: string
93733+ type: array
93734+ modified:
93735+ description: The time when the indicator was last modified.
93736+ example: "2026-07-22T12:00:00Z"
93737+ format: date-time
93738+ type: string
93739+ object_marking_refs:
93740+ description: References to marking definition objects that apply to the indicator.
93741+ example:
93742+ - marking-definition--33333333-3333-4333-8333-333333333333
93743+ items:
93744+ type: string
93745+ type: array
93746+ pattern:
93747+ description: The STIX pattern that identifies the observable.
93748+ example: "[ipv4-addr:value = '198.51.100.42']"
93749+ type: string
93750+ pattern_type:
93751+ $ref: "#/components/schemas/STIXPatternType"
93752+ revoked:
93753+ description: Whether the indicator has been revoked.
93754+ example: false
93755+ type: boolean
93756+ spec_version:
93757+ $ref: "#/components/schemas/STIXSpecVersion"
93758+ type:
93759+ $ref: "#/components/schemas/STIXIndicatorType"
93760+ valid_from:
93761+ description: The time from which the indicator is considered valid.
93762+ example: "2026-07-22T12:00:00Z"
93763+ format: date-time
93764+ type: string
93765+ valid_until:
93766+ description: The time until which the indicator is considered valid.
93767+ example: "2027-07-22T12:00:00Z"
93768+ format: date-time
93769+ type: string
93770+ required:
93771+ - type
93772+ - id
93773+ - spec_version
93774+ - created
93775+ - modified
93776+ - pattern
93777+ - pattern_type
93778+ - valid_from
93779+ type: object
93780+ STIXIndicatorType:
93781+ description: The STIX object type for an indicator.
93782+ enum:
93783+ - indicator
93784+ example: indicator
93785+ type: string
93786+ x-enum-varnames:
93787+ - INDICATOR
93788+ STIXIngestResponse:
93789+ description: The response from a completed STIX ingestion request.
93790+ properties:
93791+ data:
93792+ $ref: "#/components/schemas/STIXIngestResponseData"
93793+ required:
93794+ - data
93795+ type: object
93796+ STIXIngestResponseAttributes:
93797+ description: Counters describing the result of the STIX ingestion request.
93798+ properties:
93799+ added:
93800+ description: The number of supported indicators added.
93801+ example: 1
93802+ format: int64
93803+ minimum: 0
93804+ type: integer
93805+ invalid:
93806+ description: The number of indicators with patterns that could not be parsed.
93807+ example: 0
93808+ format: int64
93809+ minimum: 0
93810+ type: integer
93811+ unsupported:
93812+ description: The number of unsupported objects or patterns.
93813+ example: 0
93814+ format: int64
93815+ minimum: 0
93816+ type: integer
93817+ required:
93818+ - added
93819+ - unsupported
93820+ - invalid
93821+ type: object
93822+ STIXIngestResponseData:
93823+ description: The JSON:API resource describing the completed STIX ingestion request.
93824+ properties:
93825+ attributes:
93826+ $ref: "#/components/schemas/STIXIngestResponseAttributes"
93827+ id:
93828+ description: The normalized vendor identifier.
93829+ example: acme
93830+ type: string
93831+ type:
93832+ $ref: "#/components/schemas/STIXIngestResponseType"
93833+ required:
93834+ - type
93835+ - id
93836+ - attributes
93837+ type: object
93838+ STIXIngestResponseType:
93839+ description: The STIX ingestion resource type.
93840+ enum:
93841+ - threat-intel-stix-ingest
93842+ example: threat-intel-stix-ingest
93843+ type: string
93844+ x-enum-varnames:
93845+ - THREAT_INTEL_STIX_INGEST
93846+ STIXMetadataObject:
93847+ additionalProperties: {}
93848+ description: An opaque STIX metadata object.
93849+ type: object
93850+ STIXPatternType:
93851+ description: The supported STIX pattern language.
93852+ enum:
93853+ - stix
93854+ example: stix
93855+ type: string
93856+ x-enum-varnames:
93857+ - STIX
93858+ STIXSpecVersion:
93859+ description: The supported STIX specification version.
93860+ enum:
93861+ - "2.1"
93862+ example: "2.1"
93863+ type: string
93864+ x-enum-varnames:
93865+ - VERSION_2_1
9364393866 SalesforceIncidentsOrganizationResponseAttributes:
9364493867 description: Attributes of a Salesforce organization connected to the Datadog Salesforce integration.
9364593868 properties:
@@ -194810,6 +195033,114 @@ paths:
194810195033 operator: OR
194811195034 permissions:
194812195035 - security_monitoring_notification_profiles_write
195036+ /api/v2/security/threat-intel/stix:
195037+ post:
195038+ description: |-
195039+ 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.
195040+
195041+ 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.
195042+
195043+ 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.
195044+ operationId: IngestStixThreatIntel
195045+ parameters:
195046+ - description: >-
195047+ 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.
195048+ example: acme
195049+ in: header
195050+ name: ti_vendor
195051+ required: true
195052+ schema:
195053+ maxLength: 10
195054+ minLength: 1
195055+ type: string
195056+ - description: Content encoding for the request body. Use gzip for a compressed STIX bundle.
195057+ in: header
195058+ name: Content-Encoding
195059+ required: false
195060+ schema:
195061+ $ref: "#/components/schemas/STIXContentEncoding"
195062+ requestBody:
195063+ content:
195064+ application/json:
195065+ examples:
195066+ default:
195067+ value:
195068+ id: bundle--11111111-1111-4111-8111-111111111111
195069+ objects:
195070+ - created: "2026-07-22T12:00:00Z"
195071+ id: indicator--22222222-2222-4222-8222-222222222222
195072+ modified: "2026-07-22T12:00:00Z"
195073+ pattern: "[ipv4-addr:value = '198.51.100.42']"
195074+ pattern_type: stix
195075+ spec_version: "2.1"
195076+ type: indicator
195077+ valid_from: "2026-07-22T12:00:00Z"
195078+ spec_version: "2.1"
195079+ type: bundle
195080+ schema:
195081+ $ref: "#/components/schemas/STIXBundleRequest"
195082+ description: >-
195083+ 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.
195084+ required: true
195085+ responses:
195086+ "200":
195087+ content:
195088+ application/json:
195089+ examples:
195090+ default:
195091+ value:
195092+ data:
195093+ attributes:
195094+ added: 1
195095+ invalid: 0
195096+ unsupported: 0
195097+ id: acme
195098+ type: threat-intel-stix-ingest
195099+ schema:
195100+ $ref: "#/components/schemas/STIXIngestResponse"
195101+ description: OK
195102+ "400":
195103+ $ref: "#/components/responses/BadRequestResponse"
195104+ "401":
195105+ $ref: "#/components/responses/UnauthorizedResponse"
195106+ "403":
195107+ $ref: "#/components/responses/ForbiddenResponse"
195108+ "413":
195109+ content:
195110+ application/json:
195111+ schema:
195112+ $ref: "#/components/schemas/APIErrorResponse"
195113+ description: Payload Too Large
195114+ "429":
195115+ $ref: "#/components/responses/TooManyRequestsResponse"
195116+ "502":
195117+ content:
195118+ application/json:
195119+ schema:
195120+ $ref: "#/components/schemas/APIErrorResponse"
195121+ description: Bad Gateway
195122+ "503":
195123+ content:
195124+ application/json:
195125+ schema:
195126+ $ref: "#/components/schemas/APIErrorResponse"
195127+ description: Service Unavailable
195128+ security:
195129+ - apiKeyAuth: []
195130+ appKeyAuth: []
195131+ - AuthZ:
195132+ - reference_tables_write
195133+ summary: Ingest STIX threat intelligence
195134+ tags:
195135+ - Threat Intelligence
195136+ x-codegen-request-body-name: body
195137+ x-permission:
195138+ operator: OR
195139+ permissions:
195140+ - reference_tables_write
195141+ x-unstable: |-
195142+ **Note**: This endpoint is in preview and is subject to change.
195143+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
194813195144 /api/v2/security/vulnerabilities:
194814195145 get:
194815195146 deprecated: true
@@ -218666,6 +218997,8 @@ tags:
218666218997 - description: |-
218667218998 Search and manage flaky tests through Test Optimization. See the [Test Optimization page](https://docs.datadoghq.com/tests/) for more information.
218668218999 name: Test Optimization
219000+ - description: Ingest and manage threat intelligence data for security enrichment and investigation.
219001+ name: Threat Intelligence
218669219002 - description: |-
218670219003 The usage metering API allows you to get hourly, daily, and
218671219004 monthly usage across multiple facets of Datadog.
0 commit comments