import { APIResource } from "../core/resource.js";
import { APIPromise } from "../core/api-promise.js";
import { Cursor, type CursorParams, PagePromise } from "../core/pagination.js";
import { RequestOptions } from "../internal/request-options.js";
export declare class URLs extends APIResource {
    /**
     * Request manual review of a rejected URL. Only URLs in 'rejected' status can be
     * escalated; the status then moves to 'escalated'.
     *
     * @example
     * ```ts
     * const response = await client.urls.escalate('urlId', {
     *   reason:
     *     'This is our official landing page and was rejected in error.',
     * });
     * ```
     */
    escalate(urlID: string, body: URLEscalateParams, options?: RequestOptions): APIPromise<URLEscalateResponse>;
    /**
     * List URLs that have been verified for this project.
     *
     * @example
     * ```ts
     * // Automatically fetches more pages as needed.
     * for await (const verifiedURL of client.urls.listVerified()) {
     *   // ...
     * }
     * ```
     */
    listVerified(query?: URLListVerifiedParams | null | undefined, options?: RequestOptions): PagePromise<VerifiedURLsCursor, VerifiedURL>;
    /**
     * Get details of a specific verified URL.
     *
     * @example
     * ```ts
     * const response = await client.urls.retrieveDetails('urlId');
     * ```
     */
    retrieveDetails(urlID: string, options?: RequestOptions): APIPromise<URLRetrieveDetailsResponse>;
    /**
     * Submit a URL for verification. URLs are automatically checked against Google Web
     * Risk API. Safe URLs are auto-approved, malicious URLs are blocked. URL
     * shorteners (bit.ly, t.co, etc.) are always blocked.
     *
     * **Important:** All SMS and Email messages containing URLs require those URLs to
     * be verified before the message can be sent. This endpoint allows
     * pre-verification of URLs.
     *
     * @example
     * ```ts
     * const response = await client.urls.submitForVerification({
     *   url: 'https://example.com/page',
     * });
     * ```
     */
    submitForVerification(body: URLSubmitForVerificationParams, options?: RequestOptions): APIPromise<URLSubmitForVerificationResponse>;
}
export type VerifiedURLsCursor = Cursor<VerifiedURL>;
export interface VerifiedURL {
    id: string;
    createdAt: string;
    /**
     * Domain extracted from the URL.
     */
    domain: string;
    /**
     * Status of a verified URL.
     */
    status: 'pending' | 'approved' | 'rejected' | 'escalated' | 'malicious';
    /**
     * The verified URL.
     */
    url: string;
    /**
     * How the URL was approved or rejected.
     */
    approvalType?: 'manual' | 'auto_web_risk';
    updatedAt?: string;
}
export interface URLEscalateResponse {
    message: string;
    url: VerifiedURL;
}
export interface URLRetrieveDetailsResponse {
    url: VerifiedURL;
}
export interface URLSubmitForVerificationResponse {
    url: VerifiedURL;
}
export interface URLEscalateParams {
    /**
     * Why the URL should be reviewed manually.
     */
    reason: string;
}
export interface URLListVerifiedParams extends CursorParams {
    /**
     * Filter by verification status.
     */
    status?: 'pending' | 'approved' | 'rejected' | 'escalated' | 'malicious';
}
export interface URLSubmitForVerificationParams {
    /**
     * The URL to submit for verification.
     */
    url: string;
}
export declare namespace URLs {
    export { type VerifiedURL as VerifiedURL, type URLEscalateResponse as URLEscalateResponse, type URLRetrieveDetailsResponse as URLRetrieveDetailsResponse, type URLSubmitForVerificationResponse as URLSubmitForVerificationResponse, type VerifiedURLsCursor as VerifiedURLsCursor, type URLEscalateParams as URLEscalateParams, type URLListVerifiedParams as URLListVerifiedParams, type URLSubmitForVerificationParams as URLSubmitForVerificationParams, };
}
//# sourceMappingURL=urls.d.ts.map