Bulk subscribe to sample log generation

Note: This endpoint is in preview and is subject to change. If you have any feedback, contact Datadog support.

POST https://api.ap1.datadoghq.com/api/v2/security_monitoring/sample_log_generation/subscriptions/bulkhttps://api.ap2.datadoghq.com/api/v2/security_monitoring/sample_log_generation/subscriptions/bulkhttps://api.datadoghq.eu/api/v2/security_monitoring/sample_log_generation/subscriptions/bulkhttps://api.ddog-gov.com/api/v2/security_monitoring/sample_log_generation/subscriptions/bulkhttps://api.us2.ddog-gov.com/api/v2/security_monitoring/sample_log_generation/subscriptions/bulkhttps://api.datadoghq.com/api/v2/security_monitoring/sample_log_generation/subscriptions/bulkhttps://api.us3.datadoghq.com/api/v2/security_monitoring/sample_log_generation/subscriptions/bulkhttps://api.us5.datadoghq.com/api/v2/security_monitoring/sample_log_generation/subscriptions/bulk

Overview

Subscribe to sample log generation for multiple Cloud SIEM content packs in a single call. Each requested content pack is processed independently; the response includes a per-item status so partial successes can be inspected.

Availability: this endpoint is restricted to Cloud SIEM trial organizations on an eligible pricing model. Non-trial orgs receive 403 Forbidden, the feature flag may also reject requests with 400 Bad Request, and legacy pricing tiers receive per-item responses with status: not_available.

This endpoint requires any of the following permissions:
  • security_monitoring_filters_write
  • logs_modify_indexes

  • OAuth apps require the security_monitoring_filters_write, logs_modify_indexes authorization scope to access this endpoint.

    Request

    Body Data (required)

    The content packs to subscribe to and the desired duration of the subscriptions.

    Expand All

    Field

    Type

    Description

    data [required]

    object

    The bulk subscription request body.

    attributes [required]

    object

    The attributes for creating sample log generation subscriptions for multiple content packs.

    content_pack_ids [required]

    [string]

    The identifiers of the Cloud SIEM content packs to subscribe to. At most five content packs can be requested in a single call.

    duration

    enum

    How long the subscription should remain active before expiring. Allowed enum values: 1h,1d,3d,7d

    default: 3d

    type [required]

    enum

    The type of the resource. The value should always be bulk_subscription_requests. Allowed enum values: bulk_subscription_requests

    default: bulk_subscription_requests

    {
      "data": {
        "attributes": {
          "content_pack_ids": [
            "aws-cloudtrail"
          ],
          "duration": "3d"
        },
        "type": "bulk_subscription_requests"
      }
    }

    Response

    OK

    Response containing the per-content-pack results of a bulk subscription request.

    Expand All

    Field

    Type

    Description

    data [required]

    [object]

    The list of bulk subscription results, one per requested content pack.

    attributes [required]

    object

    The attributes describing a sample log generation subscription.

    content_pack_id [required]

    string

    The identifier of the Cloud SIEM content pack the subscription targets.

    created_at [required]

    date-time

    The time at which the subscription was created.

    expires_at [required]

    date-time

    The time at which the subscription expires and stops generating logs.

    is_active [required]

    boolean

    Whether the subscription is currently active and generating logs.

    status [required]

    enum

    The status of the subscription. Allowed enum values: subscribed,renewed,unsubscribed,no_active_subscription,not_available,active,expired

    id [required]

    string

    The unique identifier of the subscription, when one was created.

    meta [required]

    object

    Per-item status returned for a bulk subscription request.

    error

    string

    A description of the error encountered for this content pack, if the subscription could not be created.

    status [required]

    int32

    The HTTP status code that resulted from creating the subscription for this content pack.

    type [required]

    enum

    The type of the resource. The value should always be subscriptions. Allowed enum values: subscriptions

    default: subscriptions

    {
      "data": [
        {
          "attributes": {
            "content_pack_id": "aws-cloudtrail",
            "created_at": "2026-05-08T20:02:13.77481Z",
            "expires_at": "2026-05-11T20:02:13.77481Z",
            "is_active": true,
            "status": "subscribed"
          },
          "id": "123",
          "meta": {
            "error": "content pack does not exist",
            "status": 200
          },
          "type": "subscriptions"
        }
      ]
    }

    Bad Request

    API error response.

    Expand All

    Field

    Type

    Description

    errors [required]

    [string]

    A list of errors.

    {
      "errors": [
        "Bad Request"
      ]
    }

    Not Authorized

    API error response.

    Expand All

    Field

    Type

    Description

    errors [required]

    [string]

    A list of errors.

    {
      "errors": [
        "Bad Request"
      ]
    }

    Too many requests

    API error response.

    Expand All

    Field

    Type

    Description

    errors [required]

    [string]

    A list of errors.

    {
      "errors": [
        "Bad Request"
      ]
    }

    Code Example

                      ## default
    # 
    
    # Curl command
    curl -X POST "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/security_monitoring/sample_log_generation/subscriptions/bulk" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "DD-API-KEY: ${DD_API_KEY}" \ -H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \ -d @- << EOF { "data": { "attributes": { "content_pack_ids": [ "aws-cloudtrail" ], "duration": "3d" }, "type": "bulk_subscription_requests" } } EOF