POST

/detector/{detectorId}/publishingDestination

http://guardduty.{region}.amazonaws.com/detector/{detectorId}/publishingDestination

Creates a publishing destination to export findings to. The resource to export findings to must exist before you use this operation.

Access Token Required: API Key

Path Parameters

detectorIdstringrequired

The ID of the GuardDuty detector associated with the publishing destination.

Body Params

clientTokenstring

The idempotency token for the request.

destinationTypestringrequired

The type of resource for the publishing destination. Currently only Amazon S3 buckets are supported.

destinationPropertiesobjectrequired

Contains the Amazon Resource Name (ARN) of the resource to publish to, such as an S3 bucket, and the ARN of the KMS key to use to encrypt published findings.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://guardduty.{region}.amazonaws.com/detector/{detectorId}/publishingDestination' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}