@realforce-software/api-client 0.0.11
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/README.md +76 -0
- package/dist/client.generated.d.ts +2379 -0
- package/dist/client.generated.d.ts.map +1 -0
- package/dist/client.generated.js +3072 -0
- package/dist/client.generated.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +19 -0
- package/dist/index.js.map +1 -0
- package/package.json +40 -0
- package/src/client.generated.ts +5191 -0
- package/src/index.ts +2 -0
|
@@ -0,0 +1,2379 @@
|
|
|
1
|
+
import type { AxiosInstance, AxiosResponse, CancelToken } from 'axios';
|
|
2
|
+
export interface IRealforceApiClient {
|
|
3
|
+
/**
|
|
4
|
+
* Get a specific agent by ID.
|
|
5
|
+
* @param agentId The agent's Realforce ID.
|
|
6
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
7
|
+
* @return The agent object.
|
|
8
|
+
*/
|
|
9
|
+
getAgent(agentId: string, x_Workspace_ID: string): Promise<Agent>;
|
|
10
|
+
/**
|
|
11
|
+
* Update an agent.
|
|
12
|
+
* @param agentId The agent's Realforce ID.
|
|
13
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
14
|
+
* @param body (optional) The agent fields to update. Only fields included in the body are changed.
|
|
15
|
+
* @return Agent updated.
|
|
16
|
+
*/
|
|
17
|
+
putAgent(agentId: string, x_Workspace_ID: string, body?: UpdateAgentRequest | undefined): Promise<string>;
|
|
18
|
+
/**
|
|
19
|
+
* Returns a list of agents.
|
|
20
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
21
|
+
* @param body (optional) Filter and pagination options.
|
|
22
|
+
* @return Paginated list of agents.
|
|
23
|
+
*/
|
|
24
|
+
queryAgents(x_Workspace_ID: string, body?: AgentQueryRequest | undefined): Promise<AgentListResponse>;
|
|
25
|
+
/**
|
|
26
|
+
* Create an agent. If the agent already exists, the information will be updated.
|
|
27
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
28
|
+
* @param body (optional) The agent data to create or update.
|
|
29
|
+
* @return Agent created. Returns the agent ID.
|
|
30
|
+
*/
|
|
31
|
+
postAgent(x_Workspace_ID: string, body?: CreateAgentRequest | undefined): Promise<string>;
|
|
32
|
+
/**
|
|
33
|
+
* Delete an agent.
|
|
34
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
35
|
+
* @param body (optional) The agent to delete (by AgentId, ExternalId, or Email).
|
|
36
|
+
* @return Agent deleted.
|
|
37
|
+
*/
|
|
38
|
+
deleteAgent(x_Workspace_ID: string, body?: DeleteAgentRequest | undefined): Promise<string>;
|
|
39
|
+
/**
|
|
40
|
+
* Upload an asset and link it to one or more subjects.
|
|
41
|
+
* @param body (optional) Asset name, source, file type, source URLs, and target subjects.
|
|
42
|
+
* @return Asset uploaded and linked.
|
|
43
|
+
*/
|
|
44
|
+
createAsset(body?: CreateAssetRequest | undefined): Promise<void>;
|
|
45
|
+
/**
|
|
46
|
+
* Get a list of all campaigns with optional filters.
|
|
47
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
48
|
+
* @param body (optional) Filter and pagination options.
|
|
49
|
+
* @return Paginated list of campaigns.
|
|
50
|
+
*/
|
|
51
|
+
queryCampaigns(x_Workspace_ID: string, body?: CampaignQueryRequest | undefined): Promise<CampaignListResponse>;
|
|
52
|
+
/**
|
|
53
|
+
* Get a single campaign by ID.
|
|
54
|
+
* @param campaignId The campaign's Realforce ID.
|
|
55
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
56
|
+
* @return The campaign object.
|
|
57
|
+
*/
|
|
58
|
+
getCampaign(campaignId: string, x_Workspace_ID: string): Promise<Campaign>;
|
|
59
|
+
/**
|
|
60
|
+
* Upsert a property together with its office and agent in a single request.
|
|
61
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
62
|
+
* @param body (optional) The combined property, office, and agent data to upsert.
|
|
63
|
+
* @return Request processed. Inspect `errorMessage` for partial-failure details.
|
|
64
|
+
*/
|
|
65
|
+
postFullData(x_Workspace_ID: string, body?: CreateFullDataRequest | undefined): Promise<CreateFullDataResponse>;
|
|
66
|
+
/**
|
|
67
|
+
* Publish a lead against a property, agent, or office.
|
|
68
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
69
|
+
* @param body (optional) The lead data including subject type and identifiers.
|
|
70
|
+
* @return Lead published.
|
|
71
|
+
*/
|
|
72
|
+
postLead(x_Workspace_ID: string, body?: CreateLeadRequest | undefined): Promise<CreateLeadResponse>;
|
|
73
|
+
/**
|
|
74
|
+
* Generate a magic link for a property or marketing opportunity.
|
|
75
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
76
|
+
* @param body (optional) The magic link type, subject ID, and target user email.
|
|
77
|
+
* @return Magic link generated.
|
|
78
|
+
*/
|
|
79
|
+
createMagicLink(x_Workspace_ID: string, body?: CreateMagicLinkRequest | undefined): Promise<MagicLinkResponse>;
|
|
80
|
+
/**
|
|
81
|
+
* Cancel autopublish of a marketing opportunity.
|
|
82
|
+
* @param marketingOpportunityId The marketing opportunity ID.
|
|
83
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
84
|
+
* @return Autopublish cancelled.
|
|
85
|
+
*/
|
|
86
|
+
cancelMarketingOpportunitiesAutoPublish(marketingOpportunityId: string, x_Workspace_ID: string): Promise<CancelAutopublishResponse>;
|
|
87
|
+
/**
|
|
88
|
+
* Make a marketing opportunity's order page available or unavailable.
|
|
89
|
+
* @param marketingOpportunityId The marketing opportunity ID.
|
|
90
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
91
|
+
* @param body (optional) The new order page availability and an optional unavailable reason.
|
|
92
|
+
* @return Order page availability updated.
|
|
93
|
+
*/
|
|
94
|
+
setOrderPageAvailability(marketingOpportunityId: string, x_Workspace_ID: string, body?: SetOrderPageAvailabilityRequest | undefined): Promise<SetOrderPageAvailabilityResponse>;
|
|
95
|
+
/**
|
|
96
|
+
* Get available marketing opportunities with optional filters.
|
|
97
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
98
|
+
* @param body (optional) List request with pagination, sorting, and filter criteria.
|
|
99
|
+
* @return Paginated list of marketing opportunities.
|
|
100
|
+
*/
|
|
101
|
+
queryMarketingOpportunities(x_Workspace_ID: string, body?: MarketingOpportunityQueryRequest | undefined): Promise<MarketingOpportunityListResponse>;
|
|
102
|
+
/**
|
|
103
|
+
* Get a specific office by ID.
|
|
104
|
+
* @param officeId The office's Realforce ID.
|
|
105
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
106
|
+
* @return The office object.
|
|
107
|
+
*/
|
|
108
|
+
getOffice(officeId: string, x_Workspace_ID: string): Promise<Office>;
|
|
109
|
+
/**
|
|
110
|
+
* Update an office.
|
|
111
|
+
* @param officeId The office's Realforce ID.
|
|
112
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
113
|
+
* @param body (optional) The office fields to update. Only fields included in the body are changed.
|
|
114
|
+
* @return Office updated.
|
|
115
|
+
*/
|
|
116
|
+
putOffice(officeId: string, x_Workspace_ID: string, body?: PutOfficeRequest | undefined): Promise<string>;
|
|
117
|
+
/**
|
|
118
|
+
* Get a list of all offices.
|
|
119
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
120
|
+
* @param body (optional) Filter and pagination options.
|
|
121
|
+
* @return Paginated list of offices.
|
|
122
|
+
*/
|
|
123
|
+
queryOffices(x_Workspace_ID: string, body?: OfficeQueryRequest | undefined): Promise<OfficeListResponse>;
|
|
124
|
+
/**
|
|
125
|
+
* Create an office. If an office with the same ExternalId already exists, the existing office will be updated.
|
|
126
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
127
|
+
* @param body (optional) The office data to create or update.
|
|
128
|
+
* @return Office created or updated. Returns the office ID.
|
|
129
|
+
*/
|
|
130
|
+
postOffice(x_Workspace_ID: string, body?: PostOfficeRequest | undefined): Promise<string>;
|
|
131
|
+
/**
|
|
132
|
+
* Delete an office.
|
|
133
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
134
|
+
* @param body (optional) The office to delete (by OfficeId or ExternalId).
|
|
135
|
+
* @return Office deleted.
|
|
136
|
+
*/
|
|
137
|
+
deleteOffice(x_Workspace_ID: string, body?: DeleteOfficeRequest | undefined): Promise<string>;
|
|
138
|
+
/**
|
|
139
|
+
* Place an order. Creating orders may take some time and therefor an order request id is returned which can be queried to get the status of the order
|
|
140
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
141
|
+
* @param body (optional) The order details including marketing opportunity and product.
|
|
142
|
+
* @return Order request accepted. Returns the request ID.
|
|
143
|
+
*/
|
|
144
|
+
createOrder(x_Workspace_ID: string, body?: OrderRequest | undefined): Promise<string>;
|
|
145
|
+
/**
|
|
146
|
+
* Get the status of a previously placed order request.
|
|
147
|
+
* @param orderRequestId The request ID returned when placing the order.
|
|
148
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
149
|
+
* @return The current order status.
|
|
150
|
+
*/
|
|
151
|
+
getOrderStatus(orderRequestId: string, x_Workspace_ID: string): Promise<OrderStatusResponse>;
|
|
152
|
+
/**
|
|
153
|
+
* Get a list of all orders with optional filters.
|
|
154
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
155
|
+
* @param body (optional) Filter and pagination options.
|
|
156
|
+
* @return Paginated list of orders.
|
|
157
|
+
*/
|
|
158
|
+
queryOrders(x_Workspace_ID: string, body?: OrderQueryRequest | undefined): Promise<OrderListResponse>;
|
|
159
|
+
/**
|
|
160
|
+
* Get a specific order by ID.
|
|
161
|
+
* @param orderId The order's Realforce ID.
|
|
162
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
163
|
+
* @return The order object.
|
|
164
|
+
*/
|
|
165
|
+
getOrder(orderId: string, x_Workspace_ID: string): Promise<Order>;
|
|
166
|
+
/**
|
|
167
|
+
* Get info about the personal access token used to authenticate this request.
|
|
168
|
+
* @return Personal access token details.
|
|
169
|
+
*/
|
|
170
|
+
get(): Promise<PatResponse>;
|
|
171
|
+
/**
|
|
172
|
+
* Revoke the personal access token used to authenticate this request.
|
|
173
|
+
* @return The token was revoked.
|
|
174
|
+
*/
|
|
175
|
+
revoke(): Promise<void>;
|
|
176
|
+
/**
|
|
177
|
+
* Rotate the personal access token used to authenticate this request.
|
|
178
|
+
* @return The new token was issued. The response body contains the only copy of the new secret.
|
|
179
|
+
*/
|
|
180
|
+
rotate(): Promise<RotatePatResponse>;
|
|
181
|
+
/**
|
|
182
|
+
* Returns a list of products.
|
|
183
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
184
|
+
* @param body (optional) Filter and pagination options.
|
|
185
|
+
* @return Paginated list of products.
|
|
186
|
+
*/
|
|
187
|
+
queryProducts(x_Workspace_ID: string, body?: ProductQueryRequest | undefined): Promise<ProductListResponse>;
|
|
188
|
+
/**
|
|
189
|
+
* Get data about a specific property.
|
|
190
|
+
* @param propertyId The property's Realforce ID.
|
|
191
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
192
|
+
* @return The property object.
|
|
193
|
+
*/
|
|
194
|
+
getProperty(propertyId: string, x_Workspace_ID: string): Promise<Property>;
|
|
195
|
+
/**
|
|
196
|
+
* Update a property with the specified PropertyId.
|
|
197
|
+
* @param propertyId The property's Realforce ID.
|
|
198
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
199
|
+
* @param body (optional) The property fields to update. Only fields included in the body are changed.
|
|
200
|
+
* @return Property updated. Returns the property ID.
|
|
201
|
+
*/
|
|
202
|
+
putProperty(propertyId: string, x_Workspace_ID: string, body?: UpdatePropertyRequest | undefined): Promise<string>;
|
|
203
|
+
/**
|
|
204
|
+
* Create a property. If a property with the same unique identifier already exists, the existing property will be updated.
|
|
205
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
206
|
+
* @param body (optional) The property data to create or update.
|
|
207
|
+
* @return Property created or updated. Returns the property ID.
|
|
208
|
+
*/
|
|
209
|
+
postProperty(x_Workspace_ID: string, body?: CreatePropertyRequest | undefined): Promise<string>;
|
|
210
|
+
/**
|
|
211
|
+
* Delete a property.
|
|
212
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
213
|
+
* @param body (optional) The property to delete (by PropertyId or ExternalId).
|
|
214
|
+
* @return Property deleted.
|
|
215
|
+
*/
|
|
216
|
+
deleteProperty(x_Workspace_ID: string, body?: DeletePropertyRequest | undefined): Promise<string>;
|
|
217
|
+
/**
|
|
218
|
+
* Apply a single set of values to many properties in one request.
|
|
219
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
220
|
+
* @param body (optional) Targets and the values to apply to each.
|
|
221
|
+
* @return Batch processed. Inspect each `result.status` for individual outcomes.
|
|
222
|
+
*/
|
|
223
|
+
batchUpdateProperties(x_Workspace_ID: string, body?: BatchUpdatePropertyRequest | undefined): Promise<BatchUpdatePropertyResponse>;
|
|
224
|
+
/**
|
|
225
|
+
* Get a list of all properties and their data.
|
|
226
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
227
|
+
* @param body (optional) Filter and pagination options.
|
|
228
|
+
* @return Paginated list of properties.
|
|
229
|
+
*/
|
|
230
|
+
queryProperties(x_Workspace_ID: string, body?: PropertyQueryRequest | undefined): Promise<PropertyListResponse>;
|
|
231
|
+
/**
|
|
232
|
+
* Generates a URL to be returned to the customer where a token is attached.
|
|
233
|
+
* @param propertyId The property's Realforce ID.
|
|
234
|
+
* @param emailAddress The email address of the seller.
|
|
235
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
236
|
+
* @return Returns the invite URL.
|
|
237
|
+
*/
|
|
238
|
+
postInviteSeller(propertyId: string, emailAddress: string, x_Workspace_ID: string): Promise<InvitedSellerResponse>;
|
|
239
|
+
/**
|
|
240
|
+
* List all triggers configured for the current workspace.
|
|
241
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
242
|
+
* @return The list of configured triggers.
|
|
243
|
+
*/
|
|
244
|
+
getTriggersForWorkspace(x_Workspace_ID: string): Promise<TriggerResponse>;
|
|
245
|
+
/**
|
|
246
|
+
* Fire a trigger against a resolved subject.
|
|
247
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
248
|
+
* @param body (optional) Subject type, trigger ID, and lookup criteria (subjectId or externalId).
|
|
249
|
+
* @return Trigger fired. Returns the resolved subject and request ID.
|
|
250
|
+
*/
|
|
251
|
+
postTriggerByFilter(x_Workspace_ID: string, body?: TriggerRequest | undefined): Promise<TriggerByFilterResponse>;
|
|
252
|
+
/**
|
|
253
|
+
* Get the profile of the authenticated user.
|
|
254
|
+
* @return The user profile.
|
|
255
|
+
*/
|
|
256
|
+
getUserProfile(): Promise<UserProfile>;
|
|
257
|
+
/**
|
|
258
|
+
* Returns a list of users.
|
|
259
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
260
|
+
* @param body (optional) Filter and pagination options.
|
|
261
|
+
* @return Paginated list of users.
|
|
262
|
+
*/
|
|
263
|
+
queryUsers(x_Workspace_ID: string, body?: UserQueryRequest | undefined): Promise<UserListResponse>;
|
|
264
|
+
/**
|
|
265
|
+
* Create a user. If a user with the same email already exists on the workspace, the existing user will be updated.
|
|
266
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
267
|
+
* @param body (optional) The user data to create or update.
|
|
268
|
+
* @return User created or updated. Returns the user ID.
|
|
269
|
+
*/
|
|
270
|
+
postUser(x_Workspace_ID: string, body?: CreateUserRequest | undefined): Promise<string>;
|
|
271
|
+
/**
|
|
272
|
+
* Get information about the workspace associated with the current API token.
|
|
273
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
274
|
+
* @return The workspace object.
|
|
275
|
+
*/
|
|
276
|
+
getWorkspace(x_Workspace_ID: string): Promise<Workspace>;
|
|
277
|
+
}
|
|
278
|
+
export declare class RealforceApiClient implements IRealforceApiClient {
|
|
279
|
+
protected instance: AxiosInstance;
|
|
280
|
+
protected baseUrl: string;
|
|
281
|
+
protected jsonParseReviver: ((key: string, value: any) => any) | undefined;
|
|
282
|
+
constructor(baseUrl?: string, instance?: AxiosInstance);
|
|
283
|
+
/**
|
|
284
|
+
* Get a specific agent by ID.
|
|
285
|
+
* @param agentId The agent's Realforce ID.
|
|
286
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
287
|
+
* @return The agent object.
|
|
288
|
+
*/
|
|
289
|
+
getAgent(agentId: string, x_Workspace_ID: string, cancelToken?: CancelToken): Promise<Agent>;
|
|
290
|
+
protected processGetAgent(response: AxiosResponse): Promise<Agent>;
|
|
291
|
+
/**
|
|
292
|
+
* Update an agent.
|
|
293
|
+
* @param agentId The agent's Realforce ID.
|
|
294
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
295
|
+
* @param body (optional) The agent fields to update. Only fields included in the body are changed.
|
|
296
|
+
* @return Agent updated.
|
|
297
|
+
*/
|
|
298
|
+
putAgent(agentId: string, x_Workspace_ID: string, body?: UpdateAgentRequest | undefined, cancelToken?: CancelToken): Promise<string>;
|
|
299
|
+
protected processPutAgent(response: AxiosResponse): Promise<string>;
|
|
300
|
+
/**
|
|
301
|
+
* Returns a list of agents.
|
|
302
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
303
|
+
* @param body (optional) Filter and pagination options.
|
|
304
|
+
* @return Paginated list of agents.
|
|
305
|
+
*/
|
|
306
|
+
queryAgents(x_Workspace_ID: string, body?: AgentQueryRequest | undefined, cancelToken?: CancelToken): Promise<AgentListResponse>;
|
|
307
|
+
protected processQueryAgents(response: AxiosResponse): Promise<AgentListResponse>;
|
|
308
|
+
/**
|
|
309
|
+
* Create an agent. If the agent already exists, the information will be updated.
|
|
310
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
311
|
+
* @param body (optional) The agent data to create or update.
|
|
312
|
+
* @return Agent created. Returns the agent ID.
|
|
313
|
+
*/
|
|
314
|
+
postAgent(x_Workspace_ID: string, body?: CreateAgentRequest | undefined, cancelToken?: CancelToken): Promise<string>;
|
|
315
|
+
protected processPostAgent(response: AxiosResponse): Promise<string>;
|
|
316
|
+
/**
|
|
317
|
+
* Delete an agent.
|
|
318
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
319
|
+
* @param body (optional) The agent to delete (by AgentId, ExternalId, or Email).
|
|
320
|
+
* @return Agent deleted.
|
|
321
|
+
*/
|
|
322
|
+
deleteAgent(x_Workspace_ID: string, body?: DeleteAgentRequest | undefined, cancelToken?: CancelToken): Promise<string>;
|
|
323
|
+
protected processDeleteAgent(response: AxiosResponse): Promise<string>;
|
|
324
|
+
/**
|
|
325
|
+
* Upload an asset and link it to one or more subjects.
|
|
326
|
+
* @param body (optional) Asset name, source, file type, source URLs, and target subjects.
|
|
327
|
+
* @return Asset uploaded and linked.
|
|
328
|
+
*/
|
|
329
|
+
createAsset(body?: CreateAssetRequest | undefined, cancelToken?: CancelToken): Promise<void>;
|
|
330
|
+
protected processCreateAsset(response: AxiosResponse): Promise<void>;
|
|
331
|
+
/**
|
|
332
|
+
* Get a list of all campaigns with optional filters.
|
|
333
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
334
|
+
* @param body (optional) Filter and pagination options.
|
|
335
|
+
* @return Paginated list of campaigns.
|
|
336
|
+
*/
|
|
337
|
+
queryCampaigns(x_Workspace_ID: string, body?: CampaignQueryRequest | undefined, cancelToken?: CancelToken): Promise<CampaignListResponse>;
|
|
338
|
+
protected processQueryCampaigns(response: AxiosResponse): Promise<CampaignListResponse>;
|
|
339
|
+
/**
|
|
340
|
+
* Get a single campaign by ID.
|
|
341
|
+
* @param campaignId The campaign's Realforce ID.
|
|
342
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
343
|
+
* @return The campaign object.
|
|
344
|
+
*/
|
|
345
|
+
getCampaign(campaignId: string, x_Workspace_ID: string, cancelToken?: CancelToken): Promise<Campaign>;
|
|
346
|
+
protected processGetCampaign(response: AxiosResponse): Promise<Campaign>;
|
|
347
|
+
/**
|
|
348
|
+
* Upsert a property together with its office and agent in a single request.
|
|
349
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
350
|
+
* @param body (optional) The combined property, office, and agent data to upsert.
|
|
351
|
+
* @return Request processed. Inspect `errorMessage` for partial-failure details.
|
|
352
|
+
*/
|
|
353
|
+
postFullData(x_Workspace_ID: string, body?: CreateFullDataRequest | undefined, cancelToken?: CancelToken): Promise<CreateFullDataResponse>;
|
|
354
|
+
protected processPostFullData(response: AxiosResponse): Promise<CreateFullDataResponse>;
|
|
355
|
+
/**
|
|
356
|
+
* Publish a lead against a property, agent, or office.
|
|
357
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
358
|
+
* @param body (optional) The lead data including subject type and identifiers.
|
|
359
|
+
* @return Lead published.
|
|
360
|
+
*/
|
|
361
|
+
postLead(x_Workspace_ID: string, body?: CreateLeadRequest | undefined, cancelToken?: CancelToken): Promise<CreateLeadResponse>;
|
|
362
|
+
protected processPostLead(response: AxiosResponse): Promise<CreateLeadResponse>;
|
|
363
|
+
/**
|
|
364
|
+
* Generate a magic link for a property or marketing opportunity.
|
|
365
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
366
|
+
* @param body (optional) The magic link type, subject ID, and target user email.
|
|
367
|
+
* @return Magic link generated.
|
|
368
|
+
*/
|
|
369
|
+
createMagicLink(x_Workspace_ID: string, body?: CreateMagicLinkRequest | undefined, cancelToken?: CancelToken): Promise<MagicLinkResponse>;
|
|
370
|
+
protected processCreateMagicLink(response: AxiosResponse): Promise<MagicLinkResponse>;
|
|
371
|
+
/**
|
|
372
|
+
* Cancel autopublish of a marketing opportunity.
|
|
373
|
+
* @param marketingOpportunityId The marketing opportunity ID.
|
|
374
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
375
|
+
* @return Autopublish cancelled.
|
|
376
|
+
*/
|
|
377
|
+
cancelMarketingOpportunitiesAutoPublish(marketingOpportunityId: string, x_Workspace_ID: string, cancelToken?: CancelToken): Promise<CancelAutopublishResponse>;
|
|
378
|
+
protected processCancelMarketingOpportunitiesAutoPublish(response: AxiosResponse): Promise<CancelAutopublishResponse>;
|
|
379
|
+
/**
|
|
380
|
+
* Make a marketing opportunity's order page available or unavailable.
|
|
381
|
+
* @param marketingOpportunityId The marketing opportunity ID.
|
|
382
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
383
|
+
* @param body (optional) The new order page availability and an optional unavailable reason.
|
|
384
|
+
* @return Order page availability updated.
|
|
385
|
+
*/
|
|
386
|
+
setOrderPageAvailability(marketingOpportunityId: string, x_Workspace_ID: string, body?: SetOrderPageAvailabilityRequest | undefined, cancelToken?: CancelToken): Promise<SetOrderPageAvailabilityResponse>;
|
|
387
|
+
protected processSetOrderPageAvailability(response: AxiosResponse): Promise<SetOrderPageAvailabilityResponse>;
|
|
388
|
+
/**
|
|
389
|
+
* Get available marketing opportunities with optional filters.
|
|
390
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
391
|
+
* @param body (optional) List request with pagination, sorting, and filter criteria.
|
|
392
|
+
* @return Paginated list of marketing opportunities.
|
|
393
|
+
*/
|
|
394
|
+
queryMarketingOpportunities(x_Workspace_ID: string, body?: MarketingOpportunityQueryRequest | undefined, cancelToken?: CancelToken): Promise<MarketingOpportunityListResponse>;
|
|
395
|
+
protected processQueryMarketingOpportunities(response: AxiosResponse): Promise<MarketingOpportunityListResponse>;
|
|
396
|
+
/**
|
|
397
|
+
* Get a specific office by ID.
|
|
398
|
+
* @param officeId The office's Realforce ID.
|
|
399
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
400
|
+
* @return The office object.
|
|
401
|
+
*/
|
|
402
|
+
getOffice(officeId: string, x_Workspace_ID: string, cancelToken?: CancelToken): Promise<Office>;
|
|
403
|
+
protected processGetOffice(response: AxiosResponse): Promise<Office>;
|
|
404
|
+
/**
|
|
405
|
+
* Update an office.
|
|
406
|
+
* @param officeId The office's Realforce ID.
|
|
407
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
408
|
+
* @param body (optional) The office fields to update. Only fields included in the body are changed.
|
|
409
|
+
* @return Office updated.
|
|
410
|
+
*/
|
|
411
|
+
putOffice(officeId: string, x_Workspace_ID: string, body?: PutOfficeRequest | undefined, cancelToken?: CancelToken): Promise<string>;
|
|
412
|
+
protected processPutOffice(response: AxiosResponse): Promise<string>;
|
|
413
|
+
/**
|
|
414
|
+
* Get a list of all offices.
|
|
415
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
416
|
+
* @param body (optional) Filter and pagination options.
|
|
417
|
+
* @return Paginated list of offices.
|
|
418
|
+
*/
|
|
419
|
+
queryOffices(x_Workspace_ID: string, body?: OfficeQueryRequest | undefined, cancelToken?: CancelToken): Promise<OfficeListResponse>;
|
|
420
|
+
protected processQueryOffices(response: AxiosResponse): Promise<OfficeListResponse>;
|
|
421
|
+
/**
|
|
422
|
+
* Create an office. If an office with the same ExternalId already exists, the existing office will be updated.
|
|
423
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
424
|
+
* @param body (optional) The office data to create or update.
|
|
425
|
+
* @return Office created or updated. Returns the office ID.
|
|
426
|
+
*/
|
|
427
|
+
postOffice(x_Workspace_ID: string, body?: PostOfficeRequest | undefined, cancelToken?: CancelToken): Promise<string>;
|
|
428
|
+
protected processPostOffice(response: AxiosResponse): Promise<string>;
|
|
429
|
+
/**
|
|
430
|
+
* Delete an office.
|
|
431
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
432
|
+
* @param body (optional) The office to delete (by OfficeId or ExternalId).
|
|
433
|
+
* @return Office deleted.
|
|
434
|
+
*/
|
|
435
|
+
deleteOffice(x_Workspace_ID: string, body?: DeleteOfficeRequest | undefined, cancelToken?: CancelToken): Promise<string>;
|
|
436
|
+
protected processDeleteOffice(response: AxiosResponse): Promise<string>;
|
|
437
|
+
/**
|
|
438
|
+
* Place an order. Creating orders may take some time and therefor an order request id is returned which can be queried to get the status of the order
|
|
439
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
440
|
+
* @param body (optional) The order details including marketing opportunity and product.
|
|
441
|
+
* @return Order request accepted. Returns the request ID.
|
|
442
|
+
*/
|
|
443
|
+
createOrder(x_Workspace_ID: string, body?: OrderRequest | undefined, cancelToken?: CancelToken): Promise<string>;
|
|
444
|
+
protected processCreateOrder(response: AxiosResponse): Promise<string>;
|
|
445
|
+
/**
|
|
446
|
+
* Get the status of a previously placed order request.
|
|
447
|
+
* @param orderRequestId The request ID returned when placing the order.
|
|
448
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
449
|
+
* @return The current order status.
|
|
450
|
+
*/
|
|
451
|
+
getOrderStatus(orderRequestId: string, x_Workspace_ID: string, cancelToken?: CancelToken): Promise<OrderStatusResponse>;
|
|
452
|
+
protected processGetOrderStatus(response: AxiosResponse): Promise<OrderStatusResponse>;
|
|
453
|
+
/**
|
|
454
|
+
* Get a list of all orders with optional filters.
|
|
455
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
456
|
+
* @param body (optional) Filter and pagination options.
|
|
457
|
+
* @return Paginated list of orders.
|
|
458
|
+
*/
|
|
459
|
+
queryOrders(x_Workspace_ID: string, body?: OrderQueryRequest | undefined, cancelToken?: CancelToken): Promise<OrderListResponse>;
|
|
460
|
+
protected processQueryOrders(response: AxiosResponse): Promise<OrderListResponse>;
|
|
461
|
+
/**
|
|
462
|
+
* Get a specific order by ID.
|
|
463
|
+
* @param orderId The order's Realforce ID.
|
|
464
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
465
|
+
* @return The order object.
|
|
466
|
+
*/
|
|
467
|
+
getOrder(orderId: string, x_Workspace_ID: string, cancelToken?: CancelToken): Promise<Order>;
|
|
468
|
+
protected processGetOrder(response: AxiosResponse): Promise<Order>;
|
|
469
|
+
/**
|
|
470
|
+
* Get info about the personal access token used to authenticate this request.
|
|
471
|
+
* @return Personal access token details.
|
|
472
|
+
*/
|
|
473
|
+
get(cancelToken?: CancelToken): Promise<PatResponse>;
|
|
474
|
+
protected processGet(response: AxiosResponse): Promise<PatResponse>;
|
|
475
|
+
/**
|
|
476
|
+
* Revoke the personal access token used to authenticate this request.
|
|
477
|
+
* @return The token was revoked.
|
|
478
|
+
*/
|
|
479
|
+
revoke(cancelToken?: CancelToken): Promise<void>;
|
|
480
|
+
protected processRevoke(response: AxiosResponse): Promise<void>;
|
|
481
|
+
/**
|
|
482
|
+
* Rotate the personal access token used to authenticate this request.
|
|
483
|
+
* @return The new token was issued. The response body contains the only copy of the new secret.
|
|
484
|
+
*/
|
|
485
|
+
rotate(cancelToken?: CancelToken): Promise<RotatePatResponse>;
|
|
486
|
+
protected processRotate(response: AxiosResponse): Promise<RotatePatResponse>;
|
|
487
|
+
/**
|
|
488
|
+
* Returns a list of products.
|
|
489
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
490
|
+
* @param body (optional) Filter and pagination options.
|
|
491
|
+
* @return Paginated list of products.
|
|
492
|
+
*/
|
|
493
|
+
queryProducts(x_Workspace_ID: string, body?: ProductQueryRequest | undefined, cancelToken?: CancelToken): Promise<ProductListResponse>;
|
|
494
|
+
protected processQueryProducts(response: AxiosResponse): Promise<ProductListResponse>;
|
|
495
|
+
/**
|
|
496
|
+
* Get data about a specific property.
|
|
497
|
+
* @param propertyId The property's Realforce ID.
|
|
498
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
499
|
+
* @return The property object.
|
|
500
|
+
*/
|
|
501
|
+
getProperty(propertyId: string, x_Workspace_ID: string, cancelToken?: CancelToken): Promise<Property>;
|
|
502
|
+
protected processGetProperty(response: AxiosResponse): Promise<Property>;
|
|
503
|
+
/**
|
|
504
|
+
* Update a property with the specified PropertyId.
|
|
505
|
+
* @param propertyId The property's Realforce ID.
|
|
506
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
507
|
+
* @param body (optional) The property fields to update. Only fields included in the body are changed.
|
|
508
|
+
* @return Property updated. Returns the property ID.
|
|
509
|
+
*/
|
|
510
|
+
putProperty(propertyId: string, x_Workspace_ID: string, body?: UpdatePropertyRequest | undefined, cancelToken?: CancelToken): Promise<string>;
|
|
511
|
+
protected processPutProperty(response: AxiosResponse): Promise<string>;
|
|
512
|
+
/**
|
|
513
|
+
* Create a property. If a property with the same unique identifier already exists, the existing property will be updated.
|
|
514
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
515
|
+
* @param body (optional) The property data to create or update.
|
|
516
|
+
* @return Property created or updated. Returns the property ID.
|
|
517
|
+
*/
|
|
518
|
+
postProperty(x_Workspace_ID: string, body?: CreatePropertyRequest | undefined, cancelToken?: CancelToken): Promise<string>;
|
|
519
|
+
protected processPostProperty(response: AxiosResponse): Promise<string>;
|
|
520
|
+
/**
|
|
521
|
+
* Delete a property.
|
|
522
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
523
|
+
* @param body (optional) The property to delete (by PropertyId or ExternalId).
|
|
524
|
+
* @return Property deleted.
|
|
525
|
+
*/
|
|
526
|
+
deleteProperty(x_Workspace_ID: string, body?: DeletePropertyRequest | undefined, cancelToken?: CancelToken): Promise<string>;
|
|
527
|
+
protected processDeleteProperty(response: AxiosResponse): Promise<string>;
|
|
528
|
+
/**
|
|
529
|
+
* Apply a single set of values to many properties in one request.
|
|
530
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
531
|
+
* @param body (optional) Targets and the values to apply to each.
|
|
532
|
+
* @return Batch processed. Inspect each `result.status` for individual outcomes.
|
|
533
|
+
*/
|
|
534
|
+
batchUpdateProperties(x_Workspace_ID: string, body?: BatchUpdatePropertyRequest | undefined, cancelToken?: CancelToken): Promise<BatchUpdatePropertyResponse>;
|
|
535
|
+
protected processBatchUpdateProperties(response: AxiosResponse): Promise<BatchUpdatePropertyResponse>;
|
|
536
|
+
/**
|
|
537
|
+
* Get a list of all properties and their data.
|
|
538
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
539
|
+
* @param body (optional) Filter and pagination options.
|
|
540
|
+
* @return Paginated list of properties.
|
|
541
|
+
*/
|
|
542
|
+
queryProperties(x_Workspace_ID: string, body?: PropertyQueryRequest | undefined, cancelToken?: CancelToken): Promise<PropertyListResponse>;
|
|
543
|
+
protected processQueryProperties(response: AxiosResponse): Promise<PropertyListResponse>;
|
|
544
|
+
/**
|
|
545
|
+
* Generates a URL to be returned to the customer where a token is attached.
|
|
546
|
+
* @param propertyId The property's Realforce ID.
|
|
547
|
+
* @param emailAddress The email address of the seller.
|
|
548
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
549
|
+
* @return Returns the invite URL.
|
|
550
|
+
*/
|
|
551
|
+
postInviteSeller(propertyId: string, emailAddress: string, x_Workspace_ID: string, cancelToken?: CancelToken): Promise<InvitedSellerResponse>;
|
|
552
|
+
protected processPostInviteSeller(response: AxiosResponse): Promise<InvitedSellerResponse>;
|
|
553
|
+
/**
|
|
554
|
+
* List all triggers configured for the current workspace.
|
|
555
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
556
|
+
* @return The list of configured triggers.
|
|
557
|
+
*/
|
|
558
|
+
getTriggersForWorkspace(x_Workspace_ID: string, cancelToken?: CancelToken): Promise<TriggerResponse>;
|
|
559
|
+
protected processGetTriggersForWorkspace(response: AxiosResponse): Promise<TriggerResponse>;
|
|
560
|
+
/**
|
|
561
|
+
* Fire a trigger against a resolved subject.
|
|
562
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
563
|
+
* @param body (optional) Subject type, trigger ID, and lookup criteria (subjectId or externalId).
|
|
564
|
+
* @return Trigger fired. Returns the resolved subject and request ID.
|
|
565
|
+
*/
|
|
566
|
+
postTriggerByFilter(x_Workspace_ID: string, body?: TriggerRequest | undefined, cancelToken?: CancelToken): Promise<TriggerByFilterResponse>;
|
|
567
|
+
protected processPostTriggerByFilter(response: AxiosResponse): Promise<TriggerByFilterResponse>;
|
|
568
|
+
/**
|
|
569
|
+
* Get the profile of the authenticated user.
|
|
570
|
+
* @return The user profile.
|
|
571
|
+
*/
|
|
572
|
+
getUserProfile(cancelToken?: CancelToken): Promise<UserProfile>;
|
|
573
|
+
protected processGetUserProfile(response: AxiosResponse): Promise<UserProfile>;
|
|
574
|
+
/**
|
|
575
|
+
* Returns a list of users.
|
|
576
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
577
|
+
* @param body (optional) Filter and pagination options.
|
|
578
|
+
* @return Paginated list of users.
|
|
579
|
+
*/
|
|
580
|
+
queryUsers(x_Workspace_ID: string, body?: UserQueryRequest | undefined, cancelToken?: CancelToken): Promise<UserListResponse>;
|
|
581
|
+
protected processQueryUsers(response: AxiosResponse): Promise<UserListResponse>;
|
|
582
|
+
/**
|
|
583
|
+
* Create a user. If a user with the same email already exists on the workspace, the existing user will be updated.
|
|
584
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
585
|
+
* @param body (optional) The user data to create or update.
|
|
586
|
+
* @return User created or updated. Returns the user ID.
|
|
587
|
+
*/
|
|
588
|
+
postUser(x_Workspace_ID: string, body?: CreateUserRequest | undefined, cancelToken?: CancelToken): Promise<string>;
|
|
589
|
+
protected processPostUser(response: AxiosResponse): Promise<string>;
|
|
590
|
+
/**
|
|
591
|
+
* Get information about the workspace associated with the current API token.
|
|
592
|
+
* @param x_Workspace_ID The workspace ID (GUID) to operate on. Must match one of the workspaces your token has access to.
|
|
593
|
+
* @return The workspace object.
|
|
594
|
+
*/
|
|
595
|
+
getWorkspace(x_Workspace_ID: string, cancelToken?: CancelToken): Promise<Workspace>;
|
|
596
|
+
protected processGetWorkspace(response: AxiosResponse): Promise<Workspace>;
|
|
597
|
+
}
|
|
598
|
+
/** Account model for V2 API. Represents the organizational account a workspace belongs to. */
|
|
599
|
+
export interface Account {
|
|
600
|
+
/** Unique identifier for the account. */
|
|
601
|
+
id: string;
|
|
602
|
+
/** The account's name. */
|
|
603
|
+
name?: string | undefined;
|
|
604
|
+
}
|
|
605
|
+
/** Agent model for V2 API. */
|
|
606
|
+
export interface Agent {
|
|
607
|
+
/** Unique identifier for the agent. */
|
|
608
|
+
id: string;
|
|
609
|
+
/** The agent's full name. */
|
|
610
|
+
name?: string | undefined;
|
|
611
|
+
/** The agent's email address. */
|
|
612
|
+
email?: string | undefined;
|
|
613
|
+
/** The agent's phone number. */
|
|
614
|
+
phone?: string | undefined;
|
|
615
|
+
/** External identifiers from other systems. */
|
|
616
|
+
externalIds?: ExternalId[] | undefined;
|
|
617
|
+
/** Media assets for the agent. */
|
|
618
|
+
media?: MediaModel | undefined;
|
|
619
|
+
/** Agent website landingPage. */
|
|
620
|
+
landingPage?: string | undefined;
|
|
621
|
+
/** Primary profile image or logo URL. */
|
|
622
|
+
profileImage?: MediaModel | undefined;
|
|
623
|
+
/** Logo image URL. */
|
|
624
|
+
logo?: MediaModel | undefined;
|
|
625
|
+
/** List of additional image URLs. */
|
|
626
|
+
images?: MediaModel[] | undefined;
|
|
627
|
+
/** Custom attributes defined by the Workspace. */
|
|
628
|
+
customAttributes?: {
|
|
629
|
+
[key: string]: string;
|
|
630
|
+
} | undefined;
|
|
631
|
+
/** Timestamp information. */
|
|
632
|
+
timestamps?: TimestampsModel | undefined;
|
|
633
|
+
/** The office this agent belongs to. Null when Agent is embedded in another response. */
|
|
634
|
+
office?: Office | undefined;
|
|
635
|
+
}
|
|
636
|
+
/** Agent data */
|
|
637
|
+
export interface AgentData {
|
|
638
|
+
/** Agent email address */
|
|
639
|
+
email: string;
|
|
640
|
+
/** Agent name */
|
|
641
|
+
name: string;
|
|
642
|
+
/** Agent licenseNumber */
|
|
643
|
+
licenseNumber?: string | undefined;
|
|
644
|
+
/** Phone number */
|
|
645
|
+
phoneNumber?: string | undefined;
|
|
646
|
+
/** Id in customer system. */
|
|
647
|
+
externalId?: string | undefined;
|
|
648
|
+
/** List of external identifiers from other systems. */
|
|
649
|
+
externalIds?: ExternalId[] | undefined;
|
|
650
|
+
/** Title */
|
|
651
|
+
jobTitle?: string | undefined;
|
|
652
|
+
/** Agent landing page to redirect to */
|
|
653
|
+
landingPage?: string | undefined;
|
|
654
|
+
/** Longitude of agent used for targeting */
|
|
655
|
+
longitude?: number | undefined;
|
|
656
|
+
/** Latitude of agent used for targeting */
|
|
657
|
+
latitude?: number | undefined;
|
|
658
|
+
/** Agent image */
|
|
659
|
+
imageUrl?: string | undefined;
|
|
660
|
+
/** List of additional attributes */
|
|
661
|
+
additionalAttributes?: {
|
|
662
|
+
[key: string]: string;
|
|
663
|
+
} | undefined;
|
|
664
|
+
/** List of urls to additional images */
|
|
665
|
+
additionalImages?: {
|
|
666
|
+
[key: string]: string;
|
|
667
|
+
} | undefined;
|
|
668
|
+
}
|
|
669
|
+
/** Filter criteria for listing agents. */
|
|
670
|
+
export interface AgentFilter {
|
|
671
|
+
/** Filter by external ID (exact match). */
|
|
672
|
+
externalId?: string | undefined;
|
|
673
|
+
/** Filter by email address (exact match). */
|
|
674
|
+
email?: string | undefined;
|
|
675
|
+
/** Filter by office ID to get agents belonging to a specific office. */
|
|
676
|
+
officeId?: string | undefined;
|
|
677
|
+
/** Filter by multiple office IDs. */
|
|
678
|
+
officeIds?: string[] | undefined;
|
|
679
|
+
/** Filter by name (exact match). */
|
|
680
|
+
name?: string | undefined;
|
|
681
|
+
/** Free-text search across name and email (partial match, case-insensitive). */
|
|
682
|
+
search?: string | undefined;
|
|
683
|
+
/** Filter by last updated date range. */
|
|
684
|
+
updatedDateRange?: DateRangeFilter | undefined;
|
|
685
|
+
}
|
|
686
|
+
/** Standard list response with pagination, sort, and filter metadata. */
|
|
687
|
+
export interface AgentListResponse {
|
|
688
|
+
/** The list of items for the current page. */
|
|
689
|
+
data: Agent[];
|
|
690
|
+
/** Pagination metadata. */
|
|
691
|
+
pagination: PaginationResponse;
|
|
692
|
+
/** Sort criteria that was applied. Null if no sorting was specified. */
|
|
693
|
+
sort?: SortCriteria[] | undefined;
|
|
694
|
+
/** Filter criteria that was applied. */
|
|
695
|
+
filter?: AgentFilter | undefined;
|
|
696
|
+
}
|
|
697
|
+
/** Query request for agents. */
|
|
698
|
+
export interface AgentQueryRequest {
|
|
699
|
+
/** Sort parameters. */
|
|
700
|
+
sort?: SortRequest | undefined;
|
|
701
|
+
/** Pagination parameters. */
|
|
702
|
+
pagination?: PaginationRequest | undefined;
|
|
703
|
+
/** Filter criteria for this resource. */
|
|
704
|
+
filter?: AgentFilter | undefined;
|
|
705
|
+
}
|
|
706
|
+
/** Standardized error response model for all API errors. */
|
|
707
|
+
export interface ApiError {
|
|
708
|
+
/** Machine-readable error code for programmatic handling. */
|
|
709
|
+
errorCode: string;
|
|
710
|
+
/** Human-readable error message. */
|
|
711
|
+
message: string;
|
|
712
|
+
/** Optional detailed error information or validation errors. */
|
|
713
|
+
details?: {
|
|
714
|
+
[key: string]: string[];
|
|
715
|
+
} | undefined;
|
|
716
|
+
/** Timestamp when the error occurred. */
|
|
717
|
+
timestamp: Date;
|
|
718
|
+
}
|
|
719
|
+
/** The type of file being uploaded as an asset. */
|
|
720
|
+
export declare enum AssetFileType {
|
|
721
|
+
Image = "Image",
|
|
722
|
+
Video = "Video",
|
|
723
|
+
Pdf = "Pdf"
|
|
724
|
+
}
|
|
725
|
+
/** A subject that the asset belongs to. */
|
|
726
|
+
export interface AssetSubject {
|
|
727
|
+
/** The subject's Realforce ID. */
|
|
728
|
+
subjectId: string;
|
|
729
|
+
/** The type of subject (Property, Agent, Office). */
|
|
730
|
+
subjectType: AssetSubjectType;
|
|
731
|
+
}
|
|
732
|
+
/** Subject types that an asset can belong to. */
|
|
733
|
+
export declare enum AssetSubjectType {
|
|
734
|
+
Property = "Property",
|
|
735
|
+
Agent = "Agent",
|
|
736
|
+
Office = "Office"
|
|
737
|
+
}
|
|
738
|
+
/** Batch update request for properties. Applies a single set of values to many properties at once. Targets are listed by Realforce RealforceApiService.Models.BatchUpdatePropertyRequest.Ids, customer RealforceApiService.Models.BatchUpdatePropertyRequest.ExternalIds, or both — references that resolve to the same property are deduplicated. */
|
|
739
|
+
export interface BatchUpdatePropertyRequest {
|
|
740
|
+
/** Realforce IDs to update. */
|
|
741
|
+
ids?: string[] | undefined;
|
|
742
|
+
/** Customer-system IDs to update. */
|
|
743
|
+
externalIds?: string[] | undefined;
|
|
744
|
+
/** The values to apply to every targeted property. */
|
|
745
|
+
update?: BatchUpdatePropertyValues | undefined;
|
|
746
|
+
}
|
|
747
|
+
/** Response from a property batch update. Targets that resolved to the same property are deduplicated — the same Realforce property never appears twice in RealforceApiService.Models.BatchUpdatePropertyResponse.Results. Per-item failures (lookup misses, service errors) are reported in RealforceApiService.Models.BatchUpdatePropertyResult.Error and do not fail the batch — the overall HTTP status is 200 as long as the request shape was valid. */
|
|
748
|
+
export interface BatchUpdatePropertyResponse {
|
|
749
|
+
/** One entry per unique property processed, plus one entry per unresolved id or externalId. */
|
|
750
|
+
results?: BatchUpdatePropertyResult[];
|
|
751
|
+
/** Aggregate counts for the batch. */
|
|
752
|
+
summary: BatchUpdatePropertySummary;
|
|
753
|
+
}
|
|
754
|
+
/** Outcome for a single property in a batch update. */
|
|
755
|
+
export interface BatchUpdatePropertyResult {
|
|
756
|
+
/** The Realforce property ID this result is about. Null only when the customer
|
|
757
|
+
supplied an RealforceApiService.Models.BatchUpdatePropertyResult.ExternalId that did not resolve to any property. */
|
|
758
|
+
propertyId?: string | undefined;
|
|
759
|
+
/** Echo of the externalId the customer supplied for this property, when applicable. */
|
|
760
|
+
externalId?: string | undefined;
|
|
761
|
+
/** Either `"updated"` or `"failed"`. */
|
|
762
|
+
status: string;
|
|
763
|
+
/** Populated only when RealforceApiService.Models.BatchUpdatePropertyResult.Status is `"failed"`. */
|
|
764
|
+
error?: ApiError | undefined;
|
|
765
|
+
}
|
|
766
|
+
/** Aggregate counts for a property batch update. */
|
|
767
|
+
export interface BatchUpdatePropertySummary {
|
|
768
|
+
/** Total number of unique results returned. */
|
|
769
|
+
total: number;
|
|
770
|
+
/** Number of properties updated successfully. */
|
|
771
|
+
succeeded: number;
|
|
772
|
+
/** Number of failures (unresolved targets or service errors). */
|
|
773
|
+
failed: number;
|
|
774
|
+
}
|
|
775
|
+
/** The values applied to every property in a batch update. Only fields that are set are changed. Identifier fields (`id`, `externalId`) cannot be changed via batch update — use the single-property endpoint for that. */
|
|
776
|
+
export interface BatchUpdatePropertyValues {
|
|
777
|
+
/** Status of the property. */
|
|
778
|
+
propertyStatus?: PropertyStatus | undefined;
|
|
779
|
+
/** Office name where the property is listed. */
|
|
780
|
+
office?: string | undefined;
|
|
781
|
+
/** Office ID in the customer system. */
|
|
782
|
+
externalOfficeId?: string | undefined;
|
|
783
|
+
/** Agent ID in the Realforce system. */
|
|
784
|
+
agentId?: string | undefined;
|
|
785
|
+
/** Agent email. */
|
|
786
|
+
agentEmail?: string | undefined;
|
|
787
|
+
/** Agent ID in the customer system. */
|
|
788
|
+
externalAgentId?: string | undefined;
|
|
789
|
+
/** Additional agents to add by email. */
|
|
790
|
+
additionalAgentsEmails?: string[] | undefined;
|
|
791
|
+
/** Additional agents to add by external ID. */
|
|
792
|
+
additionalAgentsExternalIds?: string[] | undefined;
|
|
793
|
+
/** Property street address. */
|
|
794
|
+
street?: string | undefined;
|
|
795
|
+
/** Property city. */
|
|
796
|
+
city?: string | undefined;
|
|
797
|
+
/** Property postal code. */
|
|
798
|
+
postCode?: string | undefined;
|
|
799
|
+
/** City area where the property is located. */
|
|
800
|
+
area?: string | undefined;
|
|
801
|
+
/** Property URL. */
|
|
802
|
+
propertyUrl?: string | undefined;
|
|
803
|
+
/** Longitude used for targeting. */
|
|
804
|
+
longitude?: number | undefined;
|
|
805
|
+
/** Latitude used for targeting. */
|
|
806
|
+
latitude?: number | undefined;
|
|
807
|
+
/** List of URLs to images. */
|
|
808
|
+
images?: string[] | undefined;
|
|
809
|
+
/** Main image to use. Falls back to the first image in RealforceApiService.Models.BatchUpdatePropertyValues.Images. */
|
|
810
|
+
mainImage?: string | undefined;
|
|
811
|
+
/** Shorter property description. */
|
|
812
|
+
propertyHeadline?: string | undefined;
|
|
813
|
+
/** The full property description. */
|
|
814
|
+
propertyDescription?: string | undefined;
|
|
815
|
+
/** Type of property. */
|
|
816
|
+
homeType?: string | undefined;
|
|
817
|
+
/** Type of transaction the property is intended for (sale, rent). */
|
|
818
|
+
transactionType?: string | undefined;
|
|
819
|
+
/** Size of property in square meters. */
|
|
820
|
+
areaSquareMeters?: number | undefined;
|
|
821
|
+
/** Number of rooms. */
|
|
822
|
+
numberOfRooms?: number | undefined;
|
|
823
|
+
/** Number of bedrooms. */
|
|
824
|
+
numberOfBedrooms?: number | undefined;
|
|
825
|
+
/** Number of bathrooms. */
|
|
826
|
+
numberOfBathRooms?: number | undefined;
|
|
827
|
+
/** Number of parking spots. */
|
|
828
|
+
numberOfParking?: number | undefined;
|
|
829
|
+
/** Asking price. */
|
|
830
|
+
askingPrice?: number | undefined;
|
|
831
|
+
/** Custom data that can be used for triggering ads. */
|
|
832
|
+
customAttributes?: {
|
|
833
|
+
[key: string]: string;
|
|
834
|
+
} | undefined;
|
|
835
|
+
/** List of events occurring on the property. */
|
|
836
|
+
propertyEvents?: PropertyEventTime[] | undefined;
|
|
837
|
+
/** Additional property landing page. */
|
|
838
|
+
additionalLandingPage?: string | undefined;
|
|
839
|
+
/** Sold price. */
|
|
840
|
+
soldPrice?: number | undefined;
|
|
841
|
+
/** Currency in which the property was sold. */
|
|
842
|
+
soldCurrency?: string | undefined;
|
|
843
|
+
/** The source feed name of the property. */
|
|
844
|
+
sourceName?: string | undefined;
|
|
845
|
+
}
|
|
846
|
+
/** Campaign model. */
|
|
847
|
+
export interface Campaign {
|
|
848
|
+
/** Unique identifier for the campaign. */
|
|
849
|
+
id: string;
|
|
850
|
+
/** The campaign's name. */
|
|
851
|
+
name?: string | undefined;
|
|
852
|
+
/** Status of the campaign. */
|
|
853
|
+
status?: string | undefined;
|
|
854
|
+
/** Type of campaign (e.g., "facebook", "displayAd", "custom"). */
|
|
855
|
+
type?: string | undefined;
|
|
856
|
+
/** Campaign date range (start and end dates). */
|
|
857
|
+
dateRange?: DateRangeModel | undefined;
|
|
858
|
+
/** Budget allocated for the campaign. */
|
|
859
|
+
budget?: MoneyModel | undefined;
|
|
860
|
+
/** Amount spent so far. */
|
|
861
|
+
spent?: MoneyModel | undefined;
|
|
862
|
+
/** Campaign performance statistics. */
|
|
863
|
+
statistics?: CampaignStatisticsModel | undefined;
|
|
864
|
+
/** Urls associated with the campaign. */
|
|
865
|
+
campaignUrls?: CampaignUrlModel[] | undefined;
|
|
866
|
+
/** Name of the Marketing activity which triggered the campaign */
|
|
867
|
+
marketingActivityName?: string | undefined;
|
|
868
|
+
/** External identifiers from other systems. */
|
|
869
|
+
externalIds?: ExternalId[] | undefined;
|
|
870
|
+
/** Custom attributes defined by the Workspace. */
|
|
871
|
+
customAttributes?: {
|
|
872
|
+
[key: string]: any;
|
|
873
|
+
} | undefined;
|
|
874
|
+
/** Timestamp information. */
|
|
875
|
+
timestamps?: TimestampsModel | undefined;
|
|
876
|
+
/** The product that created this campaign. Null when Campaign is embedded in another response. */
|
|
877
|
+
product?: Product | undefined;
|
|
878
|
+
/** The property this campaign is for. Null when Campaign is embedded in another response. */
|
|
879
|
+
property?: Property | undefined;
|
|
880
|
+
/** The order that created this campaign. Null when Campaign is embedded in another response. */
|
|
881
|
+
order?: Order | undefined;
|
|
882
|
+
}
|
|
883
|
+
/** Filter criteria for listing campaigns. */
|
|
884
|
+
export interface CampaignFilter {
|
|
885
|
+
/** Filter by campaign types.
|
|
886
|
+
If empty or null, returns all types. */
|
|
887
|
+
types?: CampaignType[] | undefined;
|
|
888
|
+
/** Filter by campaign statuses.
|
|
889
|
+
If empty or null, returns all statuses. */
|
|
890
|
+
statuses?: CampaignStatus[] | undefined;
|
|
891
|
+
/** Filter campaigns whose run window overlaps the given date range.
|
|
892
|
+
A campaign matches when its start is on or before `To` and its end is on or after `From`.
|
|
893
|
+
Campaigns with no recorded end date are not currently matched. */
|
|
894
|
+
dateRange?: DateRangeFilter | undefined;
|
|
895
|
+
/** Filter by the date the campaign was created. */
|
|
896
|
+
createdDateRange?: DateRangeFilter | undefined;
|
|
897
|
+
/** Filter by product ID. */
|
|
898
|
+
productId?: string | undefined;
|
|
899
|
+
/** Filter by property ID to get campaigns for a specific property. */
|
|
900
|
+
propertyId?: string | undefined;
|
|
901
|
+
/** Filter by office ID. */
|
|
902
|
+
officeId?: string | undefined;
|
|
903
|
+
}
|
|
904
|
+
/** Standard list response with pagination, sort, and filter metadata. */
|
|
905
|
+
export interface CampaignListResponse {
|
|
906
|
+
/** The list of items for the current page. */
|
|
907
|
+
data: Campaign[];
|
|
908
|
+
/** Pagination metadata. */
|
|
909
|
+
pagination: PaginationResponse;
|
|
910
|
+
/** Sort criteria that was applied. Null if no sorting was specified. */
|
|
911
|
+
sort?: SortCriteria[] | undefined;
|
|
912
|
+
/** Filter criteria that was applied. */
|
|
913
|
+
filter?: CampaignFilter | undefined;
|
|
914
|
+
}
|
|
915
|
+
/** List request for campaigns. */
|
|
916
|
+
export interface CampaignQueryRequest {
|
|
917
|
+
/** Sort parameters. */
|
|
918
|
+
sort?: SortRequest | undefined;
|
|
919
|
+
/** Pagination parameters. */
|
|
920
|
+
pagination?: PaginationRequest | undefined;
|
|
921
|
+
/** Filter criteria for this resource. */
|
|
922
|
+
filter?: CampaignFilter | undefined;
|
|
923
|
+
}
|
|
924
|
+
/** Campaign performance statistics. */
|
|
925
|
+
export interface CampaignStatisticsModel {
|
|
926
|
+
/** Number of impressions. */
|
|
927
|
+
impressions?: number | undefined;
|
|
928
|
+
/** Number of clicks. */
|
|
929
|
+
clicks?: number | undefined;
|
|
930
|
+
/** Number of conversions. */
|
|
931
|
+
conversions?: number | undefined;
|
|
932
|
+
/** Click frequency. */
|
|
933
|
+
clickFrequency?: number | undefined;
|
|
934
|
+
/** Conversion rate (percentage). */
|
|
935
|
+
conversionRate?: number | undefined;
|
|
936
|
+
/** Campaing Reach. */
|
|
937
|
+
reach?: number | undefined;
|
|
938
|
+
}
|
|
939
|
+
/** Lifecycle status of a campaign. */
|
|
940
|
+
export declare enum CampaignStatus {
|
|
941
|
+
New = "New",
|
|
942
|
+
Creating = "Creating",
|
|
943
|
+
Blocked = "Blocked",
|
|
944
|
+
InReview = "InReview",
|
|
945
|
+
Scheduled = "Scheduled",
|
|
946
|
+
Rejected = "Rejected",
|
|
947
|
+
Active = "Active",
|
|
948
|
+
Stopped = "Stopped",
|
|
949
|
+
Completed = "Completed",
|
|
950
|
+
Unknown = "Unknown"
|
|
951
|
+
}
|
|
952
|
+
/** The broad channel classification of a campaign. */
|
|
953
|
+
export declare enum CampaignType {
|
|
954
|
+
Facebook = "Facebook",
|
|
955
|
+
Display = "Display",
|
|
956
|
+
Custom = "Custom"
|
|
957
|
+
}
|
|
958
|
+
/** A single campaign URL and the channel it was published through. */
|
|
959
|
+
export interface CampaignUrlModel {
|
|
960
|
+
/** The live URL for the campaign creative on the channel. */
|
|
961
|
+
url: string;
|
|
962
|
+
/** The channel/type of campaign this URL belongs to. */
|
|
963
|
+
campaignType?: CampaignUrlType | undefined;
|
|
964
|
+
}
|
|
965
|
+
export declare enum CampaignUrlType {
|
|
966
|
+
Facebook = "Facebook",
|
|
967
|
+
Instagram = "Instagram",
|
|
968
|
+
DisplayAd = "DisplayAd",
|
|
969
|
+
Custom = "Custom"
|
|
970
|
+
}
|
|
971
|
+
/** Response returned after cancelling autopublish for a marketing opportunity. */
|
|
972
|
+
export interface CancelAutopublishResponse {
|
|
973
|
+
/** Human-readable confirmation message. */
|
|
974
|
+
message?: string;
|
|
975
|
+
}
|
|
976
|
+
/** Contact information. */
|
|
977
|
+
export interface ContactModel {
|
|
978
|
+
/** Email address. */
|
|
979
|
+
email?: string | undefined;
|
|
980
|
+
/** Phone number. */
|
|
981
|
+
phone?: string | undefined;
|
|
982
|
+
/** Website URL. */
|
|
983
|
+
website?: string | undefined;
|
|
984
|
+
}
|
|
985
|
+
/** Geographic coordinates. */
|
|
986
|
+
export interface CoordinateModel {
|
|
987
|
+
/** Latitude in decimal degrees. */
|
|
988
|
+
latitude?: number;
|
|
989
|
+
/** Longitude in decimal degrees. */
|
|
990
|
+
longitude?: number;
|
|
991
|
+
}
|
|
992
|
+
/** Request to create an agent */
|
|
993
|
+
export interface CreateAgentRequest {
|
|
994
|
+
/** Agent email address */
|
|
995
|
+
email: string;
|
|
996
|
+
/** Agent name */
|
|
997
|
+
name: string;
|
|
998
|
+
/** Office id. */
|
|
999
|
+
officeId: string;
|
|
1000
|
+
/** Agent licenseNumber */
|
|
1001
|
+
licenseNumber?: string | undefined;
|
|
1002
|
+
/** Phone number */
|
|
1003
|
+
phoneNumber?: string | undefined;
|
|
1004
|
+
/** List of external identifiers from other systems. */
|
|
1005
|
+
externalIds?: ExternalId[] | undefined;
|
|
1006
|
+
/** Title */
|
|
1007
|
+
jobTitle?: string | undefined;
|
|
1008
|
+
/** Agent landing page to redirect to */
|
|
1009
|
+
landingPage?: string | undefined;
|
|
1010
|
+
/** Longitude of agent used for targeting */
|
|
1011
|
+
longitude?: number | undefined;
|
|
1012
|
+
/** Latitude of agent used for targeting */
|
|
1013
|
+
latitude?: number | undefined;
|
|
1014
|
+
/** Agent image */
|
|
1015
|
+
imageUrl?: string | undefined;
|
|
1016
|
+
/** List of additional attributes */
|
|
1017
|
+
additionalAttributes?: {
|
|
1018
|
+
[key: string]: string;
|
|
1019
|
+
} | undefined;
|
|
1020
|
+
/** List of urls to additional images */
|
|
1021
|
+
additionalImages?: {
|
|
1022
|
+
[key: string]: string;
|
|
1023
|
+
} | undefined;
|
|
1024
|
+
}
|
|
1025
|
+
/** Request to create an asset from one or more file URLs. */
|
|
1026
|
+
export interface CreateAssetRequest {
|
|
1027
|
+
/** Display name for the asset. */
|
|
1028
|
+
name: string;
|
|
1029
|
+
/** The source system uploading the asset. */
|
|
1030
|
+
source: string;
|
|
1031
|
+
/** The type of file (Image, Video, Pdf). */
|
|
1032
|
+
fileType: AssetFileType;
|
|
1033
|
+
/** The URLs of the files that make up this asset. At least one is required. */
|
|
1034
|
+
urls: string[];
|
|
1035
|
+
/** The subjects this asset belongs to. At least one is required. */
|
|
1036
|
+
subjects: AssetSubject[];
|
|
1037
|
+
}
|
|
1038
|
+
/** Request to create a property */
|
|
1039
|
+
export interface CreateFullDataRequest {
|
|
1040
|
+
/** Data for creating property */
|
|
1041
|
+
property: PropertyData;
|
|
1042
|
+
/** Data for creating office */
|
|
1043
|
+
office: OfficeData;
|
|
1044
|
+
/** Data for creating agent */
|
|
1045
|
+
agent: AgentData;
|
|
1046
|
+
}
|
|
1047
|
+
/** Response from the full data creation endpoint, containing the IDs of created resources. */
|
|
1048
|
+
export interface CreateFullDataResponse {
|
|
1049
|
+
/** Created property id */
|
|
1050
|
+
propertyId?: string | undefined;
|
|
1051
|
+
/** Created office id */
|
|
1052
|
+
officeId?: string | undefined;
|
|
1053
|
+
/** Created agent id */
|
|
1054
|
+
agentId?: string | undefined;
|
|
1055
|
+
/** Describes the error message, if any, encountered during the creation process */
|
|
1056
|
+
errorMessage?: string | undefined;
|
|
1057
|
+
}
|
|
1058
|
+
/** Request to create a lead for a Property, Agent, or Office */
|
|
1059
|
+
export interface CreateLeadRequest {
|
|
1060
|
+
/** Type of lead: Property, Agent, or Office */
|
|
1061
|
+
leadType: LeadSubjectType;
|
|
1062
|
+
/** SubjectId in the Realforce system (Requires at least one of: subjectId, externalId) */
|
|
1063
|
+
subjectId?: string | undefined;
|
|
1064
|
+
/** External Id in customer system (alternative to using PropertyId, AgentId, or OfficeId) (Requires at least one of: subjectId, externalId) */
|
|
1065
|
+
externalId?: string | undefined;
|
|
1066
|
+
/** External Lead Id from customer system to track the lead */
|
|
1067
|
+
externalLeadId?: string | undefined;
|
|
1068
|
+
/** Source of the lead (e.g., Api, Facebook, Google, etc.) */
|
|
1069
|
+
leadSource: LeadSource;
|
|
1070
|
+
/** External Campaign Id to tie Lead to Meta or Google campaign (needs to be in the Realforce system) */
|
|
1071
|
+
externalCampaignId?: string | undefined;
|
|
1072
|
+
/** URL associated with the lead */
|
|
1073
|
+
url?: string | undefined;
|
|
1074
|
+
/** First name of the lead */
|
|
1075
|
+
firstName?: string | undefined;
|
|
1076
|
+
/** Last name of the lead */
|
|
1077
|
+
lastName?: string | undefined;
|
|
1078
|
+
/** Email address of the lead */
|
|
1079
|
+
email?: string | undefined;
|
|
1080
|
+
/** Phone number of the lead */
|
|
1081
|
+
phoneNumber?: string | undefined;
|
|
1082
|
+
/** Physical address of the lead */
|
|
1083
|
+
address?: string | undefined;
|
|
1084
|
+
/** Postal/ZIP code of the lead */
|
|
1085
|
+
postalCode?: string | undefined;
|
|
1086
|
+
/** Intent or purpose of the lead */
|
|
1087
|
+
intent?: string | undefined;
|
|
1088
|
+
}
|
|
1089
|
+
/** Response returned after a lead is successfully published. */
|
|
1090
|
+
export interface CreateLeadResponse {
|
|
1091
|
+
/** Human-readable confirmation message. */
|
|
1092
|
+
message?: string;
|
|
1093
|
+
}
|
|
1094
|
+
/** Request object for creating a magic link. */
|
|
1095
|
+
export interface CreateMagicLinkRequest {
|
|
1096
|
+
/** The type of the generated link. */
|
|
1097
|
+
type?: MagicLinkType;
|
|
1098
|
+
/** The unique identifier of the magic link type object. MarketingOpportunityId for OrderPages and PropertyId for ResultPages */
|
|
1099
|
+
id?: string;
|
|
1100
|
+
/** The email address connected to the user in the Realforce system. */
|
|
1101
|
+
email?: string;
|
|
1102
|
+
}
|
|
1103
|
+
/** Request to create a property */
|
|
1104
|
+
export interface CreatePropertyRequest {
|
|
1105
|
+
/** Id in customer system. These needs to be unique for each property on the Workspace */
|
|
1106
|
+
externalId: string;
|
|
1107
|
+
/** Office id in the customer system. (Requires at least one of: externalOfficeId, office) */
|
|
1108
|
+
externalOfficeId?: string | undefined;
|
|
1109
|
+
/** Office name where property is listed. (Requires at least one of: externalOfficeId, office) */
|
|
1110
|
+
office?: string | undefined;
|
|
1111
|
+
/** Status of property */
|
|
1112
|
+
propertyStatus?: PropertyStatus;
|
|
1113
|
+
/** Agent email (Requires at least one of: agentEmail, externalAgentId, agentId) */
|
|
1114
|
+
agentEmail?: string | undefined;
|
|
1115
|
+
/** Agent id in customer system (Requires at least one of: agentEmail, externalAgentId, agentId) */
|
|
1116
|
+
externalAgentId?: string | undefined;
|
|
1117
|
+
/** Agent Id in the Realforce system (Requires at least one of: agentEmail, externalAgentId, agentId) */
|
|
1118
|
+
agentId?: string | undefined;
|
|
1119
|
+
/** Property street address */
|
|
1120
|
+
street?: string | undefined;
|
|
1121
|
+
/** Property city */
|
|
1122
|
+
city?: string | undefined;
|
|
1123
|
+
/** Property postal code */
|
|
1124
|
+
postCode?: string | undefined;
|
|
1125
|
+
/** City area where property is located */
|
|
1126
|
+
area?: string | undefined;
|
|
1127
|
+
/** Property url */
|
|
1128
|
+
propertyUrl?: string | undefined;
|
|
1129
|
+
/** Longitude of property used for targeting */
|
|
1130
|
+
longitude?: number | undefined;
|
|
1131
|
+
/** Latitude of property used for targeting */
|
|
1132
|
+
latitude?: number | undefined;
|
|
1133
|
+
/** List of urls to images */
|
|
1134
|
+
images?: string[] | undefined;
|
|
1135
|
+
/** Main image to use. If empty first image in Images will be used */
|
|
1136
|
+
mainImage?: string | undefined;
|
|
1137
|
+
/** Shorter property description */
|
|
1138
|
+
propertyHeadline?: string | undefined;
|
|
1139
|
+
/** The full property description */
|
|
1140
|
+
propertyDescription?: string | undefined;
|
|
1141
|
+
/** Type of property */
|
|
1142
|
+
homeType?: string | undefined;
|
|
1143
|
+
/** The type of transaction the Property is intended for (sale, rent) */
|
|
1144
|
+
transactionType?: string | undefined;
|
|
1145
|
+
/** Size of property in square meters */
|
|
1146
|
+
areaSquareMeters?: number | undefined;
|
|
1147
|
+
/** Number of rooms */
|
|
1148
|
+
numberOfRooms?: number | undefined;
|
|
1149
|
+
/** Number of bedrooms */
|
|
1150
|
+
numberOfBedrooms?: number | undefined;
|
|
1151
|
+
/** Number of bathrooms */
|
|
1152
|
+
numberOfBathRooms?: number | undefined;
|
|
1153
|
+
/** Number of parking spots */
|
|
1154
|
+
numberOfParking?: number | undefined;
|
|
1155
|
+
/** Asking price */
|
|
1156
|
+
askingPrice?: number | undefined;
|
|
1157
|
+
/** Custom data that can be used for triggering ads */
|
|
1158
|
+
customAttributes?: {
|
|
1159
|
+
[key: string]: string;
|
|
1160
|
+
} | undefined;
|
|
1161
|
+
/** List of events occuring on the property */
|
|
1162
|
+
propertyEvents?: PropertyEventTime[] | undefined;
|
|
1163
|
+
/** Additional property landing page */
|
|
1164
|
+
additionalLandingPage?: string | undefined;
|
|
1165
|
+
/** Additional agents to be added to the property. (Can be added by either email or externalId or a combination) */
|
|
1166
|
+
additionalAgentsEmails?: string[] | undefined;
|
|
1167
|
+
/** Additional agents to be added to the property. (Can be added by either email or externalId or a combination) */
|
|
1168
|
+
additionalAgentsExternalIds?: string[] | undefined;
|
|
1169
|
+
/** Sold price */
|
|
1170
|
+
soldPrice?: number | undefined;
|
|
1171
|
+
/** Currency in which the property was sold */
|
|
1172
|
+
soldCurrency?: string | undefined;
|
|
1173
|
+
/** The source feed name of the property. Can be used to keep track of properties available on multiple feeds. */
|
|
1174
|
+
sourceName?: string | undefined;
|
|
1175
|
+
}
|
|
1176
|
+
/** Request to create a User */
|
|
1177
|
+
export interface CreateUserRequest {
|
|
1178
|
+
/** User email address */
|
|
1179
|
+
email: string;
|
|
1180
|
+
/** User full name */
|
|
1181
|
+
name: string;
|
|
1182
|
+
/** User Role. */
|
|
1183
|
+
role: UserRole;
|
|
1184
|
+
/** Phone number */
|
|
1185
|
+
phoneNumber?: string | undefined;
|
|
1186
|
+
/** User Offices. */
|
|
1187
|
+
officeIds?: string[] | undefined;
|
|
1188
|
+
/** User Workspaces. */
|
|
1189
|
+
workspaceIds?: string[] | undefined;
|
|
1190
|
+
/** Id in customer system. */
|
|
1191
|
+
externalId?: string | undefined;
|
|
1192
|
+
/** List of external identifiers from other systems. */
|
|
1193
|
+
externalIds?: ExternalId[] | undefined;
|
|
1194
|
+
/** Custom attributes for the user. */
|
|
1195
|
+
customAttributes?: {
|
|
1196
|
+
[key: string]: any;
|
|
1197
|
+
} | undefined;
|
|
1198
|
+
/** User profile image URL. */
|
|
1199
|
+
imageUrl?: string | undefined;
|
|
1200
|
+
}
|
|
1201
|
+
/** Filter for date ranges with optional start and end dates. */
|
|
1202
|
+
export interface DateRangeFilter {
|
|
1203
|
+
/** Start date (inclusive). If null, no lower bound is applied. */
|
|
1204
|
+
from?: Date | undefined;
|
|
1205
|
+
/** End date (inclusive). If null, no upper bound is applied. */
|
|
1206
|
+
to?: Date | undefined;
|
|
1207
|
+
}
|
|
1208
|
+
/** A date/time range with start and end. */
|
|
1209
|
+
export interface DateRangeModel {
|
|
1210
|
+
/** Start date/time. */
|
|
1211
|
+
start?: Date | undefined;
|
|
1212
|
+
/** End date/time. */
|
|
1213
|
+
end?: Date | undefined;
|
|
1214
|
+
}
|
|
1215
|
+
/** Request to delete an agent. Provide at least one identifier (AgentId, ExternalId, or Email). */
|
|
1216
|
+
export interface DeleteAgentRequest {
|
|
1217
|
+
/** Agent email address (Requires at least one of: agentId, externalId, email) */
|
|
1218
|
+
email?: string | undefined;
|
|
1219
|
+
/** Agent id in Realforce system (Requires at least one of: agentId, externalId, email) */
|
|
1220
|
+
agentId?: string | undefined;
|
|
1221
|
+
/** Id in customer system. (Requires at least one of: agentId, externalId, email) */
|
|
1222
|
+
externalId?: string | undefined;
|
|
1223
|
+
}
|
|
1224
|
+
/** Request to delete an office */
|
|
1225
|
+
export interface DeleteOfficeRequest {
|
|
1226
|
+
/** Office id in Realforce system (Requires at least one of: officeId, externalId) */
|
|
1227
|
+
officeId?: string | undefined;
|
|
1228
|
+
/** Id in customer system. (Requires at least one of: officeId, externalId) */
|
|
1229
|
+
externalId?: string | undefined;
|
|
1230
|
+
}
|
|
1231
|
+
/** Request to delete a property */
|
|
1232
|
+
export interface DeletePropertyRequest {
|
|
1233
|
+
/** Property id in Realforce system (Requires at least one of: propertyId, externalId) */
|
|
1234
|
+
propertyId?: string | undefined;
|
|
1235
|
+
/** Id in customer system. (Requires at least one of: propertyId, externalId) */
|
|
1236
|
+
externalId?: string | undefined;
|
|
1237
|
+
}
|
|
1238
|
+
/** Type of event occuring */
|
|
1239
|
+
export declare enum EventTimeType {
|
|
1240
|
+
OpenHouse = "OpenHouse",
|
|
1241
|
+
AddedInErp = "AddedInErp",
|
|
1242
|
+
Sold = "Sold",
|
|
1243
|
+
Unknown = "Unknown",
|
|
1244
|
+
Auction = "Auction",
|
|
1245
|
+
Start = "Start",
|
|
1246
|
+
Listed = "Listed",
|
|
1247
|
+
FirstListed = "FirstListed"
|
|
1248
|
+
}
|
|
1249
|
+
/** Represents an external identifier with its type. */
|
|
1250
|
+
export interface ExternalId {
|
|
1251
|
+
/** The external identifier value. */
|
|
1252
|
+
id: string;
|
|
1253
|
+
/** The type/source of the external identifier (e.g., "crm", "mls", "legacy"). */
|
|
1254
|
+
type: string;
|
|
1255
|
+
/** Indicates whether this is the primary external id of the property. */
|
|
1256
|
+
isPrimary: boolean;
|
|
1257
|
+
}
|
|
1258
|
+
/** Response containing the URL for an invited seller to access the property result page. */
|
|
1259
|
+
export interface InvitedSellerResponse {
|
|
1260
|
+
/** The URL with an attached authentication token for the seller. */
|
|
1261
|
+
url?: string;
|
|
1262
|
+
}
|
|
1263
|
+
export declare enum LeadSource {
|
|
1264
|
+
Portal = "Portal",
|
|
1265
|
+
PriceAlert = "PriceAlert",
|
|
1266
|
+
ArrangeViewing = "ArrangeViewing",
|
|
1267
|
+
SimilarProperties = "SimilarProperties",
|
|
1268
|
+
BookValuation = "BookValuation",
|
|
1269
|
+
StandaloneQualification = "StandaloneQualification",
|
|
1270
|
+
Meta = "Meta",
|
|
1271
|
+
Google = "Google"
|
|
1272
|
+
}
|
|
1273
|
+
/** Type of subject for the lead */
|
|
1274
|
+
export declare enum LeadSubjectType {
|
|
1275
|
+
Property = "Property",
|
|
1276
|
+
Agent = "Agent",
|
|
1277
|
+
Office = "Office"
|
|
1278
|
+
}
|
|
1279
|
+
/** Filter for location-based queries. */
|
|
1280
|
+
export interface LocationFilter {
|
|
1281
|
+
/** Filter by country code (ISO 3166-1 alpha-2). */
|
|
1282
|
+
country?: string | undefined;
|
|
1283
|
+
/** Filter by state/region/province. */
|
|
1284
|
+
state?: string | undefined;
|
|
1285
|
+
/** Filter by city name. */
|
|
1286
|
+
city?: string | undefined;
|
|
1287
|
+
/** Filter by postal/zip code. */
|
|
1288
|
+
zipCode?: string | undefined;
|
|
1289
|
+
}
|
|
1290
|
+
/** Location/address information. */
|
|
1291
|
+
export interface LocationModel {
|
|
1292
|
+
/** Full street address. */
|
|
1293
|
+
address?: string | undefined;
|
|
1294
|
+
/** City name. */
|
|
1295
|
+
city?: string | undefined;
|
|
1296
|
+
/** State, region, or province. */
|
|
1297
|
+
state?: string | undefined;
|
|
1298
|
+
/** Postal or ZIP code. */
|
|
1299
|
+
postalCode?: string | undefined;
|
|
1300
|
+
/** Country name or ISO code. */
|
|
1301
|
+
country?: string | undefined;
|
|
1302
|
+
/** Area or neighborhood name. */
|
|
1303
|
+
area?: string | undefined;
|
|
1304
|
+
/** Geographic coordinates. */
|
|
1305
|
+
coordinates?: CoordinateModel | undefined;
|
|
1306
|
+
}
|
|
1307
|
+
/** Response object for returning a created magic link. */
|
|
1308
|
+
export interface MagicLinkResponse {
|
|
1309
|
+
/** The generated magic link URL. */
|
|
1310
|
+
magicLink?: string;
|
|
1311
|
+
}
|
|
1312
|
+
/** The kind of destination a magic link resolves to. */
|
|
1313
|
+
export declare enum MagicLinkType {
|
|
1314
|
+
OrderPage = "OrderPage",
|
|
1315
|
+
ResultPage = "ResultPage",
|
|
1316
|
+
SellerOrderPage = "SellerOrderPage"
|
|
1317
|
+
}
|
|
1318
|
+
/** Marketing opportunity model for V2 API. Represents an instance of a marketing program available for a given subject (property, agent, or office) that can be ordered. */
|
|
1319
|
+
export interface MarketingOpportunity {
|
|
1320
|
+
/** Unique identifier for the marketing opportunity. */
|
|
1321
|
+
id: string;
|
|
1322
|
+
/** The workspace this opportunity belongs to. */
|
|
1323
|
+
workspaceId: string;
|
|
1324
|
+
/** The subject type this opportunity is for (Property, Agent, or Office). */
|
|
1325
|
+
subjectType?: SubjectType;
|
|
1326
|
+
/** The subject ID (the property, agent, or office ID) this opportunity is for. */
|
|
1327
|
+
subjectId: string;
|
|
1328
|
+
/** Name of the program backing this opportunity. */
|
|
1329
|
+
programName?: string | undefined;
|
|
1330
|
+
/** Identifier of the program backing this opportunity. */
|
|
1331
|
+
programId?: string;
|
|
1332
|
+
/** URL to the order page where this opportunity can be purchased. Null if no order page is available. */
|
|
1333
|
+
orderPageUrl?: string | undefined;
|
|
1334
|
+
/** Products available to order within this opportunity. */
|
|
1335
|
+
products?: Product[] | undefined;
|
|
1336
|
+
/** Delay in hours between order placement and publication of the resulting campaign. */
|
|
1337
|
+
publicationDelayInHours?: number;
|
|
1338
|
+
/** How campaigns originating from this opportunity are published
|
|
1339
|
+
(e.g. manual, auto-publish, seller-paid). */
|
|
1340
|
+
publishingMode?: PublishingMode | undefined;
|
|
1341
|
+
}
|
|
1342
|
+
/** Filter criteria for listing marketing opportunities (formerly program instances). */
|
|
1343
|
+
export interface MarketingOpportunityFilter {
|
|
1344
|
+
/** Filter by subject type: Office, Agent, or Property. */
|
|
1345
|
+
subjectType?: MarketingOpportunitySubjectType | undefined;
|
|
1346
|
+
/** Filter by subject ID (the ID of the property, agent, or office). */
|
|
1347
|
+
subjectId?: string | undefined;
|
|
1348
|
+
/** Filter by external subject ID. */
|
|
1349
|
+
externalSubjectId?: string | undefined;
|
|
1350
|
+
/** Filter to only show opportunities (true) or non-opportunities (false).
|
|
1351
|
+
If null, returns both. */
|
|
1352
|
+
isOpportunity?: boolean | undefined;
|
|
1353
|
+
/** Filter by program ID. */
|
|
1354
|
+
programId?: string | undefined;
|
|
1355
|
+
/** Filter to only show running (true) or not-running (false) opportunities.
|
|
1356
|
+
If null, returns both. */
|
|
1357
|
+
isRunning?: boolean | undefined;
|
|
1358
|
+
/** Filter to only show opportunities where the order page is available (true)
|
|
1359
|
+
or unavailable (false). If null, returns both. */
|
|
1360
|
+
orderPageAvailable?: boolean | undefined;
|
|
1361
|
+
/** Filter to only show opportunities of a certain publishing mode. */
|
|
1362
|
+
publishingMode?: PublishingMode | undefined;
|
|
1363
|
+
}
|
|
1364
|
+
/** Standard list response with pagination, sort, and filter metadata. */
|
|
1365
|
+
export interface MarketingOpportunityListResponse {
|
|
1366
|
+
/** The list of items for the current page. */
|
|
1367
|
+
data: MarketingOpportunity[];
|
|
1368
|
+
/** Pagination metadata. */
|
|
1369
|
+
pagination: PaginationResponse;
|
|
1370
|
+
/** Sort criteria that was applied. Null if no sorting was specified. */
|
|
1371
|
+
sort?: SortCriteria[] | undefined;
|
|
1372
|
+
/** Filter criteria that was applied. */
|
|
1373
|
+
filter?: MarketingOpportunityFilter | undefined;
|
|
1374
|
+
}
|
|
1375
|
+
/** Query request for marketing opportunities. */
|
|
1376
|
+
export interface MarketingOpportunityQueryRequest {
|
|
1377
|
+
/** Sort parameters. */
|
|
1378
|
+
sort?: SortRequest | undefined;
|
|
1379
|
+
/** Pagination parameters. */
|
|
1380
|
+
pagination?: PaginationRequest | undefined;
|
|
1381
|
+
/** Filter criteria for this resource. */
|
|
1382
|
+
filter?: MarketingOpportunityFilter | undefined;
|
|
1383
|
+
}
|
|
1384
|
+
/** Subject types that a marketing opportunity can be attached to. */
|
|
1385
|
+
export declare enum MarketingOpportunitySubjectType {
|
|
1386
|
+
Office = "Office",
|
|
1387
|
+
Agent = "Agent",
|
|
1388
|
+
Property = "Property"
|
|
1389
|
+
}
|
|
1390
|
+
/** Media assets associated with a resource. */
|
|
1391
|
+
export interface MediaModel {
|
|
1392
|
+
url: string;
|
|
1393
|
+
}
|
|
1394
|
+
/** Monetary amount with currency. */
|
|
1395
|
+
export interface MoneyModel {
|
|
1396
|
+
/** The amount in the smallest currency unit or as decimal. */
|
|
1397
|
+
amount?: number;
|
|
1398
|
+
/** ISO 4217 currency code (e.g., "USD", "EUR", "SEK"). */
|
|
1399
|
+
currency: string;
|
|
1400
|
+
}
|
|
1401
|
+
/** Office model for V2 API. */
|
|
1402
|
+
export interface Office {
|
|
1403
|
+
/** Unique identifier for the office. */
|
|
1404
|
+
id: string;
|
|
1405
|
+
/** The office's name. */
|
|
1406
|
+
name?: string | undefined;
|
|
1407
|
+
/** Media assets for the office. */
|
|
1408
|
+
images?: MediaModel[] | undefined;
|
|
1409
|
+
/** Location/address of the office. */
|
|
1410
|
+
location?: LocationModel | undefined;
|
|
1411
|
+
/** Contact information for the office. */
|
|
1412
|
+
contact?: ContactModel | undefined;
|
|
1413
|
+
/** External identifiers from other systems. */
|
|
1414
|
+
externalIds?: ExternalId[] | undefined;
|
|
1415
|
+
/** Custom attributes defined by the Workspace. */
|
|
1416
|
+
customAttributes?: {
|
|
1417
|
+
[key: string]: string;
|
|
1418
|
+
} | undefined;
|
|
1419
|
+
/** Timestamp information. */
|
|
1420
|
+
timestamps?: TimestampsModel | undefined;
|
|
1421
|
+
/** The workspace this office belongs to. Null when Office is embedded in another response. */
|
|
1422
|
+
workspace?: Workspace | undefined;
|
|
1423
|
+
}
|
|
1424
|
+
/** Office data */
|
|
1425
|
+
export interface OfficeData {
|
|
1426
|
+
/** Id in customer system. These needs to be unique for each office on the Workspace */
|
|
1427
|
+
externalId: string;
|
|
1428
|
+
/** List of external identifiers from other systems. */
|
|
1429
|
+
externalIds?: ExternalId[] | undefined;
|
|
1430
|
+
/** Name of the office */
|
|
1431
|
+
officeName?: string | undefined;
|
|
1432
|
+
/** Controls if office is active in the platform */
|
|
1433
|
+
active?: boolean | undefined;
|
|
1434
|
+
/** Logo image of the office */
|
|
1435
|
+
logoImageUrl?: string | undefined;
|
|
1436
|
+
/** Primary color in RGB format (e.g. #FFFFFF) */
|
|
1437
|
+
primaryColorInRgb?: string | undefined;
|
|
1438
|
+
/** Home page url of the office */
|
|
1439
|
+
homePageUrl?: string | undefined;
|
|
1440
|
+
/** Address of the office location */
|
|
1441
|
+
address?: string | undefined;
|
|
1442
|
+
/** City of the office location */
|
|
1443
|
+
city?: string | undefined;
|
|
1444
|
+
/** State of the office location */
|
|
1445
|
+
state?: string | undefined;
|
|
1446
|
+
/** Longitude of office */
|
|
1447
|
+
longitude?: number | undefined;
|
|
1448
|
+
/** Latitude of office */
|
|
1449
|
+
latitude?: number | undefined;
|
|
1450
|
+
/** ZipCode of office */
|
|
1451
|
+
zipCode?: string | undefined;
|
|
1452
|
+
/** Contact phone number of the office */
|
|
1453
|
+
contactPhoneNumber?: string | undefined;
|
|
1454
|
+
/** Contact email of the office */
|
|
1455
|
+
contactEmail?: string | undefined;
|
|
1456
|
+
/** List of additional attributes */
|
|
1457
|
+
additionalAttributes?: {
|
|
1458
|
+
[key: string]: string;
|
|
1459
|
+
} | undefined;
|
|
1460
|
+
/** List of urls to additional images */
|
|
1461
|
+
additionalImages?: {
|
|
1462
|
+
[key: string]: string;
|
|
1463
|
+
} | undefined;
|
|
1464
|
+
}
|
|
1465
|
+
/** Filter criteria for listing offices. */
|
|
1466
|
+
export interface OfficeFilter {
|
|
1467
|
+
/** Filter by external ID (exact match). */
|
|
1468
|
+
externalId?: string | undefined;
|
|
1469
|
+
/** Filter by name (exact match). */
|
|
1470
|
+
name?: string | undefined;
|
|
1471
|
+
/** Free-text search across name and city (partial match, case-insensitive). */
|
|
1472
|
+
search?: string | undefined;
|
|
1473
|
+
/** Filter by location criteria. */
|
|
1474
|
+
location?: LocationFilter | undefined;
|
|
1475
|
+
/** Filter by active status.
|
|
1476
|
+
If null, returns all offices regardless of status. */
|
|
1477
|
+
isActive?: boolean | undefined;
|
|
1478
|
+
/** Filter by last updated date range. */
|
|
1479
|
+
updatedDateRange?: DateRangeFilter | undefined;
|
|
1480
|
+
}
|
|
1481
|
+
/** Standard list response with pagination, sort, and filter metadata. */
|
|
1482
|
+
export interface OfficeListResponse {
|
|
1483
|
+
/** The list of items for the current page. */
|
|
1484
|
+
data: Office[];
|
|
1485
|
+
/** Pagination metadata. */
|
|
1486
|
+
pagination: PaginationResponse;
|
|
1487
|
+
/** Sort criteria that was applied. Null if no sorting was specified. */
|
|
1488
|
+
sort?: SortCriteria[] | undefined;
|
|
1489
|
+
/** Filter criteria that was applied. */
|
|
1490
|
+
filter?: OfficeFilter | undefined;
|
|
1491
|
+
}
|
|
1492
|
+
/** Query request for offices. */
|
|
1493
|
+
export interface OfficeQueryRequest {
|
|
1494
|
+
/** Sort parameters. */
|
|
1495
|
+
sort?: SortRequest | undefined;
|
|
1496
|
+
/** Pagination parameters. */
|
|
1497
|
+
pagination?: PaginationRequest | undefined;
|
|
1498
|
+
/** Filter criteria for this resource. */
|
|
1499
|
+
filter?: OfficeFilter | undefined;
|
|
1500
|
+
}
|
|
1501
|
+
/** Order model for V2 API. */
|
|
1502
|
+
export interface Order {
|
|
1503
|
+
/** Unique identifier for the order. */
|
|
1504
|
+
id: string;
|
|
1505
|
+
/** Human-readable order number. */
|
|
1506
|
+
orderNumber?: string | undefined;
|
|
1507
|
+
/** The subject type for this order (e.g., Property, Agent). */
|
|
1508
|
+
subjectType?: SubjectType;
|
|
1509
|
+
/** The subject ID for this order. */
|
|
1510
|
+
subjectId?: string | undefined;
|
|
1511
|
+
/** The program ID this order belongs to. */
|
|
1512
|
+
programId?: string | undefined;
|
|
1513
|
+
/** The program name this order belongs to. */
|
|
1514
|
+
programName?: string | undefined;
|
|
1515
|
+
/** Who pays for the order. */
|
|
1516
|
+
paidBy?: PaidBy;
|
|
1517
|
+
/** Cost center for the order. */
|
|
1518
|
+
costCenter?: string | undefined;
|
|
1519
|
+
/** Total price of the order, calculated as the sum of the line items' product prices. */
|
|
1520
|
+
total?: MoneyModel | undefined;
|
|
1521
|
+
/** Line items in the order. */
|
|
1522
|
+
lineItems?: OrderLineItemModel[] | undefined;
|
|
1523
|
+
/** Payment information. */
|
|
1524
|
+
payment?: PaymentInfoModel | undefined;
|
|
1525
|
+
/** External identifiers from other systems. */
|
|
1526
|
+
externalIds?: ExternalId[] | undefined;
|
|
1527
|
+
/** Custom attributes defined by the Workspace. */
|
|
1528
|
+
customAttributes?: {
|
|
1529
|
+
[key: string]: any;
|
|
1530
|
+
} | undefined;
|
|
1531
|
+
/** Timestamp information. */
|
|
1532
|
+
timestamps?: TimestampsModel | undefined;
|
|
1533
|
+
/** The property this order is for. Null when Order is embedded in another response. */
|
|
1534
|
+
property?: Property | undefined;
|
|
1535
|
+
/** The agent associated with the order. Null when Order is embedded in another response. */
|
|
1536
|
+
agent?: Agent | undefined;
|
|
1537
|
+
/** The office the order belongs to. Null when Order is embedded in another response. */
|
|
1538
|
+
office?: Office | undefined;
|
|
1539
|
+
/** The user who originated/placed the order. */
|
|
1540
|
+
originator?: User | undefined;
|
|
1541
|
+
}
|
|
1542
|
+
/** Filter criteria for listing orders. */
|
|
1543
|
+
export interface OrderFilter {
|
|
1544
|
+
/** Filter by property ID. */
|
|
1545
|
+
propertyId?: string | undefined;
|
|
1546
|
+
/** Filter by office ID. */
|
|
1547
|
+
officeId?: string | undefined;
|
|
1548
|
+
/** Filter by user ID who created the order. */
|
|
1549
|
+
userId?: string | undefined;
|
|
1550
|
+
/** Filter by marketing opportunity ID. */
|
|
1551
|
+
marketingOpportunityId?: string | undefined;
|
|
1552
|
+
/** Filter by product ID. */
|
|
1553
|
+
productId?: string | undefined;
|
|
1554
|
+
/** Filter by order creation date range. */
|
|
1555
|
+
createdDateRange?: DateRangeFilter | undefined;
|
|
1556
|
+
/** Filter by price range. */
|
|
1557
|
+
priceRange?: PriceRangeFilter | undefined;
|
|
1558
|
+
}
|
|
1559
|
+
/** A line item in an order. */
|
|
1560
|
+
export interface OrderLineItemModel {
|
|
1561
|
+
/** The product for this line item. */
|
|
1562
|
+
product?: Product | undefined;
|
|
1563
|
+
/** Total price for this line item. */
|
|
1564
|
+
total?: MoneyModel | undefined;
|
|
1565
|
+
}
|
|
1566
|
+
/** Standard list response with pagination, sort, and filter metadata. */
|
|
1567
|
+
export interface OrderListResponse {
|
|
1568
|
+
/** The list of items for the current page. */
|
|
1569
|
+
data: Order[];
|
|
1570
|
+
/** Pagination metadata. */
|
|
1571
|
+
pagination: PaginationResponse;
|
|
1572
|
+
/** Sort criteria that was applied. Null if no sorting was specified. */
|
|
1573
|
+
sort?: SortCriteria[] | undefined;
|
|
1574
|
+
/** Filter criteria that was applied. */
|
|
1575
|
+
filter?: OrderFilter | undefined;
|
|
1576
|
+
}
|
|
1577
|
+
/** Query request for orders. */
|
|
1578
|
+
export interface OrderQueryRequest {
|
|
1579
|
+
/** Sort parameters. */
|
|
1580
|
+
sort?: SortRequest | undefined;
|
|
1581
|
+
/** Pagination parameters. */
|
|
1582
|
+
pagination?: PaginationRequest | undefined;
|
|
1583
|
+
/** Filter criteria for this resource. */
|
|
1584
|
+
filter?: OrderFilter | undefined;
|
|
1585
|
+
}
|
|
1586
|
+
/** Request to place an order for a product on a marketing opportunity. */
|
|
1587
|
+
export interface OrderRequest {
|
|
1588
|
+
/** The ID of the marketing opportunity to order for. */
|
|
1589
|
+
marketingOpportunityId?: string;
|
|
1590
|
+
/** The ID of the product to order. */
|
|
1591
|
+
productId?: string;
|
|
1592
|
+
}
|
|
1593
|
+
/** Response returned when querying the status of an order. */
|
|
1594
|
+
export interface OrderStatusResponse {
|
|
1595
|
+
/** The current status of the order. */
|
|
1596
|
+
status?: string;
|
|
1597
|
+
}
|
|
1598
|
+
/** Pagination parameters for list requests. Supports two modes: cursor-based (using Cursor) or page-based (using Page). Do not combine both — if Cursor is set, Page is ignored. */
|
|
1599
|
+
export interface PaginationRequest {
|
|
1600
|
+
/** Number of records to return per page. Default is 20, maximum is 1000. */
|
|
1601
|
+
pageSize?: number;
|
|
1602
|
+
/** Opaque cursor for cursor-based pagination (returned as cursor from the previous response).
|
|
1603
|
+
When set, Page is ignored. */
|
|
1604
|
+
cursor?: string | undefined;
|
|
1605
|
+
/** Page number for page-based pagination (1-indexed). Use either Cursor or Page, not both. */
|
|
1606
|
+
page?: number | undefined;
|
|
1607
|
+
}
|
|
1608
|
+
/** Pagination metadata for list responses. */
|
|
1609
|
+
export interface PaginationResponse {
|
|
1610
|
+
/** Total number of items matching the filter criteria. */
|
|
1611
|
+
totalCount?: number | undefined;
|
|
1612
|
+
/** Number of items per page. */
|
|
1613
|
+
pageSize?: number;
|
|
1614
|
+
/** Opaque cursor for the next page of results. Null if this is the last page.
|
|
1615
|
+
Pass this value as cursor in the pagination object of your next request to fetch the next page.
|
|
1616
|
+
Only present when using cursor-based pagination. */
|
|
1617
|
+
cursor?: string | undefined;
|
|
1618
|
+
/** Current page number (1-indexed).
|
|
1619
|
+
Only present when using page-based pagination. */
|
|
1620
|
+
page?: number | undefined;
|
|
1621
|
+
/** Total number of pages available.
|
|
1622
|
+
Only present when using page-based pagination. */
|
|
1623
|
+
totalPages?: number | undefined;
|
|
1624
|
+
}
|
|
1625
|
+
export declare enum PaidBy {
|
|
1626
|
+
Unknown = "Unknown",
|
|
1627
|
+
Hq = "Hq",
|
|
1628
|
+
Office = "Office",
|
|
1629
|
+
Agent = "Agent",
|
|
1630
|
+
Seller = "Seller",
|
|
1631
|
+
Orderer = "Orderer",
|
|
1632
|
+
Account = "Account"
|
|
1633
|
+
}
|
|
1634
|
+
/** Details of a personal access token (without the full token value). */
|
|
1635
|
+
export interface PatResponse {
|
|
1636
|
+
/** The unique identifier of the PAT. */
|
|
1637
|
+
patId?: string;
|
|
1638
|
+
/** The human-readable name of the token. */
|
|
1639
|
+
name?: string;
|
|
1640
|
+
/** The first few characters of the token for identification (e.g. "rfk_abc..."). */
|
|
1641
|
+
tokenPrefix?: string;
|
|
1642
|
+
/** The permission scopes granted to this token. */
|
|
1643
|
+
scopes?: string[];
|
|
1644
|
+
/** When the token was created (UTC). */
|
|
1645
|
+
issuedAt?: Date;
|
|
1646
|
+
/** When the token expires (UTC). */
|
|
1647
|
+
expiresAt?: Date;
|
|
1648
|
+
/** When the token was revoked (UTC), or null if still active. */
|
|
1649
|
+
revokedAt?: Date | undefined;
|
|
1650
|
+
/** When the token was last used for authentication (UTC), or null if never used. */
|
|
1651
|
+
lastUsedAt?: Date | undefined;
|
|
1652
|
+
/** The workspace IDs this token is authorized to access. */
|
|
1653
|
+
workspaceIds?: string[];
|
|
1654
|
+
/** The account IDs this token is authorized to access. Account grants imply access to all workspaces within the account. */
|
|
1655
|
+
accountIds?: string[];
|
|
1656
|
+
}
|
|
1657
|
+
/** Payment information for an order. */
|
|
1658
|
+
export interface PaymentInfoModel {
|
|
1659
|
+
/** Payment status (e.g., "pending", "paid", "failed", "refunded"). */
|
|
1660
|
+
status?: string | undefined;
|
|
1661
|
+
/** Payment method used (e.g., "card", "invoice", "bank_transfer"). */
|
|
1662
|
+
method?: string | undefined;
|
|
1663
|
+
/** When the payment was created. */
|
|
1664
|
+
createdAt?: Date | undefined;
|
|
1665
|
+
/** Whether the payment has been refunded. */
|
|
1666
|
+
refunded?: boolean;
|
|
1667
|
+
/** Tax percentage applied to the payment. */
|
|
1668
|
+
taxPercentage?: number | undefined;
|
|
1669
|
+
/** Tax amount on the payment. */
|
|
1670
|
+
taxAmount?: number | undefined;
|
|
1671
|
+
/** Total amount paid for the order, summed across all payments. */
|
|
1672
|
+
totalPaid?: MoneyModel | undefined;
|
|
1673
|
+
}
|
|
1674
|
+
/** Request to Post an office */
|
|
1675
|
+
export interface PostOfficeRequest {
|
|
1676
|
+
/** Id in customer system. These needs to be unique for each office in the Workspace */
|
|
1677
|
+
externalId: string;
|
|
1678
|
+
/** List of external identifiers from other systems. */
|
|
1679
|
+
externalIds?: ExternalId[] | undefined;
|
|
1680
|
+
/** Name of the office. This field is required when creating a new office, but optional when updating an existing office. */
|
|
1681
|
+
officeName?: string | undefined;
|
|
1682
|
+
/** Controls if office is active in the platform */
|
|
1683
|
+
active?: boolean | undefined;
|
|
1684
|
+
/** Logo image of the office */
|
|
1685
|
+
logoImageUrl?: string | undefined;
|
|
1686
|
+
/** Primary color in RGB format (e.g. #FFFFFF) */
|
|
1687
|
+
primaryColorInRgb?: string | undefined;
|
|
1688
|
+
/** Home page url of the office */
|
|
1689
|
+
homePageUrl?: string | undefined;
|
|
1690
|
+
/** Address of the office location */
|
|
1691
|
+
address?: string | undefined;
|
|
1692
|
+
/** City of the office location */
|
|
1693
|
+
city?: string | undefined;
|
|
1694
|
+
/** State of the office location */
|
|
1695
|
+
state?: string | undefined;
|
|
1696
|
+
/** Longitude of office */
|
|
1697
|
+
longitude?: number | undefined;
|
|
1698
|
+
/** Latitude of office */
|
|
1699
|
+
latitude?: number | undefined;
|
|
1700
|
+
/** ZipCode of office */
|
|
1701
|
+
zipCode?: string | undefined;
|
|
1702
|
+
/** Contact phone number of the office */
|
|
1703
|
+
contactPhoneNumber?: string | undefined;
|
|
1704
|
+
/** Contact email of the office */
|
|
1705
|
+
contactEmail?: string | undefined;
|
|
1706
|
+
/** List of additional attributes */
|
|
1707
|
+
additionalAttributes?: {
|
|
1708
|
+
[key: string]: string;
|
|
1709
|
+
} | undefined;
|
|
1710
|
+
/** List of urls to additional images */
|
|
1711
|
+
additionalImages?: {
|
|
1712
|
+
[key: string]: string;
|
|
1713
|
+
} | undefined;
|
|
1714
|
+
}
|
|
1715
|
+
/** Filter for price ranges with optional min and max values. */
|
|
1716
|
+
export interface PriceRangeFilter {
|
|
1717
|
+
/** Minimum price (inclusive). If null, no lower bound is applied. */
|
|
1718
|
+
min?: number | undefined;
|
|
1719
|
+
/** Maximum price (inclusive). If null, no upper bound is applied. */
|
|
1720
|
+
max?: number | undefined;
|
|
1721
|
+
}
|
|
1722
|
+
/** Product model for V2 API. */
|
|
1723
|
+
export interface Product {
|
|
1724
|
+
/** Unique identifier for the product. */
|
|
1725
|
+
id?: string;
|
|
1726
|
+
/** The product's name. */
|
|
1727
|
+
name?: string | undefined;
|
|
1728
|
+
/** Short description of the product. */
|
|
1729
|
+
description?: string | undefined;
|
|
1730
|
+
/** Is default product on Program. */
|
|
1731
|
+
isDefault?: boolean;
|
|
1732
|
+
/** Product archived at. */
|
|
1733
|
+
archivedAt?: Date | undefined;
|
|
1734
|
+
/** Product is paid by. */
|
|
1735
|
+
paidBy?: PaidBy;
|
|
1736
|
+
/** Price of the product. */
|
|
1737
|
+
price?: MoneyModel | undefined;
|
|
1738
|
+
}
|
|
1739
|
+
/** Filter criteria for listing products. */
|
|
1740
|
+
export interface ProductFilter {
|
|
1741
|
+
/** Include archived products in the results.
|
|
1742
|
+
If null or false, only active products are returned. */
|
|
1743
|
+
includeArchived?: boolean | undefined;
|
|
1744
|
+
/** Filter by product types.
|
|
1745
|
+
If empty or null, returns all types. */
|
|
1746
|
+
types?: string[] | undefined;
|
|
1747
|
+
/** Filter by name (exact match). */
|
|
1748
|
+
name?: string | undefined;
|
|
1749
|
+
/** Free-text search across name and description (partial match, case-insensitive). */
|
|
1750
|
+
search?: string | undefined;
|
|
1751
|
+
/** Filter by price range. */
|
|
1752
|
+
priceRange?: PriceRangeFilter | undefined;
|
|
1753
|
+
/** Filter by who pays for the product. */
|
|
1754
|
+
paidBy?: PaidBy[] | undefined;
|
|
1755
|
+
}
|
|
1756
|
+
/** Standard list response with pagination, sort, and filter metadata. */
|
|
1757
|
+
export interface ProductListResponse {
|
|
1758
|
+
/** The list of items for the current page. */
|
|
1759
|
+
data: Product[];
|
|
1760
|
+
/** Pagination metadata. */
|
|
1761
|
+
pagination: PaginationResponse;
|
|
1762
|
+
/** Sort criteria that was applied. Null if no sorting was specified. */
|
|
1763
|
+
sort?: SortCriteria[] | undefined;
|
|
1764
|
+
/** Filter criteria that was applied. */
|
|
1765
|
+
filter?: ProductFilter | undefined;
|
|
1766
|
+
}
|
|
1767
|
+
/** Query request for products. */
|
|
1768
|
+
export interface ProductQueryRequest {
|
|
1769
|
+
/** Sort parameters. */
|
|
1770
|
+
sort?: SortRequest | undefined;
|
|
1771
|
+
/** Pagination parameters. */
|
|
1772
|
+
pagination?: PaginationRequest | undefined;
|
|
1773
|
+
/** Filter criteria for this resource. */
|
|
1774
|
+
filter?: ProductFilter | undefined;
|
|
1775
|
+
}
|
|
1776
|
+
/** Property model for V2 API. */
|
|
1777
|
+
export interface Property {
|
|
1778
|
+
/** Unique identifier for the property. */
|
|
1779
|
+
id: string;
|
|
1780
|
+
/** Location/address of the property. */
|
|
1781
|
+
location?: LocationModel | undefined;
|
|
1782
|
+
/** Price information for the property. */
|
|
1783
|
+
price?: MoneyModel | undefined;
|
|
1784
|
+
/** Status of the property (e.g., "Available", "Acquired", "Upcoming"). */
|
|
1785
|
+
status?: PropertyStatus | undefined;
|
|
1786
|
+
/** Type of property (e.g., "house", "apartment", "condo"). */
|
|
1787
|
+
propertyType?: string | undefined;
|
|
1788
|
+
/** Property details and specifications. */
|
|
1789
|
+
details?: PropertyDetailsModel | undefined;
|
|
1790
|
+
/** Images for the property. */
|
|
1791
|
+
images?: MediaModel[] | undefined;
|
|
1792
|
+
/** Url to property landingpage. */
|
|
1793
|
+
propertyPageUrl?: string | undefined;
|
|
1794
|
+
/** Url to property order page. */
|
|
1795
|
+
orderPageUrl?: string | undefined;
|
|
1796
|
+
/** Url to property result page. */
|
|
1797
|
+
resultPageUrl?: string | undefined;
|
|
1798
|
+
/** External identifiers from other systems. */
|
|
1799
|
+
externalIds?: ExternalId[] | undefined;
|
|
1800
|
+
/** Custom attributes defined by the Workspace. */
|
|
1801
|
+
customAttributes?: {
|
|
1802
|
+
[key: string]: string[];
|
|
1803
|
+
} | undefined;
|
|
1804
|
+
/** Amount of vistors on the property website. */
|
|
1805
|
+
visitorCounts?: VisitorCount[] | undefined;
|
|
1806
|
+
/** Timestamp information. */
|
|
1807
|
+
timestamps?: TimestampsModel | undefined;
|
|
1808
|
+
/** The agent handling this property. Null when Property is embedded in another response. */
|
|
1809
|
+
agent?: Agent | undefined;
|
|
1810
|
+
/** The office handling this property. Null when Property is embedded in another response. */
|
|
1811
|
+
office?: Office | undefined;
|
|
1812
|
+
/** List of campaigns started on the property. Null when Property is embedded in another response. */
|
|
1813
|
+
campaigns?: Campaign[] | undefined;
|
|
1814
|
+
}
|
|
1815
|
+
/** Property data */
|
|
1816
|
+
export interface PropertyData {
|
|
1817
|
+
/** Id in customer system. These needs to be unique for each property on the Workspace */
|
|
1818
|
+
externalId: string;
|
|
1819
|
+
/** Status of property */
|
|
1820
|
+
propertyStatus?: PropertyStatus;
|
|
1821
|
+
/** Property street address */
|
|
1822
|
+
street?: string | undefined;
|
|
1823
|
+
/** Property city */
|
|
1824
|
+
city?: string | undefined;
|
|
1825
|
+
/** Property postal code */
|
|
1826
|
+
postCode?: string | undefined;
|
|
1827
|
+
/** City area where property is located */
|
|
1828
|
+
area?: string | undefined;
|
|
1829
|
+
/** Property url */
|
|
1830
|
+
propertyUrl?: string | undefined;
|
|
1831
|
+
/** Longitude of property used for targeting */
|
|
1832
|
+
longitude?: number | undefined;
|
|
1833
|
+
/** Latitude of property used for targeting */
|
|
1834
|
+
latitude?: number | undefined;
|
|
1835
|
+
/** List of urls to images */
|
|
1836
|
+
images?: string[] | undefined;
|
|
1837
|
+
/** Main image to use. If empty first image in Images will be used */
|
|
1838
|
+
mainImage?: string | undefined;
|
|
1839
|
+
/** Shorter property description */
|
|
1840
|
+
propertyHeadline?: string | undefined;
|
|
1841
|
+
/** The full property description */
|
|
1842
|
+
propertyDescription?: string | undefined;
|
|
1843
|
+
/** Type of property */
|
|
1844
|
+
homeType?: string | undefined;
|
|
1845
|
+
/** The type of transaction the Property is intended for (sale, rent) */
|
|
1846
|
+
transactionType?: string | undefined;
|
|
1847
|
+
/** Size of property in square meters */
|
|
1848
|
+
areaSquareMeters?: number | undefined;
|
|
1849
|
+
/** Number of rooms */
|
|
1850
|
+
numberOfRooms?: number | undefined;
|
|
1851
|
+
/** Number of bedrooms */
|
|
1852
|
+
numberOfBedrooms?: number | undefined;
|
|
1853
|
+
/** Number of bathrooms */
|
|
1854
|
+
numberOfBathRooms?: number | undefined;
|
|
1855
|
+
/** Number of parking spots */
|
|
1856
|
+
numberOfParking?: number | undefined;
|
|
1857
|
+
/** Asking price */
|
|
1858
|
+
askingPrice?: number | undefined;
|
|
1859
|
+
/** Custom data that can be used for triggering ads */
|
|
1860
|
+
customAttributes?: {
|
|
1861
|
+
[key: string]: string;
|
|
1862
|
+
} | undefined;
|
|
1863
|
+
/** List of events occuring on the property */
|
|
1864
|
+
propertyEvents?: PropertyEventTime[] | undefined;
|
|
1865
|
+
/** Additional property landing page */
|
|
1866
|
+
additionalLandingPage?: string | undefined;
|
|
1867
|
+
/** Sold price */
|
|
1868
|
+
soldPrice?: number | undefined;
|
|
1869
|
+
/** Sold currency */
|
|
1870
|
+
soldCurrency?: string | undefined;
|
|
1871
|
+
/** The source feed name of the property. Can be used to keep track of properties available on multiple feeds. */
|
|
1872
|
+
sourceName?: string | undefined;
|
|
1873
|
+
}
|
|
1874
|
+
/** Detailed specifications for a property. */
|
|
1875
|
+
export interface PropertyDetailsModel {
|
|
1876
|
+
/** Number of bedrooms. */
|
|
1877
|
+
bedrooms?: number | undefined;
|
|
1878
|
+
/** Number of bathrooms. */
|
|
1879
|
+
bathrooms?: number | undefined;
|
|
1880
|
+
/** Total living area in square meters or feet. */
|
|
1881
|
+
livingArea?: number | undefined;
|
|
1882
|
+
/** Total lot/land size. */
|
|
1883
|
+
lotSize?: number | undefined;
|
|
1884
|
+
/** Unit of measurement for area (e.g., "sqm", "sqft"). */
|
|
1885
|
+
areaUnit?: string | undefined;
|
|
1886
|
+
/** Year the property was built. */
|
|
1887
|
+
yearBuilt?: number | undefined;
|
|
1888
|
+
/** Number of floors/stories. */
|
|
1889
|
+
floors?: number | undefined;
|
|
1890
|
+
/** Number of rooms. */
|
|
1891
|
+
rooms?: number | undefined;
|
|
1892
|
+
/** Property description text. */
|
|
1893
|
+
description?: string | undefined;
|
|
1894
|
+
/** List of features/amenities. */
|
|
1895
|
+
features?: string[] | undefined;
|
|
1896
|
+
}
|
|
1897
|
+
/** Event occuring on a property */
|
|
1898
|
+
export interface PropertyEventTime {
|
|
1899
|
+
/** Type of event occuring */
|
|
1900
|
+
eventTimeType?: EventTimeType;
|
|
1901
|
+
/** Event time UTC */
|
|
1902
|
+
eventTimeUtc?: Date;
|
|
1903
|
+
}
|
|
1904
|
+
/** Filter criteria for listing properties. */
|
|
1905
|
+
export interface PropertyFilter {
|
|
1906
|
+
/** Filter by property URL (exact match). */
|
|
1907
|
+
url?: string | undefined;
|
|
1908
|
+
/** Filter by external ID (exact match). */
|
|
1909
|
+
externalId?: string | undefined;
|
|
1910
|
+
/** Filter by office ID. */
|
|
1911
|
+
officeId?: string | undefined;
|
|
1912
|
+
/** Filter by agent ID. */
|
|
1913
|
+
agentId?: string | undefined;
|
|
1914
|
+
/** Filter by property statuses.
|
|
1915
|
+
If empty or null, returns all statuses. */
|
|
1916
|
+
statuses?: PropertyFilterStatus[] | undefined;
|
|
1917
|
+
/** Filter by property types (e.g., "apartment", "house", "condo").
|
|
1918
|
+
If empty or null, returns all types. */
|
|
1919
|
+
propertyTypes?: string[] | undefined;
|
|
1920
|
+
/** Free-text search across headline, description, and address (partial match, case-insensitive). */
|
|
1921
|
+
search?: string | undefined;
|
|
1922
|
+
/** Filter by price range. */
|
|
1923
|
+
priceRange?: PriceRangeFilter | undefined;
|
|
1924
|
+
/** Filter by location criteria. */
|
|
1925
|
+
location?: LocationFilter | undefined;
|
|
1926
|
+
/** Filter by creation date range. */
|
|
1927
|
+
createdDateRange?: DateRangeFilter | undefined;
|
|
1928
|
+
/** Filter by last updated date range. */
|
|
1929
|
+
updatedDateRange?: DateRangeFilter | undefined;
|
|
1930
|
+
}
|
|
1931
|
+
/** Status values accepted when filtering properties. */
|
|
1932
|
+
export declare enum PropertyFilterStatus {
|
|
1933
|
+
Available = "Available",
|
|
1934
|
+
Upcoming = "Upcoming",
|
|
1935
|
+
Removed = "Removed",
|
|
1936
|
+
Acquired = "Acquired",
|
|
1937
|
+
Unpublished = "Unpublished"
|
|
1938
|
+
}
|
|
1939
|
+
/** Standard list response with pagination, sort, and filter metadata. */
|
|
1940
|
+
export interface PropertyListResponse {
|
|
1941
|
+
/** The list of items for the current page. */
|
|
1942
|
+
data: Property[];
|
|
1943
|
+
/** Pagination metadata. */
|
|
1944
|
+
pagination: PaginationResponse;
|
|
1945
|
+
/** Sort criteria that was applied. Null if no sorting was specified. */
|
|
1946
|
+
sort?: SortCriteria[] | undefined;
|
|
1947
|
+
/** Filter criteria that was applied. */
|
|
1948
|
+
filter?: PropertyFilter | undefined;
|
|
1949
|
+
}
|
|
1950
|
+
/** Query request for properties. */
|
|
1951
|
+
export interface PropertyQueryRequest {
|
|
1952
|
+
/** Sort parameters. */
|
|
1953
|
+
sort?: SortRequest | undefined;
|
|
1954
|
+
/** Pagination parameters. */
|
|
1955
|
+
pagination?: PaginationRequest | undefined;
|
|
1956
|
+
/** Filter criteria for this resource. */
|
|
1957
|
+
filter?: PropertyFilter | undefined;
|
|
1958
|
+
}
|
|
1959
|
+
export declare enum PropertyStatus {
|
|
1960
|
+
Unknown = "Unknown",
|
|
1961
|
+
Upcoming = "Upcoming",
|
|
1962
|
+
Available = "Available",
|
|
1963
|
+
Acquired = "Acquired",
|
|
1964
|
+
Removed = "Removed",
|
|
1965
|
+
Unpublished = "Unpublished",
|
|
1966
|
+
ManuallyRemoved = "ManuallyRemoved"
|
|
1967
|
+
}
|
|
1968
|
+
/** Controls how a marketing opportunity is published into a campaign. */
|
|
1969
|
+
export declare enum PublishingMode {
|
|
1970
|
+
Manual = "Manual",
|
|
1971
|
+
PremiumAutoPublish = "PremiumAutoPublish",
|
|
1972
|
+
MachineAutoPublish = "MachineAutoPublish",
|
|
1973
|
+
SellerPaid = "SellerPaid"
|
|
1974
|
+
}
|
|
1975
|
+
/** Request to update an office. All fields are optional — only fields present in the request body are changed. Fields you omit are left as-is on the office. */
|
|
1976
|
+
export interface PutOfficeRequest {
|
|
1977
|
+
/** Id in customer system. This needs to be unique for each office on the Workspace */
|
|
1978
|
+
externalId?: string | undefined;
|
|
1979
|
+
/** List of external identifiers from other systems. */
|
|
1980
|
+
externalIds?: ExternalId[] | undefined;
|
|
1981
|
+
/** Name of the office */
|
|
1982
|
+
officeName?: string | undefined;
|
|
1983
|
+
/** Controls if office is active in the platform */
|
|
1984
|
+
active?: boolean | undefined;
|
|
1985
|
+
/** Logo image of the office */
|
|
1986
|
+
logoImageUrl?: string | undefined;
|
|
1987
|
+
/** Primary color in RGB format (e.g. #FFFFFF) */
|
|
1988
|
+
primaryColorInRgb?: string | undefined;
|
|
1989
|
+
/** Home page url of the office */
|
|
1990
|
+
homePageUrl?: string | undefined;
|
|
1991
|
+
/** Address of the office location */
|
|
1992
|
+
address?: string | undefined;
|
|
1993
|
+
/** City of the office location */
|
|
1994
|
+
city?: string | undefined;
|
|
1995
|
+
/** State of the office location */
|
|
1996
|
+
state?: string | undefined;
|
|
1997
|
+
/** Longitude of office */
|
|
1998
|
+
longitude?: number | undefined;
|
|
1999
|
+
/** Latitude of office */
|
|
2000
|
+
latitude?: number | undefined;
|
|
2001
|
+
/** ZipCode of office */
|
|
2002
|
+
zipCode?: string | undefined;
|
|
2003
|
+
/** Contact phone number of the office */
|
|
2004
|
+
contactPhoneNumber?: string | undefined;
|
|
2005
|
+
/** Contact email of the office */
|
|
2006
|
+
contactEmail?: string | undefined;
|
|
2007
|
+
/** List of additional attributes */
|
|
2008
|
+
additionalAttributes?: {
|
|
2009
|
+
[key: string]: string;
|
|
2010
|
+
} | undefined;
|
|
2011
|
+
/** List of urls to additional images */
|
|
2012
|
+
additionalImages?: {
|
|
2013
|
+
[key: string]: string;
|
|
2014
|
+
} | undefined;
|
|
2015
|
+
}
|
|
2016
|
+
/** Response returned after rotating a personal access token. Contains the new token and grace period info for the old token. */
|
|
2017
|
+
export interface RotatePatResponse {
|
|
2018
|
+
/** The unique identifier of the new PAT. */
|
|
2019
|
+
newPatId?: string;
|
|
2020
|
+
/** The full new token value. This is only returned at rotation time and cannot be retrieved again. */
|
|
2021
|
+
token?: string;
|
|
2022
|
+
/** The human-readable name of the token (inherited from the old token). */
|
|
2023
|
+
name?: string;
|
|
2024
|
+
/** The permission scopes granted to the new token (inherited from the old token). */
|
|
2025
|
+
scopes?: string[];
|
|
2026
|
+
/** The workspace IDs the new token is authorized to access (inherited from the old token). */
|
|
2027
|
+
workspaceIds?: string[];
|
|
2028
|
+
/** The account IDs the new token is authorized to access (inherited from the old token). */
|
|
2029
|
+
accountIds?: string[];
|
|
2030
|
+
/** When the new token expires (UTC). */
|
|
2031
|
+
expiresAt?: Date;
|
|
2032
|
+
/** The unique identifier of the old (rotated) PAT. */
|
|
2033
|
+
oldPatId?: string;
|
|
2034
|
+
/** When the old token will stop working (UTC). There is a short grace period (default 5 minutes) after rotation. */
|
|
2035
|
+
oldPatExpiresAt?: Date;
|
|
2036
|
+
}
|
|
2037
|
+
/** Request to make a marketing opportunity's order page available or unavailable. */
|
|
2038
|
+
export interface SetOrderPageAvailabilityRequest {
|
|
2039
|
+
/** Whether the order page should be available (true) or unavailable (false). */
|
|
2040
|
+
available: boolean;
|
|
2041
|
+
/** Reason the order page is being made unavailable. Recorded for audit purposes.
|
|
2042
|
+
Only meaningful when RealforceApiService.Models.SetOrderPageAvailabilityRequest.Available is false. */
|
|
2043
|
+
unavailableReason?: string | undefined;
|
|
2044
|
+
}
|
|
2045
|
+
/** Response returned after toggling the order page availability of a marketing opportunity. */
|
|
2046
|
+
export interface SetOrderPageAvailabilityResponse {
|
|
2047
|
+
/** Human-readable confirmation message. */
|
|
2048
|
+
message?: string;
|
|
2049
|
+
}
|
|
2050
|
+
/** Sort criteria for a single field. */
|
|
2051
|
+
export interface SortCriteria {
|
|
2052
|
+
/** The field to sort by. */
|
|
2053
|
+
field: string;
|
|
2054
|
+
/** Sort direction: "asc" or "desc". */
|
|
2055
|
+
direction: string;
|
|
2056
|
+
}
|
|
2057
|
+
/** Sort direction for list requests. */
|
|
2058
|
+
export declare enum SortDirection {
|
|
2059
|
+
Asc = "Asc",
|
|
2060
|
+
Desc = "Desc"
|
|
2061
|
+
}
|
|
2062
|
+
/** Standard sort parameters for list requests. */
|
|
2063
|
+
export interface SortRequest {
|
|
2064
|
+
/** Field to sort by. */
|
|
2065
|
+
field?: string | undefined;
|
|
2066
|
+
/** Sort direction. Default is ascending. */
|
|
2067
|
+
direction?: SortDirection;
|
|
2068
|
+
}
|
|
2069
|
+
export declare enum SubjectType {
|
|
2070
|
+
Unknown = "Unknown",
|
|
2071
|
+
Hq = "Hq",
|
|
2072
|
+
Office = "Office",
|
|
2073
|
+
Agent = "Agent",
|
|
2074
|
+
Property = "Property",
|
|
2075
|
+
Account = "Account"
|
|
2076
|
+
}
|
|
2077
|
+
/** Standard timestamp fields for resources. */
|
|
2078
|
+
export interface TimestampsModel {
|
|
2079
|
+
/** When the resource was created. */
|
|
2080
|
+
created?: Date;
|
|
2081
|
+
/** When the resource was last updated. */
|
|
2082
|
+
updated?: Date | undefined;
|
|
2083
|
+
/** Open house */
|
|
2084
|
+
openHouses?: Date[] | undefined;
|
|
2085
|
+
/** Added in Erp system */
|
|
2086
|
+
addedInErp?: Date | undefined;
|
|
2087
|
+
/** Sold date */
|
|
2088
|
+
sold?: Date | undefined;
|
|
2089
|
+
/** Auction date */
|
|
2090
|
+
auction?: Date | undefined;
|
|
2091
|
+
/** Listed date */
|
|
2092
|
+
listed?: Date | undefined;
|
|
2093
|
+
/** First listed date */
|
|
2094
|
+
firstListed?: Date | undefined;
|
|
2095
|
+
}
|
|
2096
|
+
export interface Trigger {
|
|
2097
|
+
triggerId?: string;
|
|
2098
|
+
targetSubjectType?: SubjectType;
|
|
2099
|
+
name?: string;
|
|
2100
|
+
receivedEvents?: number;
|
|
2101
|
+
lastTriggered?: Date | undefined;
|
|
2102
|
+
created?: Date;
|
|
2103
|
+
}
|
|
2104
|
+
/** Response after successfully resolving and emitting a trigger. */
|
|
2105
|
+
export interface TriggerByFilterResponse {
|
|
2106
|
+
/** The resolved Realforce subject ID. */
|
|
2107
|
+
subjectId?: string;
|
|
2108
|
+
/** The type of subject that was triggered. */
|
|
2109
|
+
subjectType?: TriggerSubjectType;
|
|
2110
|
+
/** The ID of the trigger that was fired. */
|
|
2111
|
+
triggerId?: string;
|
|
2112
|
+
/** The idempotency key for this trigger request. */
|
|
2113
|
+
requestId?: string;
|
|
2114
|
+
}
|
|
2115
|
+
/** Request to send a trigger for a subject resolved by filter. */
|
|
2116
|
+
export interface TriggerRequest {
|
|
2117
|
+
/** The type of subject to trigger (e.g. Property, Agent, Office). */
|
|
2118
|
+
subjectType: TriggerSubjectType;
|
|
2119
|
+
/** The ID of the trigger to fire. */
|
|
2120
|
+
triggerId: string;
|
|
2121
|
+
/** Optional idempotency key. If not provided, a new GUID will be generated. */
|
|
2122
|
+
requestId?: string | undefined;
|
|
2123
|
+
/** The Realforce subject ID. Either this or ExternalId must be provided. */
|
|
2124
|
+
subjectId?: string | undefined;
|
|
2125
|
+
/** The external ID in the customer system. Either this or SubjectId must be provided. */
|
|
2126
|
+
externalId?: string | undefined;
|
|
2127
|
+
}
|
|
2128
|
+
/** Response containing all triggers configured for a workspace. */
|
|
2129
|
+
export interface TriggerResponse {
|
|
2130
|
+
/** The list of triggers available on the workspace. */
|
|
2131
|
+
triggers?: Trigger[];
|
|
2132
|
+
}
|
|
2133
|
+
/** Subject types that can be used with the trigger API. */
|
|
2134
|
+
export declare enum TriggerSubjectType {
|
|
2135
|
+
Office = "Office",
|
|
2136
|
+
Agent = "Agent",
|
|
2137
|
+
Property = "Property"
|
|
2138
|
+
}
|
|
2139
|
+
/** Request to update an existing agent. All fields are optional — only fields present in the request body are changed. Fields you omit are left as-is on the agent. */
|
|
2140
|
+
export interface UpdateAgentRequest {
|
|
2141
|
+
/** Office id. Omit to leave unchanged. */
|
|
2142
|
+
officeId?: string | undefined;
|
|
2143
|
+
/** Agent licenseNumber. */
|
|
2144
|
+
licenseNumber?: string | undefined;
|
|
2145
|
+
/** Phone number. */
|
|
2146
|
+
phoneNumber?: string | undefined;
|
|
2147
|
+
/** List of external identifiers from other systems. */
|
|
2148
|
+
externalIds?: ExternalId[] | undefined;
|
|
2149
|
+
/** Title. */
|
|
2150
|
+
jobTitle?: string | undefined;
|
|
2151
|
+
/** Agent landing page to redirect to. */
|
|
2152
|
+
landingPage?: string | undefined;
|
|
2153
|
+
/** Longitude of agent used for targeting. */
|
|
2154
|
+
longitude?: number | undefined;
|
|
2155
|
+
/** Latitude of agent used for targeting. */
|
|
2156
|
+
latitude?: number | undefined;
|
|
2157
|
+
/** Agent image. */
|
|
2158
|
+
imageUrl?: string | undefined;
|
|
2159
|
+
/** List of additional attributes. */
|
|
2160
|
+
additionalAttributes?: {
|
|
2161
|
+
[key: string]: string;
|
|
2162
|
+
} | undefined;
|
|
2163
|
+
/** List of urls to additional images. */
|
|
2164
|
+
additionalImages?: {
|
|
2165
|
+
[key: string]: string;
|
|
2166
|
+
} | undefined;
|
|
2167
|
+
}
|
|
2168
|
+
/** Request to update a property. All fields are optional — only fields present in the request body are changed. Fields you omit are left as-is on the property. */
|
|
2169
|
+
export interface UpdatePropertyRequest {
|
|
2170
|
+
/** Id in customer system. These needs to be unique for each property on the Workspace */
|
|
2171
|
+
externalId?: string | undefined;
|
|
2172
|
+
/** Status of property. */
|
|
2173
|
+
propertyStatus?: PropertyStatus | undefined;
|
|
2174
|
+
/** Office name where property is listed */
|
|
2175
|
+
office?: string | undefined;
|
|
2176
|
+
/** Office id in customer system */
|
|
2177
|
+
externalOfficeId?: string | undefined;
|
|
2178
|
+
/** Agent id in Realforce system */
|
|
2179
|
+
agentId?: string | undefined;
|
|
2180
|
+
/** Agent email */
|
|
2181
|
+
agentEmail?: string | undefined;
|
|
2182
|
+
/** Agent id in customer system */
|
|
2183
|
+
externalAgentId?: string | undefined;
|
|
2184
|
+
/** Property street address */
|
|
2185
|
+
street?: string | undefined;
|
|
2186
|
+
/** Property city */
|
|
2187
|
+
city?: string | undefined;
|
|
2188
|
+
/** Property postal code */
|
|
2189
|
+
postCode?: string | undefined;
|
|
2190
|
+
/** City area where property is located */
|
|
2191
|
+
area?: string | undefined;
|
|
2192
|
+
/** Property url */
|
|
2193
|
+
propertyUrl?: string | undefined;
|
|
2194
|
+
/** Longitude of property used for targeting */
|
|
2195
|
+
longitude?: number | undefined;
|
|
2196
|
+
/** Latitude of property used for targeting */
|
|
2197
|
+
latitude?: number | undefined;
|
|
2198
|
+
/** List of urls to images */
|
|
2199
|
+
images?: string[] | undefined;
|
|
2200
|
+
/** Main image to use. If empty first image in Images will be used */
|
|
2201
|
+
mainImage?: string | undefined;
|
|
2202
|
+
/** Shorter property description */
|
|
2203
|
+
propertyHeadline?: string | undefined;
|
|
2204
|
+
/** The full property description */
|
|
2205
|
+
propertyDescription?: string | undefined;
|
|
2206
|
+
/** Type of property */
|
|
2207
|
+
homeType?: string | undefined;
|
|
2208
|
+
/** The type of transaction the Property is intended for (sale, rent) */
|
|
2209
|
+
transactionType?: string | undefined;
|
|
2210
|
+
/** Size of property in square meters */
|
|
2211
|
+
areaSquareMeters?: number | undefined;
|
|
2212
|
+
/** Number of rooms */
|
|
2213
|
+
numberOfRooms?: number | undefined;
|
|
2214
|
+
/** Number of bedrooms */
|
|
2215
|
+
numberOfBedrooms?: number | undefined;
|
|
2216
|
+
/** Number of bathrooms */
|
|
2217
|
+
numberOfBathRooms?: number | undefined;
|
|
2218
|
+
/** Number of parking spots */
|
|
2219
|
+
numberOfParking?: number | undefined;
|
|
2220
|
+
/** Asking price */
|
|
2221
|
+
askingPrice?: number | undefined;
|
|
2222
|
+
/** Custom data that can be used for triggering ads */
|
|
2223
|
+
customAttributes?: {
|
|
2224
|
+
[key: string]: string;
|
|
2225
|
+
} | undefined;
|
|
2226
|
+
/** List of events occuring on the property */
|
|
2227
|
+
propertyEvents?: PropertyEventTime[] | undefined;
|
|
2228
|
+
/** Additional property landing page */
|
|
2229
|
+
additionalLandingPage?: string | undefined;
|
|
2230
|
+
/** Additional agents to be added to the property. (Can be added by either email or externalId or a combination) */
|
|
2231
|
+
additionalAgentsEmails?: string[] | undefined;
|
|
2232
|
+
/** Additional agents to be added to the property. (Can be added by either email or externalId or a combination) */
|
|
2233
|
+
additionalAgentsExternalIds?: string[] | undefined;
|
|
2234
|
+
/** Sold price */
|
|
2235
|
+
soldPrice?: number | undefined;
|
|
2236
|
+
/** Currency in which the property was sold */
|
|
2237
|
+
soldCurrency?: string | undefined;
|
|
2238
|
+
/** The source feed name of the property. Can be used to keep track of properties available on multiple feeds. */
|
|
2239
|
+
sourceName?: string | undefined;
|
|
2240
|
+
}
|
|
2241
|
+
/** User model for V2 API. */
|
|
2242
|
+
export interface User {
|
|
2243
|
+
/** Unique identifier for the user. */
|
|
2244
|
+
id: string;
|
|
2245
|
+
/** The user's full name. */
|
|
2246
|
+
name?: string | undefined;
|
|
2247
|
+
/** The user's email address. */
|
|
2248
|
+
email?: string | undefined;
|
|
2249
|
+
/** The user's phone number. */
|
|
2250
|
+
phone?: string | undefined;
|
|
2251
|
+
/** The user's roles. */
|
|
2252
|
+
roles?: string[] | undefined;
|
|
2253
|
+
/** Status of the user account (e.g., "active", "inactive", "pending"). */
|
|
2254
|
+
status?: string | undefined;
|
|
2255
|
+
/** Media assets for the user. */
|
|
2256
|
+
media?: MediaModel | undefined;
|
|
2257
|
+
/** External identifiers from other systems. */
|
|
2258
|
+
externalIds?: ExternalId[] | undefined;
|
|
2259
|
+
/** Custom attributes defined by the Workspace. */
|
|
2260
|
+
customAttributes?: {
|
|
2261
|
+
[key: string]: any;
|
|
2262
|
+
} | undefined;
|
|
2263
|
+
/** Timestamp information. */
|
|
2264
|
+
timestamps?: TimestampsModel | undefined;
|
|
2265
|
+
/** When the user last logged in. */
|
|
2266
|
+
lastLoginAt?: Date | undefined;
|
|
2267
|
+
/** The workspace this user belongs to. Null when User is embedded in another response. */
|
|
2268
|
+
workspace?: Workspace | undefined;
|
|
2269
|
+
/** The office this user belongs to. Null when User is embedded in another response. */
|
|
2270
|
+
office?: Office | undefined;
|
|
2271
|
+
}
|
|
2272
|
+
/** Filter criteria for listing users. */
|
|
2273
|
+
export interface UserFilter {
|
|
2274
|
+
/** Filter by external ID (exact match). */
|
|
2275
|
+
externalId?: string | undefined;
|
|
2276
|
+
/** Filter by email address (exact match). */
|
|
2277
|
+
email?: string | undefined;
|
|
2278
|
+
/** Filter by name (exact match). */
|
|
2279
|
+
name?: string | undefined;
|
|
2280
|
+
/** Free-text search across name and email (partial match, case-insensitive). */
|
|
2281
|
+
search?: string | undefined;
|
|
2282
|
+
/** Filter by role names.
|
|
2283
|
+
If empty or null, returns all roles. */
|
|
2284
|
+
roles?: string[] | undefined;
|
|
2285
|
+
/** Filter by office ID to get users associated with a specific office. */
|
|
2286
|
+
officeId?: string | undefined;
|
|
2287
|
+
/** Filter by multiple office IDs. */
|
|
2288
|
+
officeIds?: string[] | undefined;
|
|
2289
|
+
/** Filter by creation date range. */
|
|
2290
|
+
createdDateRange?: DateRangeFilter | undefined;
|
|
2291
|
+
/** Filter by last updated date range. */
|
|
2292
|
+
updatedDateRange?: DateRangeFilter | undefined;
|
|
2293
|
+
}
|
|
2294
|
+
/** Standard list response with pagination, sort, and filter metadata. */
|
|
2295
|
+
export interface UserListResponse {
|
|
2296
|
+
/** The list of items for the current page. */
|
|
2297
|
+
data: User[];
|
|
2298
|
+
/** Pagination metadata. */
|
|
2299
|
+
pagination: PaginationResponse;
|
|
2300
|
+
/** Sort criteria that was applied. Null if no sorting was specified. */
|
|
2301
|
+
sort?: SortCriteria[] | undefined;
|
|
2302
|
+
/** Filter criteria that was applied. */
|
|
2303
|
+
filter?: UserFilter | undefined;
|
|
2304
|
+
}
|
|
2305
|
+
/** User Profile model */
|
|
2306
|
+
export interface UserProfile {
|
|
2307
|
+
/** The preferred language of the user */
|
|
2308
|
+
preferredLanguage?: string | undefined;
|
|
2309
|
+
/** A list of workspaces with their associated locale settings for the user. */
|
|
2310
|
+
workspaces: WorkspaceInfo[];
|
|
2311
|
+
}
|
|
2312
|
+
/** Query request for users. */
|
|
2313
|
+
export interface UserQueryRequest {
|
|
2314
|
+
/** Sort parameters. */
|
|
2315
|
+
sort?: SortRequest | undefined;
|
|
2316
|
+
/** Pagination parameters. */
|
|
2317
|
+
pagination?: PaginationRequest | undefined;
|
|
2318
|
+
/** Filter criteria for this resource. */
|
|
2319
|
+
filter?: UserFilter | undefined;
|
|
2320
|
+
}
|
|
2321
|
+
/** The organizational scope at which a user operates. */
|
|
2322
|
+
export declare enum UserRole {
|
|
2323
|
+
Account = "Account",
|
|
2324
|
+
Workspace = "Workspace",
|
|
2325
|
+
Office = "Office"
|
|
2326
|
+
}
|
|
2327
|
+
export interface VisitorCount {
|
|
2328
|
+
category?: string;
|
|
2329
|
+
visits?: number;
|
|
2330
|
+
}
|
|
2331
|
+
/** Workspace model for V2 API. */
|
|
2332
|
+
export interface Workspace {
|
|
2333
|
+
/** Unique identifier for the workspace. */
|
|
2334
|
+
id: string;
|
|
2335
|
+
/** The account this workspace belongs to. */
|
|
2336
|
+
account?: Account | undefined;
|
|
2337
|
+
/** The workspace's name. */
|
|
2338
|
+
name?: string | undefined;
|
|
2339
|
+
/** Descriptive name for the workspace. */
|
|
2340
|
+
descriptiveName?: string | undefined;
|
|
2341
|
+
/** Domain associated with the workspace. */
|
|
2342
|
+
domain?: string | undefined;
|
|
2343
|
+
/** Logo URL for the workspace. */
|
|
2344
|
+
logo?: string | undefined;
|
|
2345
|
+
/** Favicon URL for the workspace. */
|
|
2346
|
+
favIcon?: string | undefined;
|
|
2347
|
+
/** Primary color in RGB format. */
|
|
2348
|
+
primaryColor?: string | undefined;
|
|
2349
|
+
/** Currency used by the workspace. */
|
|
2350
|
+
currency?: string | undefined;
|
|
2351
|
+
/** Culture/locale for the workspace. */
|
|
2352
|
+
culture?: string | undefined;
|
|
2353
|
+
}
|
|
2354
|
+
/** Represents workspace information including locale and country details. */
|
|
2355
|
+
export interface WorkspaceInfo {
|
|
2356
|
+
/** The workspace ID. */
|
|
2357
|
+
id: string;
|
|
2358
|
+
/** The preferred locale in BCP 47 language tag format (e.g. en-US, sv-SE). */
|
|
2359
|
+
locale: string;
|
|
2360
|
+
/** The country code in ISO 3166-1 alpha-2 format (e.g. US, SE). */
|
|
2361
|
+
countryCode: string;
|
|
2362
|
+
/** The name of the workspace. */
|
|
2363
|
+
name: string;
|
|
2364
|
+
}
|
|
2365
|
+
export declare class ApiException extends Error {
|
|
2366
|
+
message: string;
|
|
2367
|
+
status: number;
|
|
2368
|
+
response: string;
|
|
2369
|
+
headers: {
|
|
2370
|
+
[key: string]: any;
|
|
2371
|
+
};
|
|
2372
|
+
result: any;
|
|
2373
|
+
constructor(message: string, status: number, response: string, headers: {
|
|
2374
|
+
[key: string]: any;
|
|
2375
|
+
}, result: any);
|
|
2376
|
+
protected isApiException: boolean;
|
|
2377
|
+
static isApiException(obj: any): obj is ApiException;
|
|
2378
|
+
}
|
|
2379
|
+
//# sourceMappingURL=client.generated.d.ts.map
|