@@ -79176,319 +79176,12 @@ components:
7917679176 - SECRET
7917779177 TransportWebhookLog:
7917879178 description: A single email transport webhook log event.
79179- properties:
79180- attributes:
79181- $ref: "#/components/schemas/TransportWebhookLogAttributes"
79182- date:
79183- description: The ISO 8601 timestamp of the event.
79184- example: "2024-01-15T10:30:00Z"
79185- format: date-time
79186- type: string
79187- log_id:
79188- description: The unique log event identifier.
79189- example: "AQAAAZPHnBT0TwJAdgAAAABBWlBIblVlNEFBQ0dFMmVkYTFDSnRR"
79190- type: string
79191- source:
79192- description: The email transport provider.
79193- example: "sendgrid"
79194- type: string
79195- status:
79196- description: The log status level.
79197- example: "info"
79198- type: string
79199- tags:
79200- description: A list of tags associated with the event.
79201- example: ["env:production"]
79202- items:
79203- description: A tag in key:value or key-only form (for example, env:production).
79204- type: string
79205- type: array
79206- required:
79207- - date
79208- - log_id
79209- - source
79210- - status
79211- - tags
79212- - attributes
79213- type: object
79214- TransportWebhookLogAttributes:
79215- description: Top-level attributes for the webhook log event, including delivery status, recipient details, and provider metadata.
79216- properties:
79217- category:
79218- description: The event categories.
79219- example: ["transactional"]
79220- items:
79221- description: An event category assigned by the transport provider.
79222- type: string
79223- type: array
79224- email:
79225- $ref: "#/components/schemas/TransportWebhookLogEmail"
79226- email_id:
79227- description: The unique email identifier.
79228- example: "abc123-def456"
79229- type: string
79230- email_type_display_name:
79231- description: The human-readable email type name.
79232- example: "Monitor Alert"
79233- type: string
79234- message:
79235- $ref: "#/components/schemas/TransportWebhookLogMessage"
79236- network:
79237- $ref: "#/components/schemas/TransportWebhookLogNetwork"
79238- org:
79239- description: The numeric organization identifier.
79240- example: 1234
79241- format: int64
79242- type: integer
79243- org_metadata:
79244- $ref: "#/components/schemas/TransportWebhookLogOrgMetadata"
79245- org_uuid:
79246- description: The organization UUID.
79247- example: "8dee7c38-00cb-11ea-a77b-8b5a08d3b091"
79248- type: string
79249- queue_time:
79250- description: The timestamp when the email was queued.
79251- example: "2024-01-15T10:29:00Z"
79252- type: string
79253- sg_machine_open:
79254- description: Indicates whether the open event was triggered by automated machine activity rather than a human recipient (SendGrid-specific).
79255- type: boolean
79256- subject:
79257- description: The email subject line.
79258- example: "[Monitor Alert] CPU usage is high"
79259- type: string
79260- useragent:
79261- description: The user agent string for open events.
79262- example: "Mozilla/5.0"
79263- type: string
7926479179 type: object
7926579180 TransportWebhookLogBatchRequest:
7926679181 description: A batch of email transport webhook log events.
7926779182 items:
7926879183 $ref: "#/components/schemas/TransportWebhookLog"
7926979184 type: array
79270- TransportWebhookLogEmail:
79271- description: The email address details.
79272- properties:
79273- address:
79274- description: The recipient email address.
79275- example: "user@example.com"
79276- type: string
79277- domain:
79278- description: The recipient domain.
79279- example: "example.com"
79280- type: string
79281- subject:
79282- description: The email subject line.
79283- example: "[Monitor Alert] CPU usage is high"
79284- type: string
79285- type:
79286- description: Email categorization tags applied by the transport provider (for example, "transactional", "marketing").
79287- example: ["transactional"]
79288- items:
79289- description: An email type classification (for example, "transactional", "user").
79290- type: string
79291- type: array
79292- type: object
79293- TransportWebhookLogIpAttribute:
79294- description: An IP attribute with its sources.
79295- properties:
79296- ip:
79297- description: The IP address.
79298- example: "192.168.1.1"
79299- type: string
79300- source:
79301- description: The transport providers or systems that reported this IP address.
79302- example: ["sendgrid"]
79303- items:
79304- description: A transport provider or system that reported this IP address.
79305- type: string
79306- type: array
79307- type: object
79308- TransportWebhookLogMessage:
79309- description: The message delivery event details.
79310- properties:
79311- auth:
79312- $ref: "#/components/schemas/TransportWebhookLogMessageAuth"
79313- custom_args:
79314- $ref: "#/components/schemas/TransportWebhookLogMessageCustomArgs"
79315- id:
79316- $ref: "#/components/schemas/TransportWebhookLogMessageId"
79317- name:
79318- description: The delivery event type emitted by the transport provider (for example, "delivered", "dropped", "bounced").
79319- example: "delivered"
79320- type: string
79321- response:
79322- $ref: "#/components/schemas/TransportWebhookLogMessageResponse"
79323- sender_ip:
79324- description: The IP address of the sending server.
79325- example: "192.168.1.1"
79326- type: string
79327- timestamp:
79328- $ref: "#/components/schemas/TransportWebhookLogMessageTimestamp"
79329- type: object
79330- TransportWebhookLogMessageAuth:
79331- description: The message authentication details.
79332- properties:
79333- delivered_with_tls:
79334- description: The TLS version or negotiation information.
79335- example: "TLSv1.2"
79336- type: string
79337- type: object
79338- TransportWebhookLogMessageCustomArgs:
79339- description: Custom arguments passed through the email transport provider for tracking.
79340- properties:
79341- email_id:
79342- description: The unique email identifier.
79343- example: "abc123-def456"
79344- type: string
79345- email_type_display_name:
79346- description: The human-readable email type name.
79347- example: "Monitor Alert"
79348- type: string
79349- org_uuid:
79350- description: The organization UUID.
79351- example: "8dee7c38-00cb-11ea-a77b-8b5a08d3b091"
79352- type: string
79353- queue_time:
79354- description: The timestamp when the email was queued.
79355- example: "2024-01-15T10:29:00Z"
79356- type: string
79357- subject:
79358- description: The email subject line.
79359- example: "[Monitor Alert] CPU usage is high"
79360- type: string
79361- type: object
79362- TransportWebhookLogMessageId:
79363- description: The message identifiers.
79364- properties:
79365- message_id:
79366- description: The RFC 5322 Message-ID.
79367- example: "<message-id@example.com>"
79368- type: string
79369- smtp_id:
79370- description: The SMTP transaction identifier.
79371- example: "<abc123@mail.example.com>"
79372- type: string
79373- transport_event_id:
79374- description: The transport provider event identifier.
79375- example: "evt_abc123"
79376- type: string
79377- type: object
79378- TransportWebhookLogMessageResponse:
79379- description: The SMTP response information.
79380- properties:
79381- enhanced_smtp_code:
79382- description: The enhanced SMTP status code.
79383- example: "2.0.0"
79384- type: string
79385- reason:
79386- description: The SMTP response message.
79387- example: "250 2.0.0 OK"
79388- type: string
79389- smtp_code:
79390- description: The SMTP status code.
79391- example: "250"
79392- type: string
79393- type: object
79394- TransportWebhookLogMessageTimestamp:
79395- description: The message delivery timing information.
79396- properties:
79397- event_timestamp:
79398- description: The Unix timestamp of the event.
79399- example: 1705312200.0
79400- format: double
79401- type: number
79402- lifetime:
79403- description: The total delivery time in seconds.
79404- example: 3.2
79405- format: double
79406- type: number
79407- queue_time:
79408- description: Number of seconds the message spent in the delivery queue.
79409- example: 1.5
79410- format: double
79411- type: number
79412- scheduled_time:
79413- description: The scheduled delivery time as a Unix timestamp.
79414- example: 1705312190.0
79415- format: double
79416- type: number
79417- type: object
79418- TransportWebhookLogNetwork:
79419- description: The network information for the event.
79420- properties:
79421- ip:
79422- $ref: "#/components/schemas/TransportWebhookLogNetworkIp"
79423- type: object
79424- TransportWebhookLogNetworkIp:
79425- description: The IP address information.
79426- properties:
79427- attributes:
79428- description: Per-IP attribute records, each pairing an IP address with the providers that observed it.
79429- items:
79430- $ref: "#/components/schemas/TransportWebhookLogIpAttribute"
79431- type: array
79432- list:
79433- description: The list of IP addresses.
79434- example: ["192.168.1.1"]
79435- items:
79436- description: An IP address observed during message delivery.
79437- type: string
79438- type: array
79439- type: object
79440- TransportWebhookLogOrgMetadata:
79441- description: Metadata about the organization that sent the email.
79442- properties:
79443- billing_country:
79444- description: Country code or name used for billing purposes.
79445- type: string
79446- billing_plan:
79447- description: The Datadog billing plan for the organization (for example, "pro", "enterprise").
79448- type: string
79449- customer_tier:
79450- description: Support or account tier assigned to the organization (for example, "tier-1").
79451- type: string
79452- domain:
79453- description: Primary email domain associated with the organization (for example, "example.com").
79454- type: string
79455- industry:
79456- description: Industry classification of the organization (for example, "technology", "finance").
79457- type: string
79458- is_bugbounty:
79459- description: Whether the organization is enrolled in the Datadog bug bounty program.
79460- type: string
79461- is_msp:
79462- description: Whether the organization operates as a Managed Service Provider managing child orgs.
79463- type: string
79464- name:
79465- description: Display name of the organization as configured in Datadog account settings.
79466- type: string
79467- org_uuid:
79468- description: Globally unique identifier for the Datadog organization (UUID v1 format).
79469- type: string
79470- parent_org_id:
79471- description: Identifier of the immediate parent organization, if this is a child org.
79472- type: string
79473- premium_support:
79474- description: Whether the organization has a premium support plan with Datadog.
79475- type: string
79476- root_org_id:
79477- description: Identifier of the top-level parent organization in a multi-org account hierarchy.
79478- type: string
79479- root_org_name:
79480- description: Display name of the top-level parent organization in a multi-org account hierarchy.
79481- type: string
79482- shipping_country:
79483- description: Country code or name used for shipping or regional assignment.
79484- type: string
79485- website:
79486- description: Website URL provided during organization registration.
79487- type: string
79488- when_created:
79489- description: ISO 8601 timestamp of when the Datadog organization was created.
79490- type: string
79491- type: object
7949279185 Trigger:
7949379186 description: "One of the triggers that can start the execution of a workflow."
7949479187 oneOf:
@@ -99838,42 +99531,17 @@ paths:
9983899531 - monitors_downtime
9983999532 /api/v2/email/transport/webhook_intake:
9984099533 post:
99841- description: |-
99842- Receives a batch of email transport webhook log events and emits an audit trail entry
99843- for each event with a final delivery status (delivered, dropped, or bounced).
99844- Only authorized organizations can submit events.
99534+ deprecated: true
9984599535 operationId: CreateEmailTransportWebhookIntake
9984699536 requestBody:
9984799537 content:
9984899538 application/json:
9984999539 examples:
9985099540 default:
9985199541 value:
99852- - attributes:
99853- email:
99854- address: "user@example.com"
99855- domain: "example.com"
99856- email_id: "abc123-def456"
99857- email_type_display_name: "Monitor Alert"
99858- message:
99859- id:
99860- message_id: "<message-id@example.com>"
99861- smtp_id: "<abc123@mail.example.com>"
99862- name: "delivered"
99863- response:
99864- reason: "250 2.0.0 OK"
99865- smtp_code: "250"
99866- timestamp:
99867- event_timestamp: 1705312200.0
99868- org: 1234
99869- org_uuid: "8dee7c38-00cb-11ea-a77b-8b5a08d3b091"
99870- subject: "[Monitor Alert] CPU usage is high"
99871- date: "2024-01-15T10:30:00Z"
99872- log_id: "AQAAAZPHnBT0TwJAdgAAAABBWlBIblVlNEFBQ0dFMmVkYTFDSnRR"
99542+ - date: "2024-01-15T10:30:00Z"
9987399543 source: "sendgrid"
9987499544 status: "info"
99875- tags:
99876- - "env:production"
9987799545 schema:
9987899546 $ref: "#/components/schemas/TransportWebhookLogBatchRequest"
9987999547 required: true
@@ -99897,9 +99565,7 @@ paths:
9989799565 summary: Ingest email transport webhook events
9989899566 tags:
9989999567 - Email Transport
99900- x-unstable: |-
99901- **Note**: This endpoint is in preview and is subject to change.
99902- If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
99568+ x-sunset: "2027-01-01"
9990399569 /api/v2/error-tracking/issues/search:
9990499570 post:
9990599571 description: Search issues endpoint allows you to programmatically search for issues within your organization. This endpoint returns a list of issues that match a given search query, following the event search syntax. The search results are limited to a maximum of 100 issues per request.
0 commit comments