openai/resources/admin/organization/projects/spend-alerts.d.ts

The official TypeScript library for the OpenAI API

import { APIResource } from "../../../../core/resource.js";
import { APIPromise } from "../../../../core/api-promise.js";
import { ConversationCursorPage, type ConversationCursorPageParams, PagePromise } from "../../../../core/pagination.js";
import { RequestOptions } from "../../../../internal/request-options.js";
export declare class SpendAlerts extends APIResource {
    /**
     * Creates a project spend alert.
     *
     * @example
     * ```ts
     * const projectSpendAlert =
     *   await client.admin.organization.projects.spendAlerts.create(
     *     'project_id',
     *     {
     *       currency: 'USD',
     *       interval: 'month',
     *       notification_channel: {
     *         recipients: ['string'],
     *         type: 'email',
     *       },
     *       threshold_amount: 0,
     *     },
     *   );
     * ```
     */
    create(projectID: string, body: SpendAlertCreateParams, options?: RequestOptions): APIPromise<ProjectSpendAlert>;
    /**
     * Retrieves a project spend alert.
     *
     * @example
     * ```ts
     * const projectSpendAlert =
     *   await client.admin.organization.projects.spendAlerts.retrieve(
     *     'alert_id',
     *     { project_id: 'project_id' },
     *   );
     * ```
     */
    retrieve(alertID: string, params: SpendAlertRetrieveParams, options?: RequestOptions): APIPromise<ProjectSpendAlert>;
    /**
     * Updates a project spend alert.
     *
     * @example
     * ```ts
     * const projectSpendAlert =
     *   await client.admin.organization.projects.spendAlerts.update(
     *     'alert_id',
     *     {
     *       project_id: 'project_id',
     *       currency: 'USD',
     *       interval: 'month',
     *       notification_channel: {
     *         recipients: ['string'],
     *         type: 'email',
     *       },
     *       threshold_amount: 0,
     *     },
     *   );
     * ```
     */
    update(alertID: string, params: SpendAlertUpdateParams, options?: RequestOptions): APIPromise<ProjectSpendAlert>;
    /**
     * Lists project spend alerts.
     *
     * @example
     * ```ts
     * // Automatically fetches more pages as needed.
     * for await (const projectSpendAlert of client.admin.organization.projects.spendAlerts.list(
     *   'project_id',
     * )) {
     *   // ...
     * }
     * ```
     */
    list(projectID: string, query?: SpendAlertListParams | null | undefined, options?: RequestOptions): PagePromise<ProjectSpendAlertsPage, ProjectSpendAlert>;
    /**
     * Deletes a project spend alert.
     *
     * @example
     * ```ts
     * const projectSpendAlertDeleted =
     *   await client.admin.organization.projects.spendAlerts.delete(
     *     'alert_id',
     *     { project_id: 'project_id' },
     *   );
     * ```
     */
    delete(alertID: string, params: SpendAlertDeleteParams, options?: RequestOptions): APIPromise<ProjectSpendAlertDeleted>;
}
export type ProjectSpendAlertsPage = ConversationCursorPage<ProjectSpendAlert>;
/**
 * Represents a spend alert configured at the project level.
 */
export interface ProjectSpendAlert {
    /**
     * The identifier, which can be referenced in API endpoints.
     */
    id: string;
    /**
     * The currency for the threshold amount.
     */
    currency: 'USD';
    /**
     * The time interval for evaluating spend against the threshold.
     */
    interval: 'month';
    /**
     * Email notification settings for a spend alert.
     */
    notification_channel: ProjectSpendAlert.NotificationChannel;
    /**
     * The object type, which is always `project.spend_alert`.
     */
    object: 'project.spend_alert';
    /**
     * The alert threshold amount, in cents.
     */
    threshold_amount: number;
}
export declare namespace ProjectSpendAlert {
    /**
     * Email notification settings for a spend alert.
     */
    interface NotificationChannel {
        /**
         * Email addresses that receive the spend alert notification.
         */
        recipients: Array<string>;
        /**
         * The notification channel type. Currently only `email` is supported.
         */
        type: 'email';
        /**
         * Optional subject prefix for alert emails.
         */
        subject_prefix?: string | null;
    }
}
/**
 * Confirmation payload returned after deleting a project spend alert.
 */
export interface ProjectSpendAlertDeleted {
    /**
     * The deleted spend alert ID.
     */
    id: string;
    /**
     * Whether the spend alert was deleted.
     */
    deleted: boolean;
    /**
     * Always `project.spend_alert.deleted`.
     */
    object: 'project.spend_alert.deleted';
}
export interface SpendAlertCreateParams {
    /**
     * The currency for the threshold amount.
     */
    currency: 'USD';
    /**
     * The time interval for evaluating spend against the threshold.
     */
    interval: 'month';
    /**
     * Email notification settings for a spend alert.
     */
    notification_channel: SpendAlertCreateParams.NotificationChannel;
    /**
     * The alert threshold amount, in cents.
     */
    threshold_amount: number;
}
export declare namespace SpendAlertCreateParams {
    /**
     * Email notification settings for a spend alert.
     */
    interface NotificationChannel {
        /**
         * Email addresses that receive the spend alert notification.
         */
        recipients: Array<string>;
        /**
         * The notification channel type. Currently only `email` is supported.
         */
        type: 'email';
        /**
         * Optional subject prefix for alert emails.
         */
        subject_prefix?: string | null;
    }
}
export interface SpendAlertRetrieveParams {
    /**
     * The ID of the project.
     */
    project_id: string;
}
export interface SpendAlertUpdateParams {
    /**
     * Path param: The ID of the project to update.
     */
    project_id: string;
    /**
     * Body param: The currency for the threshold amount.
     */
    currency: 'USD';
    /**
     * Body param: The time interval for evaluating spend against the threshold.
     */
    interval: 'month';
    /**
     * Body param: Email notification settings for a spend alert.
     */
    notification_channel: SpendAlertUpdateParams.NotificationChannel;
    /**
     * Body param: The alert threshold amount, in cents.
     */
    threshold_amount: number;
}
export declare namespace SpendAlertUpdateParams {
    /**
     * Email notification settings for a spend alert.
     */
    interface NotificationChannel {
        /**
         * Email addresses that receive the spend alert notification.
         */
        recipients: Array<string>;
        /**
         * The notification channel type. Currently only `email` is supported.
         */
        type: 'email';
        /**
         * Optional subject prefix for alert emails.
         */
        subject_prefix?: string | null;
    }
}
export interface SpendAlertListParams extends ConversationCursorPageParams {
    /**
     * Cursor for pagination. Provide the ID of the first spend alert from the previous
     * response to fetch the previous page.
     */
    before?: string;
    /**
     * Sort order for the returned spend alerts.
     */
    order?: 'asc' | 'desc';
}
export interface SpendAlertDeleteParams {
    /**
     * The ID of the project to update.
     */
    project_id: string;
}
export declare namespace SpendAlerts {
    export { type ProjectSpendAlert as ProjectSpendAlert, type ProjectSpendAlertDeleted as ProjectSpendAlertDeleted, type ProjectSpendAlertsPage as ProjectSpendAlertsPage, type SpendAlertCreateParams as SpendAlertCreateParams, type SpendAlertRetrieveParams as SpendAlertRetrieveParams, type SpendAlertUpdateParams as SpendAlertUpdateParams, type SpendAlertListParams as SpendAlertListParams, type SpendAlertDeleteParams as SpendAlertDeleteParams, };
}
//# sourceMappingURL=spend-alerts.d.ts.map