@@ -86174,6 +86174,229 @@ components:
8617486174 example: "report_id"
8617586175 type: string
8617686176 type: object
86177+ STIXBundleRequest:
86178+ additionalProperties: {}
86179+ description: A STIX 2.1 bundle containing threat intelligence indicator objects.
86180+ properties:
86181+ id:
86182+ description: The STIX bundle identifier.
86183+ example: bundle--11111111-1111-4111-8111-111111111111
86184+ type: string
86185+ objects:
86186+ description: The indicator objects included in the bundle.
86187+ example:
86188+ - created: "2026-07-22T12:00:00Z"
86189+ id: indicator--22222222-2222-4222-8222-222222222222
86190+ modified: "2026-07-22T12:00:00Z"
86191+ pattern: "[ipv4-addr:value = '198.51.100.42']"
86192+ pattern_type: stix
86193+ spec_version: "2.1"
86194+ type: indicator
86195+ valid_from: "2026-07-22T12:00:00Z"
86196+ items:
86197+ $ref: "#/components/schemas/STIXIndicatorObject"
86198+ type: array
86199+ spec_version:
86200+ $ref: "#/components/schemas/STIXSpecVersion"
86201+ type:
86202+ $ref: "#/components/schemas/STIXBundleType"
86203+ required:
86204+ - type
86205+ - id
86206+ - objects
86207+ type: object
86208+ STIXBundleType:
86209+ description: The STIX object type for a bundle.
86210+ enum:
86211+ - bundle
86212+ example: bundle
86213+ type: string
86214+ x-enum-varnames:
86215+ - BUNDLE
86216+ STIXContentEncoding:
86217+ description: The content encoding applied to the request body.
86218+ enum:
86219+ - gzip
86220+ example: gzip
86221+ type: string
86222+ x-enum-varnames:
86223+ - GZIP
86224+ STIXIndicatorObject:
86225+ additionalProperties: {}
86226+ description: A STIX 2.1 indicator object.
86227+ properties:
86228+ confidence:
86229+ description: The confidence in the correctness of the indicator, from 0 through 100.
86230+ example: 80
86231+ format: int32
86232+ maximum: 100
86233+ minimum: 0
86234+ type: integer
86235+ created:
86236+ description: The time when the indicator was created.
86237+ example: "2026-07-22T12:00:00Z"
86238+ format: date-time
86239+ type: string
86240+ external_references:
86241+ description: Optional external reference metadata preserved with the indicator but not interpreted during ingestion.
86242+ items:
86243+ $ref: "#/components/schemas/STIXMetadataObject"
86244+ type: array
86245+ id:
86246+ description: The STIX indicator identifier.
86247+ example: indicator--22222222-2222-4222-8222-222222222222
86248+ type: string
86249+ indicator_types:
86250+ description: The open vocabulary terms that categorize the indicator.
86251+ example:
86252+ - malicious-activity
86253+ items:
86254+ type: string
86255+ type: array
86256+ kill_chain_phases:
86257+ description: Optional kill chain metadata preserved with the indicator but not interpreted during ingestion.
86258+ items:
86259+ $ref: "#/components/schemas/STIXMetadataObject"
86260+ type: array
86261+ labels:
86262+ description: Labels associated with the indicator.
86263+ example:
86264+ - synthetic
86265+ items:
86266+ type: string
86267+ type: array
86268+ modified:
86269+ description: The time when the indicator was last modified.
86270+ example: "2026-07-22T12:00:00Z"
86271+ format: date-time
86272+ type: string
86273+ object_marking_refs:
86274+ description: References to marking definition objects that apply to the indicator.
86275+ example:
86276+ - marking-definition--33333333-3333-4333-8333-333333333333
86277+ items:
86278+ type: string
86279+ type: array
86280+ pattern:
86281+ description: The STIX pattern that identifies the observable.
86282+ example: "[ipv4-addr:value = '198.51.100.42']"
86283+ type: string
86284+ pattern_type:
86285+ $ref: "#/components/schemas/STIXPatternType"
86286+ revoked:
86287+ description: Whether the indicator has been revoked.
86288+ example: false
86289+ type: boolean
86290+ spec_version:
86291+ $ref: "#/components/schemas/STIXSpecVersion"
86292+ type:
86293+ $ref: "#/components/schemas/STIXIndicatorType"
86294+ valid_from:
86295+ description: The time from which the indicator is considered valid.
86296+ example: "2026-07-22T12:00:00Z"
86297+ format: date-time
86298+ type: string
86299+ valid_until:
86300+ description: The time until which the indicator is considered valid.
86301+ example: "2027-07-22T12:00:00Z"
86302+ format: date-time
86303+ type: string
86304+ required:
86305+ - type
86306+ - id
86307+ - spec_version
86308+ - created
86309+ - modified
86310+ - pattern
86311+ - pattern_type
86312+ - valid_from
86313+ type: object
86314+ STIXIndicatorType:
86315+ description: The STIX object type for an indicator.
86316+ enum:
86317+ - indicator
86318+ example: indicator
86319+ type: string
86320+ x-enum-varnames:
86321+ - INDICATOR
86322+ STIXIngestResponse:
86323+ description: The response from a completed STIX ingestion request.
86324+ properties:
86325+ data:
86326+ $ref: "#/components/schemas/STIXIngestResponseData"
86327+ required:
86328+ - data
86329+ type: object
86330+ STIXIngestResponseAttributes:
86331+ description: Counters describing the result of the STIX ingestion request.
86332+ properties:
86333+ added:
86334+ description: The number of supported indicators added.
86335+ example: 1
86336+ format: int64
86337+ minimum: 0
86338+ type: integer
86339+ invalid:
86340+ description: The number of indicators with patterns that could not be parsed.
86341+ example: 0
86342+ format: int64
86343+ minimum: 0
86344+ type: integer
86345+ unsupported:
86346+ description: The number of unsupported objects or patterns.
86347+ example: 0
86348+ format: int64
86349+ minimum: 0
86350+ type: integer
86351+ required:
86352+ - added
86353+ - unsupported
86354+ - invalid
86355+ type: object
86356+ STIXIngestResponseData:
86357+ description: The JSON:API resource describing the completed STIX ingestion request.
86358+ properties:
86359+ attributes:
86360+ $ref: "#/components/schemas/STIXIngestResponseAttributes"
86361+ id:
86362+ description: The normalized vendor identifier.
86363+ example: acme
86364+ type: string
86365+ type:
86366+ $ref: "#/components/schemas/STIXIngestResponseType"
86367+ required:
86368+ - type
86369+ - id
86370+ - attributes
86371+ type: object
86372+ STIXIngestResponseType:
86373+ description: The STIX ingestion resource type.
86374+ enum:
86375+ - threat-intel-stix-ingest
86376+ example: threat-intel-stix-ingest
86377+ type: string
86378+ x-enum-varnames:
86379+ - THREAT_INTEL_STIX_INGEST
86380+ STIXMetadataObject:
86381+ additionalProperties: {}
86382+ description: An opaque STIX metadata object.
86383+ type: object
86384+ STIXPatternType:
86385+ description: The supported STIX pattern language.
86386+ enum:
86387+ - stix
86388+ example: stix
86389+ type: string
86390+ x-enum-varnames:
86391+ - STIX
86392+ STIXSpecVersion:
86393+ description: The supported STIX specification version.
86394+ enum:
86395+ - "2.1"
86396+ example: "2.1"
86397+ type: string
86398+ x-enum-varnames:
86399+ - VERSION_2_1
8617786400 SalesforceIncidentsOrganizationResponseAttributes:
8617886401 description: Attributes of a Salesforce organization connected to the Datadog Salesforce integration.
8617986402 properties:
@@ -181627,6 +181850,114 @@ paths:
181627181850 operator: OR
181628181851 permissions:
181629181852 - security_monitoring_notification_profiles_write
181853+ /api/v2/security/threat-intel/stix:
181854+ post:
181855+ description: |-
181856+ 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.
181857+
181858+ 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.
181859+
181860+ 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.
181861+ operationId: IngestStixThreatIntel
181862+ parameters:
181863+ - description: >-
181864+ 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.
181865+ example: acme
181866+ in: header
181867+ name: ti_vendor
181868+ required: true
181869+ schema:
181870+ maxLength: 10
181871+ minLength: 1
181872+ type: string
181873+ - description: Content encoding for the request body. Use gzip for a compressed STIX bundle.
181874+ in: header
181875+ name: Content-Encoding
181876+ required: false
181877+ schema:
181878+ $ref: "#/components/schemas/STIXContentEncoding"
181879+ requestBody:
181880+ content:
181881+ application/json:
181882+ examples:
181883+ default:
181884+ value:
181885+ id: bundle--11111111-1111-4111-8111-111111111111
181886+ objects:
181887+ - created: "2026-07-22T12:00:00Z"
181888+ id: indicator--22222222-2222-4222-8222-222222222222
181889+ modified: "2026-07-22T12:00:00Z"
181890+ pattern: "[ipv4-addr:value = '198.51.100.42']"
181891+ pattern_type: stix
181892+ spec_version: "2.1"
181893+ type: indicator
181894+ valid_from: "2026-07-22T12:00:00Z"
181895+ spec_version: "2.1"
181896+ type: bundle
181897+ schema:
181898+ $ref: "#/components/schemas/STIXBundleRequest"
181899+ description: >-
181900+ 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.
181901+ required: true
181902+ responses:
181903+ "200":
181904+ content:
181905+ application/json:
181906+ examples:
181907+ default:
181908+ value:
181909+ data:
181910+ attributes:
181911+ added: 1
181912+ invalid: 0
181913+ unsupported: 0
181914+ id: acme
181915+ type: threat-intel-stix-ingest
181916+ schema:
181917+ $ref: "#/components/schemas/STIXIngestResponse"
181918+ description: OK
181919+ "400":
181920+ $ref: "#/components/responses/BadRequestResponse"
181921+ "401":
181922+ $ref: "#/components/responses/UnauthorizedResponse"
181923+ "403":
181924+ $ref: "#/components/responses/ForbiddenResponse"
181925+ "413":
181926+ content:
181927+ application/json:
181928+ schema:
181929+ $ref: "#/components/schemas/APIErrorResponse"
181930+ description: Payload Too Large
181931+ "429":
181932+ $ref: "#/components/responses/TooManyRequestsResponse"
181933+ "502":
181934+ content:
181935+ application/json:
181936+ schema:
181937+ $ref: "#/components/schemas/APIErrorResponse"
181938+ description: Bad Gateway
181939+ "503":
181940+ content:
181941+ application/json:
181942+ schema:
181943+ $ref: "#/components/schemas/APIErrorResponse"
181944+ description: Service Unavailable
181945+ security:
181946+ - apiKeyAuth: []
181947+ appKeyAuth: []
181948+ - AuthZ:
181949+ - reference_tables_write
181950+ summary: Ingest STIX threat intelligence
181951+ tags:
181952+ - Threat Intelligence
181953+ x-codegen-request-body-name: body
181954+ x-permission:
181955+ operator: OR
181956+ permissions:
181957+ - reference_tables_write
181958+ x-unstable: |-
181959+ **Note**: This endpoint is in preview and is subject to change.
181960+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
181630181961 /api/v2/security/vulnerabilities:
181631181962 get:
181632181963 deprecated: true
@@ -204776,6 +205107,8 @@ tags:
204776205107 - description: |-
204777205108 Search and manage flaky tests through Test Optimization. See the [Test Optimization page](https://docs.datadoghq.com/tests/) for more information.
204778205109 name: Test Optimization
205110+ - description: Ingest and manage threat intelligence data for security enrichment and investigation.
205111+ name: Threat Intelligence
204779205112 - description: |-
204780205113 The usage metering API allows you to get hourly, daily, and
204781205114 monthly usage across multiple facets of Datadog.
0 commit comments