pingram 1.0.31 → 1.0.32-alpha.1510
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/generated/src/apis/BroadcastsApi.d.ts +374 -0
- package/dist/generated/src/apis/BroadcastsApi.js +846 -0
- package/dist/generated/src/apis/LibraryApi.d.ts +80 -0
- package/dist/generated/src/apis/LibraryApi.js +176 -0
- package/dist/generated/src/apis/index.d.ts +5 -1
- package/dist/generated/src/apis/index.js +5 -1
- package/dist/generated/src/models/BroadcastMetricsResponse.d.ts +129 -0
- package/dist/generated/src/models/BroadcastMetricsResponse.js +122 -0
- package/dist/generated/src/models/BroadcastResponse.d.ts +161 -0
- package/dist/generated/src/models/BroadcastResponse.js +141 -0
- package/dist/generated/src/models/BroadcastResponseAudience.d.ts +40 -0
- package/dist/generated/src/models/BroadcastResponseAudience.js +50 -0
- package/dist/generated/src/models/CreateBroadcastRequest.d.ts +94 -0
- package/dist/generated/src/models/CreateBroadcastRequest.js +88 -0
- package/dist/generated/src/models/CreateLibraryRequest.d.ts +38 -0
- package/dist/generated/src/models/CreateLibraryRequest.js +54 -0
- package/dist/generated/src/models/CreateLibraryResponse.d.ts +76 -0
- package/dist/generated/src/models/CreateLibraryResponse.js +84 -0
- package/dist/generated/src/models/GetUsersResponseUsersInner.d.ts +9 -0
- package/dist/generated/src/models/GetUsersResponseUsersInner.js +8 -0
- package/dist/generated/src/models/GetUsersResponseUsersInnerPropertiesValue.d.ts +26 -0
- package/dist/generated/src/models/GetUsersResponseUsersInnerPropertiesValue.js +38 -0
- package/dist/generated/src/models/ListBroadcastRecipientsResponse.d.ts +39 -0
- package/dist/generated/src/models/ListBroadcastRecipientsResponse.js +53 -0
- package/dist/generated/src/models/ListBroadcastRecipientsResponseRecipientsInner.d.ts +116 -0
- package/dist/generated/src/models/ListBroadcastRecipientsResponseRecipientsInner.js +82 -0
- package/dist/generated/src/models/ListBroadcastsResponse.d.ts +39 -0
- package/dist/generated/src/models/ListBroadcastsResponse.js +53 -0
- package/dist/generated/src/models/ListBroadcastsResponseBroadcastsInner.d.ts +149 -0
- package/dist/generated/src/models/ListBroadcastsResponseBroadcastsInner.js +135 -0
- package/dist/generated/src/models/ListLibraryResponse.d.ts +39 -0
- package/dist/generated/src/models/ListLibraryResponse.js +53 -0
- package/dist/generated/src/models/ListLibraryResponseItemsInner.d.ts +76 -0
- package/dist/generated/src/models/ListLibraryResponseItemsInner.js +84 -0
- package/dist/generated/src/models/LogsGetResponseLogsInner.d.ts +2 -0
- package/dist/generated/src/models/LogsGetResponseLogsInner.js +2 -0
- package/dist/generated/src/models/MFAStatusResponse.d.ts +1 -1
- package/dist/generated/src/models/PostUserRequest.d.ts +9 -0
- package/dist/generated/src/models/PostUserRequest.js +10 -2
- package/dist/generated/src/models/ScheduleBroadcastRequest.d.ts +32 -0
- package/dist/generated/src/models/ScheduleBroadcastRequest.js +50 -0
- package/dist/generated/src/models/SenderPostBodyTo.d.ts +9 -0
- package/dist/generated/src/models/SenderPostBodyTo.js +8 -0
- package/dist/generated/src/models/SenderPostBodyUser.d.ts +9 -0
- package/dist/generated/src/models/SenderPostBodyUser.js +8 -0
- package/dist/generated/src/models/UpdateBroadcastRequest.d.ts +94 -0
- package/dist/generated/src/models/UpdateBroadcastRequest.js +78 -0
- package/dist/generated/src/models/User.d.ts +9 -0
- package/dist/generated/src/models/User.js +8 -0
- package/dist/generated/src/models/index.d.ts +15 -0
- package/dist/generated/src/models/index.js +15 -0
- package/dist/src/client.d.ts +4 -0
- package/dist/src/client.js +51 -45
- package/package.json +2 -2
|
@@ -0,0 +1,374 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pingram
|
|
3
|
+
* Internal API for notification delivery and management
|
|
4
|
+
*
|
|
5
|
+
* The version of the OpenAPI document: 1.0.0
|
|
6
|
+
*
|
|
7
|
+
*
|
|
8
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
9
|
+
* https://openapi-generator.tech
|
|
10
|
+
* Do not edit the class manually.
|
|
11
|
+
*/
|
|
12
|
+
import * as runtime from '../runtime';
|
|
13
|
+
import type { BroadcastMetricsResponse, BroadcastResponse, CreateBroadcastRequest, ListBroadcastRecipientsResponse, ListBroadcastsResponse, MessageResponse, ScheduleBroadcastRequest, UpdateBroadcastRequest } from '../models/index';
|
|
14
|
+
export interface DeleteRequest {
|
|
15
|
+
broadcastId: string;
|
|
16
|
+
}
|
|
17
|
+
export interface ArchiveRequest {
|
|
18
|
+
broadcastId: string;
|
|
19
|
+
}
|
|
20
|
+
export interface CancelRequest {
|
|
21
|
+
broadcastId: string;
|
|
22
|
+
}
|
|
23
|
+
export interface CreateRequest {
|
|
24
|
+
createBroadcastRequest: CreateBroadcastRequest;
|
|
25
|
+
}
|
|
26
|
+
export interface GetRequest {
|
|
27
|
+
broadcastId: string;
|
|
28
|
+
}
|
|
29
|
+
export interface GetMetricsRequest {
|
|
30
|
+
broadcastId: string;
|
|
31
|
+
}
|
|
32
|
+
export interface ListRequest {
|
|
33
|
+
limit?: number;
|
|
34
|
+
nextToken?: string;
|
|
35
|
+
}
|
|
36
|
+
export interface ListRecipientsRequest {
|
|
37
|
+
broadcastId: string;
|
|
38
|
+
status?: string;
|
|
39
|
+
limit?: number;
|
|
40
|
+
nextToken?: string;
|
|
41
|
+
}
|
|
42
|
+
export interface PauseRequest {
|
|
43
|
+
broadcastId: string;
|
|
44
|
+
}
|
|
45
|
+
export interface ResumeRequest {
|
|
46
|
+
broadcastId: string;
|
|
47
|
+
}
|
|
48
|
+
export interface ScheduleRequest {
|
|
49
|
+
broadcastId: string;
|
|
50
|
+
scheduleBroadcastRequest: ScheduleBroadcastRequest;
|
|
51
|
+
}
|
|
52
|
+
export interface SendRequest {
|
|
53
|
+
broadcastId: string;
|
|
54
|
+
}
|
|
55
|
+
export interface UnarchiveRequest {
|
|
56
|
+
broadcastId: string;
|
|
57
|
+
}
|
|
58
|
+
export interface UpdateRequest {
|
|
59
|
+
broadcastId: string;
|
|
60
|
+
updateBroadcastRequest: UpdateBroadcastRequest;
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* BroadcastsApi - interface
|
|
64
|
+
*
|
|
65
|
+
* @export
|
|
66
|
+
* @interface BroadcastsApiInterface
|
|
67
|
+
*/
|
|
68
|
+
export interface BroadcastsApiInterface {
|
|
69
|
+
/**
|
|
70
|
+
*
|
|
71
|
+
* @summary Delete an email broadcast. Allowed for drafts, scheduled, paused, completed, and canceled broadcasts. Not allowed while status is sending.
|
|
72
|
+
* @param {string} broadcastId Broadcast ID
|
|
73
|
+
* @param {*} [options] Override http request option.
|
|
74
|
+
* @throws {RequiredError}
|
|
75
|
+
* @memberof BroadcastsApiInterface
|
|
76
|
+
*/
|
|
77
|
+
_deleteRaw(requestParameters: DeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MessageResponse>>;
|
|
78
|
+
/**
|
|
79
|
+
* Delete an email broadcast. Allowed for drafts, scheduled, paused, completed, and canceled broadcasts. Not allowed while status is sending.
|
|
80
|
+
*/
|
|
81
|
+
_delete(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MessageResponse>;
|
|
82
|
+
/**
|
|
83
|
+
*
|
|
84
|
+
* @summary Archive an email broadcast so it is hidden from the default broadcast list. Allowed for draft, paused, sent, and canceled broadcasts. Not allowed while sending or scheduled.
|
|
85
|
+
* @param {string} broadcastId Broadcast ID
|
|
86
|
+
* @param {*} [options] Override http request option.
|
|
87
|
+
* @throws {RequiredError}
|
|
88
|
+
* @memberof BroadcastsApiInterface
|
|
89
|
+
*/
|
|
90
|
+
archiveRaw(requestParameters: ArchiveRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
91
|
+
/**
|
|
92
|
+
* Archive an email broadcast so it is hidden from the default broadcast list. Allowed for draft, paused, sent, and canceled broadcasts. Not allowed while sending or scheduled.
|
|
93
|
+
*/
|
|
94
|
+
archive(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
95
|
+
/**
|
|
96
|
+
*
|
|
97
|
+
* @summary Cancel an email broadcast. Scheduled broadcasts revert to draft and drop their schedule. Sending or paused broadcasts become canceled; remaining pending recipients are skipped.
|
|
98
|
+
* @param {string} broadcastId Broadcast ID
|
|
99
|
+
* @param {*} [options] Override http request option.
|
|
100
|
+
* @throws {RequiredError}
|
|
101
|
+
* @memberof BroadcastsApiInterface
|
|
102
|
+
*/
|
|
103
|
+
cancelRaw(requestParameters: CancelRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
104
|
+
/**
|
|
105
|
+
* Cancel an email broadcast. Scheduled broadcasts revert to draft and drop their schedule. Sending or paused broadcasts become canceled; remaining pending recipients are skipped.
|
|
106
|
+
*/
|
|
107
|
+
cancel(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
108
|
+
/**
|
|
109
|
+
*
|
|
110
|
+
* @summary Create a draft email broadcast. html is the send-ready body. Optional internalTemplate is visual-editor source; if set it must be paired with html and cannot be added later. Set audience to either a Mongo-style user filter (sync users via Users API first; for large lists) or a raw email list (max 10,000). Include name, from fields, subject, and HTML. Notification type is optional on create and required before send or schedule; it is created automatically if missing.
|
|
111
|
+
* @param {CreateBroadcastRequest} createBroadcastRequest
|
|
112
|
+
* @param {*} [options] Override http request option.
|
|
113
|
+
* @throws {RequiredError}
|
|
114
|
+
* @memberof BroadcastsApiInterface
|
|
115
|
+
*/
|
|
116
|
+
createRaw(requestParameters: CreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
117
|
+
/**
|
|
118
|
+
* Create a draft email broadcast. html is the send-ready body. Optional internalTemplate is visual-editor source; if set it must be paired with html and cannot be added later. Set audience to either a Mongo-style user filter (sync users via Users API first; for large lists) or a raw email list (max 10,000). Include name, from fields, subject, and HTML. Notification type is optional on create and required before send or schedule; it is created automatically if missing.
|
|
119
|
+
*/
|
|
120
|
+
create(createBroadcastRequest: CreateBroadcastRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
121
|
+
/**
|
|
122
|
+
*
|
|
123
|
+
* @summary Get one email broadcast by ID, including the send-ready html body, optional internalTemplate (visual-editor source), and audience definition.
|
|
124
|
+
* @param {string} broadcastId Broadcast ID
|
|
125
|
+
* @param {*} [options] Override http request option.
|
|
126
|
+
* @throws {RequiredError}
|
|
127
|
+
* @memberof BroadcastsApiInterface
|
|
128
|
+
*/
|
|
129
|
+
getRaw(requestParameters: GetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
130
|
+
/**
|
|
131
|
+
* Get one email broadcast by ID, including the send-ready html body, optional internalTemplate (visual-editor source), and audience definition.
|
|
132
|
+
*/
|
|
133
|
+
get(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
134
|
+
/**
|
|
135
|
+
*
|
|
136
|
+
* @summary Poll live email broadcast metrics: status, optional pausedReason or scheduleAt, and aggregate counters (total, sent, delivered, opened, clicked, bounced, complained, unsubscribed, skipped, failed).
|
|
137
|
+
* @param {string} broadcastId Broadcast ID
|
|
138
|
+
* @param {*} [options] Override http request option.
|
|
139
|
+
* @throws {RequiredError}
|
|
140
|
+
* @memberof BroadcastsApiInterface
|
|
141
|
+
*/
|
|
142
|
+
getMetricsRaw(requestParameters: GetMetricsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastMetricsResponse>>;
|
|
143
|
+
/**
|
|
144
|
+
* Poll live email broadcast metrics: status, optional pausedReason or scheduleAt, and aggregate counters (total, sent, delivered, opened, clicked, bounced, complained, unsubscribed, skipped, failed).
|
|
145
|
+
*/
|
|
146
|
+
getMetrics(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastMetricsResponse>;
|
|
147
|
+
/**
|
|
148
|
+
*
|
|
149
|
+
* @summary List email broadcasts for the account, newest first. Returns metadata and counters without html or internalTemplate bodies. Paginate with limit (default 50, max 100) and nextToken.
|
|
150
|
+
* @param {number} [limit] Max broadcasts to return (default 50)
|
|
151
|
+
* @param {string} [nextToken] Pagination token
|
|
152
|
+
* @param {*} [options] Override http request option.
|
|
153
|
+
* @throws {RequiredError}
|
|
154
|
+
* @memberof BroadcastsApiInterface
|
|
155
|
+
*/
|
|
156
|
+
listRaw(requestParameters: ListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListBroadcastsResponse>>;
|
|
157
|
+
/**
|
|
158
|
+
* List email broadcasts for the account, newest first. Returns metadata and counters without html or internalTemplate bodies. Paginate with limit (default 50, max 100) and nextToken.
|
|
159
|
+
*/
|
|
160
|
+
list(limit?: number, nextToken?: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListBroadcastsResponse>;
|
|
161
|
+
/**
|
|
162
|
+
*
|
|
163
|
+
* @summary List email broadcast recipients with per-recipient delivery fact timestamps (sentAt, deliveredAt, openedAt, etc.). Derive display status client-side from timestamps. Filter by status (pending, sent, delivered, opened, clicked, bounced, complained, unsubscribed, skipped, failed, problems). Paginate with limit (default 50, max 200) and nextToken.
|
|
164
|
+
* @param {string} broadcastId Broadcast ID
|
|
165
|
+
* @param {string} [status] Filter
|
|
166
|
+
* @param {number} [limit] Max recipients to return (default 50)
|
|
167
|
+
* @param {string} [nextToken] Pagination token
|
|
168
|
+
* @param {*} [options] Override http request option.
|
|
169
|
+
* @throws {RequiredError}
|
|
170
|
+
* @memberof BroadcastsApiInterface
|
|
171
|
+
*/
|
|
172
|
+
listRecipientsRaw(requestParameters: ListRecipientsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListBroadcastRecipientsResponse>>;
|
|
173
|
+
/**
|
|
174
|
+
* List email broadcast recipients with per-recipient delivery fact timestamps (sentAt, deliveredAt, openedAt, etc.). Derive display status client-side from timestamps. Filter by status (pending, sent, delivered, opened, clicked, bounced, complained, unsubscribed, skipped, failed, problems). Paginate with limit (default 50, max 200) and nextToken.
|
|
175
|
+
*/
|
|
176
|
+
listRecipients(broadcastId: string, status?: string, limit?: number, nextToken?: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListBroadcastRecipientsResponse>;
|
|
177
|
+
/**
|
|
178
|
+
*
|
|
179
|
+
* @summary Pause an actively sending email broadcast. Status becomes paused with pausedReason PAUSED_BY_USER.
|
|
180
|
+
* @param {string} broadcastId Broadcast ID
|
|
181
|
+
* @param {*} [options] Override http request option.
|
|
182
|
+
* @throws {RequiredError}
|
|
183
|
+
* @memberof BroadcastsApiInterface
|
|
184
|
+
*/
|
|
185
|
+
pauseRaw(requestParameters: PauseRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
186
|
+
/**
|
|
187
|
+
* Pause an actively sending email broadcast. Status becomes paused with pausedReason PAUSED_BY_USER.
|
|
188
|
+
*/
|
|
189
|
+
pause(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
190
|
+
/**
|
|
191
|
+
*
|
|
192
|
+
* @summary Resume a paused email broadcast. Continues sending remaining recipients. Broadcasts paused for spam content cannot be resumed.
|
|
193
|
+
* @param {string} broadcastId Broadcast ID
|
|
194
|
+
* @param {*} [options] Override http request option.
|
|
195
|
+
* @throws {RequiredError}
|
|
196
|
+
* @memberof BroadcastsApiInterface
|
|
197
|
+
*/
|
|
198
|
+
resumeRaw(requestParameters: ResumeRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
199
|
+
/**
|
|
200
|
+
* Resume a paused email broadcast. Continues sending remaining recipients. Broadcasts paused for spam content cannot be resumed.
|
|
201
|
+
*/
|
|
202
|
+
resume(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
203
|
+
/**
|
|
204
|
+
*
|
|
205
|
+
* @summary Schedule a draft email broadcast for a future ISO datetime (sendAt). Requires a non-empty subject. fromAddress must be the platform default sender or a domain verified for this account (Settings → Domain Verification). The platform default sender is for testing only (at most 10 recipients, heavily throttled). Cancels any existing schedule when the broadcast is returned to draft via cancel.
|
|
206
|
+
* @param {string} broadcastId Broadcast ID
|
|
207
|
+
* @param {ScheduleBroadcastRequest} scheduleBroadcastRequest
|
|
208
|
+
* @param {*} [options] Override http request option.
|
|
209
|
+
* @throws {RequiredError}
|
|
210
|
+
* @memberof BroadcastsApiInterface
|
|
211
|
+
*/
|
|
212
|
+
scheduleRaw(requestParameters: ScheduleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
213
|
+
/**
|
|
214
|
+
* Schedule a draft email broadcast for a future ISO datetime (sendAt). Requires a non-empty subject. fromAddress must be the platform default sender or a domain verified for this account (Settings → Domain Verification). The platform default sender is for testing only (at most 10 recipients, heavily throttled). Cancels any existing schedule when the broadcast is returned to draft via cancel.
|
|
215
|
+
*/
|
|
216
|
+
schedule(broadcastId: string, scheduleBroadcastRequest: ScheduleBroadcastRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
217
|
+
/**
|
|
218
|
+
*
|
|
219
|
+
* @summary Send a draft email broadcast immediately. Requires a non-empty subject. fromAddress must be the platform default sender or a domain verified for this account (Settings → Domain Verification). The platform default sender is for testing only (at most 10 recipients, heavily throttled). Transitions status to sending and starts delivery.
|
|
220
|
+
* @param {string} broadcastId Broadcast ID
|
|
221
|
+
* @param {*} [options] Override http request option.
|
|
222
|
+
* @throws {RequiredError}
|
|
223
|
+
* @memberof BroadcastsApiInterface
|
|
224
|
+
*/
|
|
225
|
+
sendRaw(requestParameters: SendRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
226
|
+
/**
|
|
227
|
+
* Send a draft email broadcast immediately. Requires a non-empty subject. fromAddress must be the platform default sender or a domain verified for this account (Settings → Domain Verification). The platform default sender is for testing only (at most 10 recipients, heavily throttled). Transitions status to sending and starts delivery.
|
|
228
|
+
*/
|
|
229
|
+
send(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
230
|
+
/**
|
|
231
|
+
*
|
|
232
|
+
* @summary Restore an archived email broadcast to the default broadcast list.
|
|
233
|
+
* @param {string} broadcastId Broadcast ID
|
|
234
|
+
* @param {*} [options] Override http request option.
|
|
235
|
+
* @throws {RequiredError}
|
|
236
|
+
* @memberof BroadcastsApiInterface
|
|
237
|
+
*/
|
|
238
|
+
unarchiveRaw(requestParameters: UnarchiveRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
239
|
+
/**
|
|
240
|
+
* Restore an archived email broadcast to the default broadcast list.
|
|
241
|
+
*/
|
|
242
|
+
unarchive(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
243
|
+
/**
|
|
244
|
+
*
|
|
245
|
+
* @summary Update a draft email broadcast (name, type, audience, sender, subject, html). html is the send-ready body. Send an empty replyToAddress to clear Reply-To. internalTemplate can be updated only when the broadcast was created with it; it cannot be added to an html-only broadcast or removed. Only drafts can be edited; scheduled or active broadcasts are locked.
|
|
246
|
+
* @param {string} broadcastId Broadcast ID
|
|
247
|
+
* @param {UpdateBroadcastRequest} updateBroadcastRequest
|
|
248
|
+
* @param {*} [options] Override http request option.
|
|
249
|
+
* @throws {RequiredError}
|
|
250
|
+
* @memberof BroadcastsApiInterface
|
|
251
|
+
*/
|
|
252
|
+
updateRaw(requestParameters: UpdateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
253
|
+
/**
|
|
254
|
+
* Update a draft email broadcast (name, type, audience, sender, subject, html). html is the send-ready body. Send an empty replyToAddress to clear Reply-To. internalTemplate can be updated only when the broadcast was created with it; it cannot be added to an html-only broadcast or removed. Only drafts can be edited; scheduled or active broadcasts are locked.
|
|
255
|
+
*/
|
|
256
|
+
update(broadcastId: string, updateBroadcastRequest: UpdateBroadcastRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
257
|
+
}
|
|
258
|
+
/**
|
|
259
|
+
*
|
|
260
|
+
*/
|
|
261
|
+
export declare class BroadcastsApi extends runtime.BaseAPI implements BroadcastsApiInterface {
|
|
262
|
+
/**
|
|
263
|
+
* Delete an email broadcast. Allowed for drafts, scheduled, paused, completed, and canceled broadcasts. Not allowed while status is sending.
|
|
264
|
+
*/
|
|
265
|
+
_deleteRaw(requestParameters: DeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MessageResponse>>;
|
|
266
|
+
/**
|
|
267
|
+
* Delete an email broadcast. Allowed for drafts, scheduled, paused, completed, and canceled broadcasts. Not allowed while status is sending.
|
|
268
|
+
*/
|
|
269
|
+
_delete(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MessageResponse>;
|
|
270
|
+
/**
|
|
271
|
+
* Archive an email broadcast so it is hidden from the default broadcast list. Allowed for draft, paused, sent, and canceled broadcasts. Not allowed while sending or scheduled.
|
|
272
|
+
*/
|
|
273
|
+
archiveRaw(requestParameters: ArchiveRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
274
|
+
/**
|
|
275
|
+
* Archive an email broadcast so it is hidden from the default broadcast list. Allowed for draft, paused, sent, and canceled broadcasts. Not allowed while sending or scheduled.
|
|
276
|
+
*/
|
|
277
|
+
archive(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
278
|
+
/**
|
|
279
|
+
* Cancel an email broadcast. Scheduled broadcasts revert to draft and drop their schedule. Sending or paused broadcasts become canceled; remaining pending recipients are skipped.
|
|
280
|
+
*/
|
|
281
|
+
cancelRaw(requestParameters: CancelRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
282
|
+
/**
|
|
283
|
+
* Cancel an email broadcast. Scheduled broadcasts revert to draft and drop their schedule. Sending or paused broadcasts become canceled; remaining pending recipients are skipped.
|
|
284
|
+
*/
|
|
285
|
+
cancel(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
286
|
+
/**
|
|
287
|
+
* Create a draft email broadcast. html is the send-ready body. Optional internalTemplate is visual-editor source; if set it must be paired with html and cannot be added later. Set audience to either a Mongo-style user filter (sync users via Users API first; for large lists) or a raw email list (max 10,000). Include name, from fields, subject, and HTML. Notification type is optional on create and required before send or schedule; it is created automatically if missing.
|
|
288
|
+
*/
|
|
289
|
+
createRaw(requestParameters: CreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
290
|
+
/**
|
|
291
|
+
* Create a draft email broadcast. html is the send-ready body. Optional internalTemplate is visual-editor source; if set it must be paired with html and cannot be added later. Set audience to either a Mongo-style user filter (sync users via Users API first; for large lists) or a raw email list (max 10,000). Include name, from fields, subject, and HTML. Notification type is optional on create and required before send or schedule; it is created automatically if missing.
|
|
292
|
+
*/
|
|
293
|
+
create(createBroadcastRequest: CreateBroadcastRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
294
|
+
/**
|
|
295
|
+
* Get one email broadcast by ID, including the send-ready html body, optional internalTemplate (visual-editor source), and audience definition.
|
|
296
|
+
*/
|
|
297
|
+
getRaw(requestParameters: GetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
298
|
+
/**
|
|
299
|
+
* Get one email broadcast by ID, including the send-ready html body, optional internalTemplate (visual-editor source), and audience definition.
|
|
300
|
+
*/
|
|
301
|
+
get(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
302
|
+
/**
|
|
303
|
+
* Poll live email broadcast metrics: status, optional pausedReason or scheduleAt, and aggregate counters (total, sent, delivered, opened, clicked, bounced, complained, unsubscribed, skipped, failed).
|
|
304
|
+
*/
|
|
305
|
+
getMetricsRaw(requestParameters: GetMetricsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastMetricsResponse>>;
|
|
306
|
+
/**
|
|
307
|
+
* Poll live email broadcast metrics: status, optional pausedReason or scheduleAt, and aggregate counters (total, sent, delivered, opened, clicked, bounced, complained, unsubscribed, skipped, failed).
|
|
308
|
+
*/
|
|
309
|
+
getMetrics(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastMetricsResponse>;
|
|
310
|
+
/**
|
|
311
|
+
* List email broadcasts for the account, newest first. Returns metadata and counters without html or internalTemplate bodies. Paginate with limit (default 50, max 100) and nextToken.
|
|
312
|
+
*/
|
|
313
|
+
listRaw(requestParameters: ListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListBroadcastsResponse>>;
|
|
314
|
+
/**
|
|
315
|
+
* List email broadcasts for the account, newest first. Returns metadata and counters without html or internalTemplate bodies. Paginate with limit (default 50, max 100) and nextToken.
|
|
316
|
+
*/
|
|
317
|
+
list(limit?: number, nextToken?: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListBroadcastsResponse>;
|
|
318
|
+
/**
|
|
319
|
+
* List email broadcast recipients with per-recipient delivery fact timestamps (sentAt, deliveredAt, openedAt, etc.). Derive display status client-side from timestamps. Filter by status (pending, sent, delivered, opened, clicked, bounced, complained, unsubscribed, skipped, failed, problems). Paginate with limit (default 50, max 200) and nextToken.
|
|
320
|
+
*/
|
|
321
|
+
listRecipientsRaw(requestParameters: ListRecipientsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListBroadcastRecipientsResponse>>;
|
|
322
|
+
/**
|
|
323
|
+
* List email broadcast recipients with per-recipient delivery fact timestamps (sentAt, deliveredAt, openedAt, etc.). Derive display status client-side from timestamps. Filter by status (pending, sent, delivered, opened, clicked, bounced, complained, unsubscribed, skipped, failed, problems). Paginate with limit (default 50, max 200) and nextToken.
|
|
324
|
+
*/
|
|
325
|
+
listRecipients(broadcastId: string, status?: string, limit?: number, nextToken?: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListBroadcastRecipientsResponse>;
|
|
326
|
+
/**
|
|
327
|
+
* Pause an actively sending email broadcast. Status becomes paused with pausedReason PAUSED_BY_USER.
|
|
328
|
+
*/
|
|
329
|
+
pauseRaw(requestParameters: PauseRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
330
|
+
/**
|
|
331
|
+
* Pause an actively sending email broadcast. Status becomes paused with pausedReason PAUSED_BY_USER.
|
|
332
|
+
*/
|
|
333
|
+
pause(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
334
|
+
/**
|
|
335
|
+
* Resume a paused email broadcast. Continues sending remaining recipients. Broadcasts paused for spam content cannot be resumed.
|
|
336
|
+
*/
|
|
337
|
+
resumeRaw(requestParameters: ResumeRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
338
|
+
/**
|
|
339
|
+
* Resume a paused email broadcast. Continues sending remaining recipients. Broadcasts paused for spam content cannot be resumed.
|
|
340
|
+
*/
|
|
341
|
+
resume(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
342
|
+
/**
|
|
343
|
+
* Schedule a draft email broadcast for a future ISO datetime (sendAt). Requires a non-empty subject. fromAddress must be the platform default sender or a domain verified for this account (Settings → Domain Verification). The platform default sender is for testing only (at most 10 recipients, heavily throttled). Cancels any existing schedule when the broadcast is returned to draft via cancel.
|
|
344
|
+
*/
|
|
345
|
+
scheduleRaw(requestParameters: ScheduleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
346
|
+
/**
|
|
347
|
+
* Schedule a draft email broadcast for a future ISO datetime (sendAt). Requires a non-empty subject. fromAddress must be the platform default sender or a domain verified for this account (Settings → Domain Verification). The platform default sender is for testing only (at most 10 recipients, heavily throttled). Cancels any existing schedule when the broadcast is returned to draft via cancel.
|
|
348
|
+
*/
|
|
349
|
+
schedule(broadcastId: string, scheduleBroadcastRequest: ScheduleBroadcastRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
350
|
+
/**
|
|
351
|
+
* Send a draft email broadcast immediately. Requires a non-empty subject. fromAddress must be the platform default sender or a domain verified for this account (Settings → Domain Verification). The platform default sender is for testing only (at most 10 recipients, heavily throttled). Transitions status to sending and starts delivery.
|
|
352
|
+
*/
|
|
353
|
+
sendRaw(requestParameters: SendRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
354
|
+
/**
|
|
355
|
+
* Send a draft email broadcast immediately. Requires a non-empty subject. fromAddress must be the platform default sender or a domain verified for this account (Settings → Domain Verification). The platform default sender is for testing only (at most 10 recipients, heavily throttled). Transitions status to sending and starts delivery.
|
|
356
|
+
*/
|
|
357
|
+
send(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
358
|
+
/**
|
|
359
|
+
* Restore an archived email broadcast to the default broadcast list.
|
|
360
|
+
*/
|
|
361
|
+
unarchiveRaw(requestParameters: UnarchiveRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
362
|
+
/**
|
|
363
|
+
* Restore an archived email broadcast to the default broadcast list.
|
|
364
|
+
*/
|
|
365
|
+
unarchive(broadcastId: string, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
366
|
+
/**
|
|
367
|
+
* Update a draft email broadcast (name, type, audience, sender, subject, html). html is the send-ready body. Send an empty replyToAddress to clear Reply-To. internalTemplate can be updated only when the broadcast was created with it; it cannot be added to an html-only broadcast or removed. Only drafts can be edited; scheduled or active broadcasts are locked.
|
|
368
|
+
*/
|
|
369
|
+
updateRaw(requestParameters: UpdateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BroadcastResponse>>;
|
|
370
|
+
/**
|
|
371
|
+
* Update a draft email broadcast (name, type, audience, sender, subject, html). html is the send-ready body. Send an empty replyToAddress to clear Reply-To. internalTemplate can be updated only when the broadcast was created with it; it cannot be added to an html-only broadcast or removed. Only drafts can be edited; scheduled or active broadcasts are locked.
|
|
372
|
+
*/
|
|
373
|
+
update(broadcastId: string, updateBroadcastRequest: UpdateBroadcastRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BroadcastResponse>;
|
|
374
|
+
}
|