import { APIResource } from "../../core/resource.mjs"; import { APIPromise } from "../../core/api-promise.mjs"; import { RequestOptions } from "../../internal/request-options.mjs"; export declare class BaseDMARCReports extends APIResource { static readonly _key: readonly ['emailAuth', 'dmarcReports']; /** * Updates the DMARC report configuration for a zone. At least one of `enabled` or * `skip_wizard` must be provided. When enabling, the handler will ensure the DMARC * RUA record exists in DNS. * * @example * ```ts * const response = await client.emailAuth.dmarcReports.edit({ * zone_id: '023e105f4ecef8ad9ca31a8372d0c353', * }); * ``` */ edit(params: DMARCReportEditParams, options?: RequestOptions): APIPromise; /** * Retrieves the current DMARC report configuration and status for a zone. Returns * the RUA prefix, enabled status, approved sources, and DNS records. * * @example * ```ts * const dmarcReport = await client.emailAuth.dmarcReports.get( * { zone_id: '023e105f4ecef8ad9ca31a8372d0c353' }, * ); * ``` */ get(params: DMARCReportGetParams, options?: RequestOptions): APIPromise; } export declare class DMARCReports extends BaseDMARCReports { } /** * Response for GET/PATCH /dmarc-reports */ export interface DMARCReportEditResponse { /** * List of approved sending sources (omitted when empty) */ approved_sources?: Array; /** * @deprecated Deprecated, use created_at */ created?: string; /** * Creation timestamp */ created_at?: string; /** * Whether DMARC reports are enabled */ enabled?: boolean; /** * @deprecated Deprecated, use modified_at */ modified?: string; /** * Last modification timestamp */ modified_at?: string; /** * Live DNS records for the zone, grouped by type */ records?: DMARCReportEditResponse.Records; /** * Prefix for DMARC RUA addresses (32-char hex string) */ rua_prefix?: string; /** * Whether to skip the setup wizard */ skip_wizard?: boolean; /** * DMARC configuration status */ status?: 'missing-dmarc-report' | 'multiple-dmarc-reports' | 'missing-dmarc-rua' | 'cname-on-dmarc-record'; /** * @deprecated Use `zone_id` instead */ tag?: string; /** * Zone identifier */ zone_id?: string; } export declare namespace DMARCReportEditResponse { /** * A single approved sending source */ interface ApprovedSource { /** * @deprecated Deprecated, use created_at */ created?: string; /** * Creation timestamp */ created_at?: string; /** * The source domain */ domain?: string; /** * Resolved IP addresses from SPF */ ips?: Array; /** * @deprecated Deprecated, use modified_at */ modified?: string; /** * Last modification timestamp */ modified_at?: string; /** * Source name (typically same as domain) */ name?: string; /** * URL-friendly identifier */ slug?: string; /** * Source UUID */ tag?: string; } /** * Live DNS records for the zone, grouped by type */ interface Records { /** * BIMI TXT records */ bimi_records?: Array; /** * CNAME records for DKIM */ cname_dkim_records?: Array; /** * CNAME records at \_dmarc (problematic) */ cname_dmarc_records?: Array; /** * CNAME records for SPF */ cname_spf_records?: Array; /** * DKIM TXT records */ dkim_records?: Array; /** * DMARC TXT records */ dmarc_records?: Array; /** * SPF TXT records */ spf_records?: Array; } namespace Records { /** * Summary of a single DNS record */ interface BimiRecord { /** * DNS record ID */ id?: string; /** * Record content */ content?: string; /** * DNS record name */ name?: string; /** * Time to live in seconds */ ttl?: number; /** * Record type */ type?: string; } /** * Summary of a single DNS record */ interface CnamedkimRecord { /** * DNS record ID */ id?: string; /** * Record content */ content?: string; /** * DNS record name */ name?: string; /** * Time to live in seconds */ ttl?: number; /** * Record type */ type?: string; } /** * Summary of a single DNS record */ interface CnamedmarcRecord { /** * DNS record ID */ id?: string; /** * Record content */ content?: string; /** * DNS record name */ name?: string; /** * Time to live in seconds */ ttl?: number; /** * Record type */ type?: string; } /** * Summary of a single DNS record */ interface CnamespfRecord { /** * DNS record ID */ id?: string; /** * Record content */ content?: string; /** * DNS record name */ name?: string; /** * Time to live in seconds */ ttl?: number; /** * Record type */ type?: string; } /** * Summary of a single DNS record */ interface DKIMRecord { /** * DNS record ID */ id?: string; /** * Record content */ content?: string; /** * DNS record name */ name?: string; /** * Time to live in seconds */ ttl?: number; /** * Record type */ type?: string; } /** * Summary of a single DNS record */ interface DMARCRecord { /** * DNS record ID */ id?: string; /** * Record content */ content?: string; /** * DNS record name */ name?: string; /** * Time to live in seconds */ ttl?: number; /** * Record type */ type?: string; } /** * Summary of a single DNS record */ interface SPFRecord { /** * DNS record ID */ id?: string; /** * Record content */ content?: string; /** * DNS record name */ name?: string; /** * Time to live in seconds */ ttl?: number; /** * Record type */ type?: string; } } } /** * Response for GET/PATCH /dmarc-reports */ export interface DMARCReportGetResponse { /** * List of approved sending sources (omitted when empty) */ approved_sources?: Array; /** * @deprecated Deprecated, use created_at */ created?: string; /** * Creation timestamp */ created_at?: string; /** * Whether DMARC reports are enabled */ enabled?: boolean; /** * @deprecated Deprecated, use modified_at */ modified?: string; /** * Last modification timestamp */ modified_at?: string; /** * Live DNS records for the zone, grouped by type */ records?: DMARCReportGetResponse.Records; /** * Prefix for DMARC RUA addresses (32-char hex string) */ rua_prefix?: string; /** * Whether to skip the setup wizard */ skip_wizard?: boolean; /** * DMARC configuration status */ status?: 'missing-dmarc-report' | 'multiple-dmarc-reports' | 'missing-dmarc-rua' | 'cname-on-dmarc-record'; /** * @deprecated Use `zone_id` instead */ tag?: string; /** * Zone identifier */ zone_id?: string; } export declare namespace DMARCReportGetResponse { /** * A single approved sending source */ interface ApprovedSource { /** * @deprecated Deprecated, use created_at */ created?: string; /** * Creation timestamp */ created_at?: string; /** * The source domain */ domain?: string; /** * Resolved IP addresses from SPF */ ips?: Array; /** * @deprecated Deprecated, use modified_at */ modified?: string; /** * Last modification timestamp */ modified_at?: string; /** * Source name (typically same as domain) */ name?: string; /** * URL-friendly identifier */ slug?: string; /** * Source UUID */ tag?: string; } /** * Live DNS records for the zone, grouped by type */ interface Records { /** * BIMI TXT records */ bimi_records?: Array; /** * CNAME records for DKIM */ cname_dkim_records?: Array; /** * CNAME records at \_dmarc (problematic) */ cname_dmarc_records?: Array; /** * CNAME records for SPF */ cname_spf_records?: Array; /** * DKIM TXT records */ dkim_records?: Array; /** * DMARC TXT records */ dmarc_records?: Array; /** * SPF TXT records */ spf_records?: Array; } namespace Records { /** * Summary of a single DNS record */ interface BimiRecord { /** * DNS record ID */ id?: string; /** * Record content */ content?: string; /** * DNS record name */ name?: string; /** * Time to live in seconds */ ttl?: number; /** * Record type */ type?: string; } /** * Summary of a single DNS record */ interface CnamedkimRecord { /** * DNS record ID */ id?: string; /** * Record content */ content?: string; /** * DNS record name */ name?: string; /** * Time to live in seconds */ ttl?: number; /** * Record type */ type?: string; } /** * Summary of a single DNS record */ interface CnamedmarcRecord { /** * DNS record ID */ id?: string; /** * Record content */ content?: string; /** * DNS record name */ name?: string; /** * Time to live in seconds */ ttl?: number; /** * Record type */ type?: string; } /** * Summary of a single DNS record */ interface CnamespfRecord { /** * DNS record ID */ id?: string; /** * Record content */ content?: string; /** * DNS record name */ name?: string; /** * Time to live in seconds */ ttl?: number; /** * Record type */ type?: string; } /** * Summary of a single DNS record */ interface DKIMRecord { /** * DNS record ID */ id?: string; /** * Record content */ content?: string; /** * DNS record name */ name?: string; /** * Time to live in seconds */ ttl?: number; /** * Record type */ type?: string; } /** * Summary of a single DNS record */ interface DMARCRecord { /** * DNS record ID */ id?: string; /** * Record content */ content?: string; /** * DNS record name */ name?: string; /** * Time to live in seconds */ ttl?: number; /** * Record type */ type?: string; } /** * Summary of a single DNS record */ interface SPFRecord { /** * DNS record ID */ id?: string; /** * Record content */ content?: string; /** * DNS record name */ name?: string; /** * Time to live in seconds */ ttl?: number; /** * Record type */ type?: string; } } } export interface DMARCReportEditParams { /** * Path param: Identifier. */ zone_id: string; /** * Body param: Enable or disable DMARC reports for this zone */ enabled?: boolean | null; /** * Body param: Skip the DMARC setup wizard */ skip_wizard?: boolean | null; } export interface DMARCReportGetParams { /** * Identifier. */ zone_id: string; } export declare namespace DMARCReports { export { type DMARCReportEditResponse as DMARCReportEditResponse, type DMARCReportGetResponse as DMARCReportGetResponse, type DMARCReportEditParams as DMARCReportEditParams, type DMARCReportGetParams as DMARCReportGetParams, }; } //# sourceMappingURL=dmarc-reports.d.mts.map