@@ -1140,9 +1140,9 @@ components:
11401140 schema:
11411141 type: string
11421142 PersonalAccessTokenID:
1143- description: The UUID of the personal access token.
1143+ description: The ID of the personal access token.
11441144 in: path
1145- name: pat_uuid
1145+ name: pat_id
11461146 required: true
11471147 schema:
11481148 example: "00000000-0000-1234-0000-000000000000"
@@ -29180,11 +29180,6 @@ components:
2918029180 FullPersonalAccessTokenAttributes:
2918129181 description: Attributes of a full personal access token, including the token key.
2918229182 properties:
29183- alias:
29184- description: The alias (short identifier) of the personal access token.
29185- example: "2H9MCNMBM8FQjQ16YucXkX"
29186- readOnly: true
29187- type: string
2918829183 created_at:
2918929184 description: Creation date of the personal access token.
2919029185 example: "2024-01-01T00:00:00+00:00"
@@ -53415,11 +53410,6 @@ components:
5341553410 PersonalAccessTokenAttributes:
5341653411 description: Attributes of a personal access token.
5341753412 properties:
53418- alias:
53419- description: The alias (short identifier) of the personal access token.
53420- example: "2H9MCNMBM8FQjQ16YucXkX"
53421- readOnly: true
53422- type: string
5342353413 created_at:
5342453414 description: Creation date of the personal access token.
5342553415 example: "2024-01-01T00:00:00+00:00"
@@ -62654,19 +62644,23 @@ components:
6265462644 - DONE
6265562645 - TIMEOUT
6265662646 SecurityMonitoringContentPackActivation:
62657- description: The activation status of a content pack
62647+ description: The activation status of a content pack.
6265862648 enum:
6265962649 - never_activated
6266062650 - activated
6266162651 - deactivated
6266262652 example: activated
6266362653 type: string
62654+ x-enum-descriptions:
62655+ - Pack has never been activated for this organization.
62656+ - Pack is currently activated.
62657+ - Pack was previously activated but has since been deactivated.
6266462658 x-enum-varnames:
6266562659 - NEVER_ACTIVATED
6266662660 - ACTIVATED
6266762661 - DEACTIVATED
6266862662 SecurityMonitoringContentPackIntegrationStatus:
62669- description: The installation status of the related integration
62663+ description: The installation status of the related integration.
6267062664 enum:
6267162665 - installed
6267262666 - available
@@ -62675,6 +62669,12 @@ components:
6267562669 - error
6267662670 example: installed
6267762671 type: string
62672+ x-enum-descriptions:
62673+ - Integration is fully installed.
62674+ - Integration exists in the catalog but is not installed.
62675+ - Integration is only partially configured.
62676+ - Integration detected (for example, logs are flowing) but not explicitly installed.
62677+ - Integration is in an error state.
6267862678 x-enum-varnames:
6267962679 - INSTALLED
6268062680 - AVAILABLE
@@ -62691,15 +62691,17 @@ components:
6269162691 cp_activation:
6269262692 $ref: "#/components/schemas/SecurityMonitoringContentPackActivation"
6269362693 filters_configured_for_logs:
62694- description: Whether filters (Security Filters or Index Query depending on the pricing model) are configured for logs
62694+ description: |-
62695+ Whether filters (Security Filters or Index Query depending on the pricing model) are
62696+ present and correctly configured to route logs into Cloud SIEM.
6269562697 example: true
6269662698 type: boolean
6269762699 integration_installed_status:
6269862700 $ref: "#/components/schemas/SecurityMonitoringContentPackIntegrationStatus"
6269962701 logs_last_collected:
6270062702 $ref: "#/components/schemas/SecurityMonitoringContentPackTimestampBucket"
6270162703 logs_seen_from_any_index:
62702- description: Whether logs have been seen from any index
62704+ description: Whether logs for this content pack have been seen in any Datadog index within the last 72 hours.
6270362705 example: true
6270462706 type: boolean
6270562707 state:
@@ -62764,7 +62766,7 @@ components:
6276462766 - meta
6276562767 type: object
6276662768 SecurityMonitoringContentPackStatus:
62767- description: The current status of a content pack
62769+ description: The current operational status of a content pack.
6276862770 enum:
6276962771 - install
6277062772 - activate
@@ -62774,6 +62776,13 @@ components:
6277462776 - broken
6277562777 example: active
6277662778 type: string
62779+ x-enum-descriptions:
62780+ - Not activated; no logs detected in the last 72 hours.
62781+ - Not activated; logs are flowing into a Datadog index but not yet routed through Cloud SIEM.
62782+ - Activated; awaiting first log ingestion.
62783+ - Activated; logs received within the last 24 hours.
62784+ - Activated; integration not installed or logs last seen 24 to 72 hours ago.
62785+ - Activated; no logs for over 72 hours, filter missing, or Cloud SIEM index incorrectly ordered.
6277762786 x-enum-varnames:
6277862787 - INSTALL
6277962788 - ACTIVATE
@@ -62782,7 +62791,7 @@ components:
6278262791 - WARNING
6278362792 - BROKEN
6278462793 SecurityMonitoringContentPackTimestampBucket:
62785- description: Timestamp bucket indicating when logs were last collected
62794+ description: Timestamp bucket indicating when logs were last collected.
6278662795 enum:
6278762796 - not_seen
6278862797 - within_24_hours
@@ -62791,6 +62800,12 @@ components:
6279162800 - over_30d
6279262801 example: within_24_hours
6279362802 type: string
62803+ x-enum-descriptions:
62804+ - No logs observed.
62805+ - Logs received within the last 24 hours.
62806+ - Logs last seen 24 to 72 hours ago.
62807+ - Logs last seen 3 to 30 days ago.
62808+ - Logs last seen more than 30 days ago.
6279462809 x-enum-varnames:
6279562810 - NOT_SEEN
6279662811 - WITHIN_24_HOURS
@@ -63881,7 +63896,7 @@ components:
6388163896 - $ref: "#/components/schemas/SecurityMonitoringSignalRulePayload"
6388263897 - $ref: "#/components/schemas/CloudConfigurationRulePayload"
6388363898 SecurityMonitoringSKU:
63884- description: The SIEM pricing model (SKU) for the organization
63899+ description: The Cloud SIEM pricing model (SKU) for the organization.
6388563900 enum:
6388663901 - per_gb_analyzed
6388763902 - per_event_in_siem_index_2023
@@ -77940,6 +77955,10 @@ components:
7794077955 description: Title of the user.
7794177956 nullable: true
7794277957 type: string
77958+ uuid:
77959+ description: UUID of the user.
77960+ readOnly: true
77961+ type: string
7794377962 verified:
7794477963 description: Whether the user is verified.
7794577964 type: boolean
@@ -109575,7 +109594,7 @@ paths:
109575109594 operator: OR
109576109595 permissions:
109577109596 - user_app_keys
109578- /api/v2/personal_access_tokens/{pat_uuid }:
109597+ /api/v2/personal_access_tokens/{pat_id }:
109579109598 delete:
109580109599 description: Revoke a specific personal access token.
109581109600 operationId: RevokePersonalAccessToken
@@ -118804,9 +118823,8 @@ paths:
118804118823 /api/v2/security_monitoring/content_packs/states:
118805118824 get:
118806118825 description: |-
118807- Get the activation and configuration states for all security monitoring content packs.
118808- This endpoint returns status information about each content pack including activation state,
118809- integration status, and log collection status.
118826+ Get the activation state, integration status, and log collection status
118827+ for all Cloud SIEM content packs.
118810118828 operationId: GetContentPacksStates
118811118829 responses:
118812118830 "200":
@@ -118829,21 +118847,31 @@ paths:
118829118847 description: Not Found
118830118848 "429":
118831118849 $ref: "#/components/responses/TooManyRequestsResponse"
118850+ security:
118851+ - apiKeyAuth: []
118852+ appKeyAuth: []
118853+ - AuthZ:
118854+ - security_monitoring_filters_read
118832118855 summary: Get content pack states
118833118856 tags:
118834118857 - Security Monitoring
118858+ "x-permission":
118859+ operator: OR
118860+ permissions:
118861+ - security_monitoring_filters_read
118862+ - logs_read_index_data
118835118863 x-unstable: |-
118836118864 **Note**: This endpoint is in preview and is subject to change.
118837118865 If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
118838118866 /api/v2/security_monitoring/content_packs/{content_pack_id}/activate:
118839118867 put:
118840118868 description: |-
118841- Activate a security monitoring content pack. This operation configures the necessary
118869+ Activate a Cloud SIEM content pack. This operation configures the necessary
118842118870 log filters or security filters depending on the pricing model and updates the content
118843118871 pack activation state.
118844118872 operationId: ActivateContentPack
118845118873 parameters:
118846- - description: The ID of the content pack to activate.
118874+ - description: The ID of the content pack to activate (for example, `aws-cloudtrail`) .
118847118875 in: path
118848118876 name: content_pack_id
118849118877 required: true
@@ -118867,20 +118895,30 @@ paths:
118867118895 description: Not Found
118868118896 "429":
118869118897 $ref: "#/components/responses/TooManyRequestsResponse"
118898+ security:
118899+ - apiKeyAuth: []
118900+ appKeyAuth: []
118901+ - AuthZ:
118902+ - security_monitoring_filters_write
118870118903 summary: Activate content pack
118871118904 tags:
118872118905 - Security Monitoring
118906+ "x-permission":
118907+ operator: OR
118908+ permissions:
118909+ - security_monitoring_filters_write
118910+ - logs_modify_indexes
118873118911 x-unstable: |-
118874118912 **Note**: This endpoint is in preview and is subject to change.
118875118913 If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
118876118914 /api/v2/security_monitoring/content_packs/{content_pack_id}/deactivate:
118877118915 put:
118878118916 description: |-
118879- Deactivate a security monitoring content pack. This operation removes the content pack's
118917+ Deactivate a Cloud SIEM content pack. This operation removes the content pack's
118880118918 configuration from log filters or security filters and updates the content pack activation state.
118881118919 operationId: DeactivateContentPack
118882118920 parameters:
118883- - description: The ID of the content pack to deactivate.
118921+ - description: The ID of the content pack to deactivate (for example, `aws-cloudtrail`) .
118884118922 in: path
118885118923 name: content_pack_id
118886118924 required: true
@@ -118904,9 +118942,19 @@ paths:
118904118942 description: Not Found
118905118943 "429":
118906118944 $ref: "#/components/responses/TooManyRequestsResponse"
118945+ security:
118946+ - apiKeyAuth: []
118947+ appKeyAuth: []
118948+ - AuthZ:
118949+ - security_monitoring_filters_write
118907118950 summary: Deactivate content pack
118908118951 tags:
118909118952 - Security Monitoring
118953+ "x-permission":
118954+ operator: OR
118955+ permissions:
118956+ - security_monitoring_filters_write
118957+ - logs_modify_indexes
118910118958 x-unstable: |-
118911118959 **Note**: This endpoint is in preview and is subject to change.
118912118960 If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
@@ -121125,7 +121173,7 @@ paths:
121125121173 operator: OR
121126121174 permissions:
121127121175 - service_account_write
121128- /api/v2/service_accounts/{service_account_id}/access_tokens/{pat_uuid }:
121176+ /api/v2/service_accounts/{service_account_id}/access_tokens/{pat_id }:
121129121177 delete:
121130121178 description: Revoke a specific access token for a service account.
121131121179 operationId: RevokeServiceAccountAccessToken
0 commit comments