Skip to content

Commit 69d0a07

Browse files
author
ci.datadog-api-spec
committed
Regenerate client from commit a9a074f of spec repo
1 parent a63137b commit 69d0a07

24 files changed

Lines changed: 1269 additions & 0 deletions

.generator/schemas/v2/openapi.yaml

Lines changed: 333 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -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.

docs/datadog_api_client.v2.api.rst

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -942,6 +942,13 @@ datadog\_api\_client.v2.api.test\_optimization\_api module
942942
:members:
943943
:show-inheritance:
944944

945+
datadog\_api\_client.v2.api.threat\_intelligence\_api module
946+
------------------------------------------------------------
947+
948+
.. automodule:: datadog_api_client.v2.api.threat_intelligence_api
949+
:members:
950+
:show-inheritance:
951+
945952
datadog\_api\_client.v2.api.usage\_metering\_api module
946953
-------------------------------------------------------
947954

0 commit comments

Comments
 (0)