ultracart_rest_api_v2_typescript 4.1.79 → 4.1.82

package/.openapi-generator/FILES

@@ -44,6 +44,7 @@ src/models/AffiliateLedger.ts
 src/models/AffiliateLedgerQuery.ts
 src/models/AffiliateLedgersResponse.ts
 src/models/AffiliateLink.ts
+src/models/AgentSummary.ts
 src/models/ApiUserApplicationProfile.ts
 src/models/ApplyLibraryItemRequest.ts
 src/models/ApplyLibraryItemResponse.ts
@@ -161,9 +162,24 @@ src/models/Conversation.ts
 src/models/ConversationAgentAuth.ts
 src/models/ConversationAgentAuthMerchant.ts
 src/models/ConversationAgentAuthResponse.ts
+src/models/ConversationAgentCallEvent.ts
+src/models/ConversationAgentChatEvent.ts
 src/models/ConversationAgentProfile.ts
 src/models/ConversationAgentProfileResponse.ts
 src/models/ConversationAgentProfilesResponse.ts
+src/models/ConversationAgentStatusConfig.ts
+src/models/ConversationAgentStatusConfigResponse.ts
+src/models/ConversationAgentStatusConfigsResponse.ts
+src/models/ConversationAgentStatusEvent.ts
+src/models/ConversationAgentStatusHeatmapRequest.ts
+src/models/ConversationAgentStatusHeatmapResponse.ts
+src/models/ConversationAgentStatusHistorySearchRequest.ts
+src/models/ConversationAgentStatusHistorySearchResponse.ts
+src/models/ConversationAgentStatusRollup.ts
+src/models/ConversationAgentStatusRollupSearchRequest.ts
+src/models/ConversationAgentStatusRollupSearchResponse.ts
+src/models/ConversationAgentStatusSummaryResponse.ts
+src/models/ConversationAgentStatusTimelineResponse.ts
 src/models/ConversationAutocompleteRequest.ts
 src/models/ConversationAutocompleteResponse.ts
 src/models/ConversationAutocompleteValue.ts
@@ -253,6 +269,8 @@ src/models/ConversationPbxCosAuditLog.ts
 src/models/ConversationPbxCosAuditLogsResponse.ts
 src/models/ConversationPbxCustomerSnapshotRequest.ts
 src/models/ConversationPbxCustomerSnapshotResponse.ts
+src/models/ConversationPbxDefaultTimezoneResponse.ts
+src/models/ConversationPbxDefaultTimezoneUpdateRequest.ts
 src/models/ConversationPbxHardwarePhone.ts
 src/models/ConversationPbxHardwarePhoneResponse.ts
 src/models/ConversationPbxHardwarePhonesResponse.ts
@@ -932,6 +950,7 @@ src/models/TempMultimedia.ts
 src/models/TempMultimediaResponse.ts
 src/models/ThumbnailParametersRequest.ts
 src/models/ThumbnailParametersResponse.ts
+src/models/TimelineSummary.ts
 src/models/TransactionEmail.ts
 src/models/TransactionEmailListResponse.ts
 src/models/TransactionEmailOption.ts

package/README.md

@@ -1,12 +1,12 @@
 # UltraCart Typescript SDK
-## ultracart_rest_api_v2_typescript@4.1.79
+## ultracart_rest_api_v2_typescript@4.1.82
 
 Every API method call has a sample for every language SDK.  See https://github.com/UltraCart/sdk_samples
 
 Installation
 
 ```
-npm install ultracart_rest_api_v2_typescript@4.1.79 --save
+npm install ultracart_rest_api_v2_typescript@4.1.82 --save
 ```
 
 ```typescript
@@ -85,6 +85,9 @@ Not every change is committed to every SDK.
 
 | Version | Date | Comments |
 | --: | :-: | --- |
+| 4.1.82 | 04/27/2026 | converation - agent status and availability |
+| 4.1.81 | 04/27/2026 | conversations - agent status and availability |
+| 4.1.80 | 04/22/2026 | customer - e.164 read only fields on billing/shipping child objects |
 | 4.1.79 | 04/21/2026 | item - one line per unit flag support |
 | 4.1.78 | 04/20/2026 | conversation pbx - objects have context_merchant_id fields to linked account configs |
 | 4.1.77 | 04/17/2026 | conversation - embed oauth methods |

package/dist/apis/ConversationApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import { BaseResponse, ConversationAgentAuthResponse, ConversationAgentProfile, ConversationAgentProfileResponse, ConversationAgentProfilesResponse, ConversationAutocompleteRequest, ConversationAutocompleteResponse, ConversationCannedMessage, ConversationCannedMessageResponse, ConversationCannedMessagesResponse, ConversationCannedMessagesSearch, ConversationDeleteKnowledgeBaseDocumentResponse, ConversationDepartment, ConversationDepartmentMembersResponse, ConversationDepartmentResponse, ConversationDepartmentsResponse, ConversationEngagement, ConversationEngagementResponse, ConversationEngagementsResponse, ConversationInsertKnowledgeBaseDocumentRequest, ConversationInsertKnowledgeBaseDocumentResponse, ConversationJoinRequest, ConversationKnowledgeBaseDocumentUploadUrlResponse, ConversationKnowledgeBaseDocumentsResponse, ConversationLocationsResponse, ConversationMcpServer, ConversationMcpServerResponse, ConversationMcpServerToolsResponse, ConversationMcpServersResponse, ConversationMessagesResponse, ConversationMultimediaUploadUrlResponse, ConversationPbxAddress, ConversationPbxAddressResponse, ConversationPbxAddressesResponse, ConversationPbxAgent, ConversationPbxAgentResponse, ConversationPbxAgentsResponse, ConversationPbxAudio, ConversationPbxAudioResponse, ConversationPbxAudioUploadUrlResponse, ConversationPbxAudioUsageResponse, ConversationPbxAudiosResponse, ConversationPbxAvailablePhoneNumbersResponse, ConversationPbxCallResponse, ConversationPbxCallSearchRequest, ConversationPbxCallSearchResponse, ConversationPbxClassOfService, ConversationPbxClassOfServiceResponse, ConversationPbxClassOfServicesResponse, ConversationPbxCosAuditLogsResponse, ConversationPbxCustomerSnapshotRequest, ConversationPbxCustomerSnapshotResponse, ConversationPbxHardwarePhone, ConversationPbxHardwarePhoneResponse, ConversationPbxHardwarePhonesResponse, ConversationPbxMenu, ConversationPbxMenuResponse, ConversationPbxMenusResponse, ConversationPbxPhoneManufacturersResponse, ConversationPbxPhoneNumber, ConversationPbxPhoneNumberPurchaseRequest, ConversationPbxPhoneNumberResponse, ConversationPbxPhoneNumbersResponse, ConversationPbxQueue, ConversationPbxQueueResponse, ConversationPbxQueuesResponse, ConversationPbxTimeBased, ConversationPbxTimeBasedResponse, ConversationPbxTimeBasedsResponse, ConversationPbxTimeRange, ConversationPbxTimeRangeResponse, ConversationPbxTimeRangesResponse, ConversationPbxVoicemailCapabilitiesResponse, ConversationPbxVoicemailMailbox, ConversationPbxVoicemailMailboxResponse, ConversationPbxVoicemailMailboxesResponse, ConversationPbxVoicemailMessageResponse, ConversationPbxVoicemailMessageSummariesResponse, ConversationPermissionsResponse, ConversationResponse, ConversationSearchRequest, ConversationSearchResponse, ConversationStartRequest, ConversationStartResponse, ConversationVirtualAgentBudget, ConversationVirtualAgentBudgetResponse, ConversationVirtualAgentCapabilities, ConversationVirtualAgentCapabilitiesResponse, ConversationWebchatContext, ConversationWebchatQueueStatusUpdateRequest, ConversationWebchatQueueStatusesResponse, ConversationsResponse, ItemResponse } from '../models';
+import { BaseResponse, ConversationAgentAuthResponse, ConversationAgentProfile, ConversationAgentProfileResponse, ConversationAgentProfilesResponse, ConversationAgentStatusConfig, ConversationAgentStatusConfigResponse, ConversationAgentStatusConfigsResponse, ConversationAgentStatusHeatmapRequest, ConversationAgentStatusHeatmapResponse, ConversationAgentStatusHistorySearchRequest, ConversationAgentStatusHistorySearchResponse, ConversationAgentStatusRollupSearchRequest, ConversationAgentStatusRollupSearchResponse, ConversationAgentStatusSummaryResponse, ConversationAgentStatusTimelineResponse, ConversationAutocompleteRequest, ConversationAutocompleteResponse, ConversationCannedMessage, ConversationCannedMessageResponse, ConversationCannedMessagesResponse, ConversationCannedMessagesSearch, ConversationDeleteKnowledgeBaseDocumentResponse, ConversationDepartment, ConversationDepartmentMembersResponse, ConversationDepartmentResponse, ConversationDepartmentsResponse, ConversationEngagement, ConversationEngagementResponse, ConversationEngagementsResponse, ConversationInsertKnowledgeBaseDocumentRequest, ConversationInsertKnowledgeBaseDocumentResponse, ConversationJoinRequest, ConversationKnowledgeBaseDocumentUploadUrlResponse, ConversationKnowledgeBaseDocumentsResponse, ConversationLocationsResponse, ConversationMcpServer, ConversationMcpServerResponse, ConversationMcpServerToolsResponse, ConversationMcpServersResponse, ConversationMessagesResponse, ConversationMultimediaUploadUrlResponse, ConversationPbxAddress, ConversationPbxAddressResponse, ConversationPbxAddressesResponse, ConversationPbxAgent, ConversationPbxAgentResponse, ConversationPbxAgentsResponse, ConversationPbxAudio, ConversationPbxAudioResponse, ConversationPbxAudioUploadUrlResponse, ConversationPbxAudioUsageResponse, ConversationPbxAudiosResponse, ConversationPbxAvailablePhoneNumbersResponse, ConversationPbxCallResponse, ConversationPbxCallSearchRequest, ConversationPbxCallSearchResponse, ConversationPbxClassOfService, ConversationPbxClassOfServiceResponse, ConversationPbxClassOfServicesResponse, ConversationPbxCosAuditLogsResponse, ConversationPbxCustomerSnapshotRequest, ConversationPbxCustomerSnapshotResponse, ConversationPbxDefaultTimezoneResponse, ConversationPbxDefaultTimezoneUpdateRequest, ConversationPbxHardwarePhone, ConversationPbxHardwarePhoneResponse, ConversationPbxHardwarePhonesResponse, ConversationPbxMenu, ConversationPbxMenuResponse, ConversationPbxMenusResponse, ConversationPbxPhoneManufacturersResponse, ConversationPbxPhoneNumber, ConversationPbxPhoneNumberPurchaseRequest, ConversationPbxPhoneNumberResponse, ConversationPbxPhoneNumbersResponse, ConversationPbxQueue, ConversationPbxQueueResponse, ConversationPbxQueuesResponse, ConversationPbxTimeBased, ConversationPbxTimeBasedResponse, ConversationPbxTimeBasedsResponse, ConversationPbxTimeRange, ConversationPbxTimeRangeResponse, ConversationPbxTimeRangesResponse, ConversationPbxVoicemailCapabilitiesResponse, ConversationPbxVoicemailMailbox, ConversationPbxVoicemailMailboxResponse, ConversationPbxVoicemailMailboxesResponse, ConversationPbxVoicemailMessageResponse, ConversationPbxVoicemailMessageSummariesResponse, ConversationPermissionsResponse, ConversationResponse, ConversationSearchRequest, ConversationSearchResponse, ConversationStartRequest, ConversationStartResponse, ConversationVirtualAgentBudget, ConversationVirtualAgentBudgetResponse, ConversationVirtualAgentCapabilities, ConversationVirtualAgentCapabilitiesResponse, ConversationWebchatContext, ConversationWebchatQueueStatusUpdateRequest, ConversationWebchatQueueStatusesResponse, ConversationsResponse, ItemResponse } from '../models';
 export interface DeleteAgentProfileKnowledgeBaseDocumentRequest {
     userId: number;
     documentUuid: string;
@@ -19,6 +19,9 @@ export interface DeleteAgentProfileMcpRequest {
     userId: number;
     mcpServerUuid: string;
 }
+export interface DeleteAgentStatusConfigRequest {
+    conversationStatusUuid: string;
+}
 export interface DeleteConversationCannedMessageRequest {
     conversationCannedMessageOid: number;
 }
@@ -82,6 +85,22 @@ export interface GetAgentProfileMcpToolsRequest {
 export interface GetAgentProfileMcpsRequest {
     userId: number;
 }
+export interface GetAgentStatusHeatmapRequest {
+    heatmapRequest: ConversationAgentStatusHeatmapRequest;
+}
+export interface GetAgentStatusSummaryRequest {
+    dateStart2: string;
+    dateEnd2: string;
+    dateStart?: string;
+    dateEnd?: string;
+}
+export interface GetAgentStatusTimelineRequest {
+    agentUserId: string;
+    date2: string;
+    date?: string;
+    channel?: string;
+    channel2?: string;
+}
 export interface GetConversationRequest {
     conversationUuid: string;
     limit?: number;
@@ -191,6 +210,9 @@ export interface InsertAgentProfileMcpRequest {
     userId: number;
     mcpServer: ConversationMcpServer;
 }
+export interface InsertAgentStatusConfigRequest {
+    statusConfig: ConversationAgentStatusConfig;
+}
 export interface InsertConversationCannedMessageRequest {
     cannedMessage: ConversationCannedMessage;
 }
@@ -260,6 +282,14 @@ export interface RegeneratePasswordForPbxHardwarePhoneRequest {
 export interface ResetConversationPbxQueueStatisticsRequest {
     queueUuid: string;
 }
+export interface SearchAgentStatusHistoryRequest {
+    searchRequest: ConversationAgentStatusHistorySearchRequest;
+    limit?: number;
+    offset?: number;
+}
+export interface SearchAgentStatusRollupsRequest {
+    searchRequest: ConversationAgentStatusRollupSearchRequest;
+}
 export interface SearchConversationCannedMessagesRequest {
     searchRequest: ConversationCannedMessagesSearch;
 }
@@ -292,6 +322,10 @@ export interface UpdateAgentProfileMcpRequest {
     mcpServerUuid: string;
     mcpServer: ConversationMcpServer;
 }
+export interface UpdateAgentStatusConfigRequest {
+    conversationStatusUuid: string;
+    statusConfig: ConversationAgentStatusConfig;
+}
 export interface UpdateConversationCannedMessageRequest {
     conversationCannedMessageOid: number;
     cannedMessage: ConversationCannedMessage;
@@ -324,6 +358,9 @@ export interface UpdatePbxClassOfServiceRequest {
     classOfServiceUuid: string;
     classOfService: ConversationPbxClassOfService;
 }
+export interface UpdatePbxDefaultTimezoneRequest {
+    timezoneUpdate: ConversationPbxDefaultTimezoneUpdateRequest;
+}
 export interface UpdatePbxHardwarePhoneRequest {
     conversationPbxHardwarePhoneUuid: string;
     pbxHardwarePhone: ConversationPbxHardwarePhone;
@@ -399,6 +436,20 @@ export interface ConversationApiInterface {
      * Delete an agent MCP server
      */
     deleteAgentProfileMcp(requestParameters: DeleteAgentProfileMcpRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Sets active=false on the row and the DDB sync record. The Twilio Activity is preserved (Round 2 decision) so historic worker reporting still resolves the SID.
+     * @summary Soft-deactivate a custom agent status
+     * @param {string} conversationStatusUuid
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationApiInterface
+     */
+    deleteAgentStatusConfigRaw(requestParameters: DeleteAgentStatusConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Sets active=false on the row and the DDB sync record. The Twilio Activity is preserved (Round 2 decision) so historic worker reporting still resolves the SID.
+     * Soft-deactivate a custom agent status
+     */
+    deleteAgentStatusConfig(requestParameters: DeleteAgentStatusConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
      * Delete a conversation canned message
      * @summary Delete a conversation canned message
@@ -721,6 +772,68 @@ export interface ConversationApiInterface {
      * Get agent profiles
      */
     getAgentProfiles(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentProfilesResponse>;
+    /**
+     * Returns all custom statuses (active and soft-deactivated) for the merchant.
+     * @summary List custom agent statuses
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationApiInterface
+     */
+    getAgentStatusConfigsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusConfigsResponse>>;
+    /**
+     * Returns all custom statuses (active and soft-deactivated) for the merchant.
+     * List custom agent statuses
+     */
+    getAgentStatusConfigs(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusConfigsResponse>;
+    /**
+     * Returns ECharts-shaped agent x hour grid for the requested metric (availability, call_volume, chat_volume). Multi-day requests average the cell values across the date range.
+     * @summary Agent x hour-of-day heatmap
+     * @param {ConversationAgentStatusHeatmapRequest} heatmapRequest Heatmap request
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationApiInterface
+     */
+    getAgentStatusHeatmapRaw(requestParameters: GetAgentStatusHeatmapRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusHeatmapResponse>>;
+    /**
+     * Returns ECharts-shaped agent x hour grid for the requested metric (availability, call_volume, chat_volume). Multi-day requests average the cell values across the date range.
+     * Agent x hour-of-day heatmap
+     */
+    getAgentStatusHeatmap(requestParameters: GetAgentStatusHeatmapRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusHeatmapResponse>;
+    /**
+     * Top-line summary: total_agents, avg_available_pct, status_breakdown, per-agent rollups.
+     * @summary Dashboard summary for a date range
+     * @param {string} dateStart2 Range start (YYYY-MM-DD)
+     * @param {string} dateEnd2 Range end (YYYY-MM-DD)
+     * @param {string} [dateStart]
+     * @param {string} [dateEnd]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationApiInterface
+     */
+    getAgentStatusSummaryRaw(requestParameters: GetAgentStatusSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusSummaryResponse>>;
+    /**
+     * Top-line summary: total_agents, avg_available_pct, status_breakdown, per-agent rollups.
+     * Dashboard summary for a date range
+     */
+    getAgentStatusSummary(requestParameters: GetAgentStatusSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusSummaryResponse>;
+    /**
+     * Returns merged status events + PBX calls + chat conversations for the agent on the given date. Omitting the channel parameter returns both channels merged.
+     * @summary Day timeline for a single agent
+     * @param {string} agentUserId
+     * @param {string} date2 Day to retrieve (YYYY-MM-DD)
+     * @param {string} [date]
+     * @param {string} [channel]
+     * @param {string} [channel2] Restrict to one channel (omit for both)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationApiInterface
+     */
+    getAgentStatusTimelineRaw(requestParameters: GetAgentStatusTimelineRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusTimelineResponse>>;
+    /**
+     * Returns merged status events + PBX calls + chat conversations for the agent on the given date. Omitting the channel parameter returns both channels merged.
+     * Day timeline for a single agent
+     */
+    getAgentStatusTimeline(requestParameters: GetAgentStatusTimelineRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusTimelineResponse>;
     /**
      * Retrieve a JWT to authorize an agent to make a websocket connection.
      * @summary Get agent websocket authorization
@@ -1180,6 +1293,19 @@ export interface ConversationApiInterface {
      * Get pbx class of service audit logs
      */
     getPbxCosAuditLogs(requestParameters: GetPbxCosAuditLogsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationPbxCosAuditLogsResponse>;
+    /**
+     * Returns the merchant\'s stored default timezone (IANA name). Falls back to America/New_York when unset.
+     * @summary Get the merchant default timezone
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationApiInterface
+     */
+    getPbxDefaultTimezoneRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationPbxDefaultTimezoneResponse>>;
+    /**
+     * Returns the merchant\'s stored default timezone (IANA name). Falls back to America/New_York when unset.
+     * Get the merchant default timezone
+     */
+    getPbxDefaultTimezone(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationPbxDefaultTimezoneResponse>;
     /**
      * Retrieve a pbx hardware phone
      * @summary Get pbx hardware phone
@@ -1507,6 +1633,20 @@ export interface ConversationApiInterface {
      * Insert an agent MCP server
      */
     insertAgentProfileMcp(requestParameters: InsertAgentProfileMcpRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationMcpServerResponse>;
+    /**
+     * Create a custom status. Enforces a 20-active-status-per-merchant cap and the 50-Twilio-Activity-per-workspace cap.
+     * @summary Create a custom agent status
+     * @param {ConversationAgentStatusConfig} statusConfig Status config
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationApiInterface
+     */
+    insertAgentStatusConfigRaw(requestParameters: InsertAgentStatusConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusConfigResponse>>;
+    /**
+     * Create a custom status. Enforces a 20-active-status-per-merchant cap and the 50-Twilio-Activity-per-workspace cap.
+     * Create a custom agent status
+     */
+    insertAgentStatusConfig(requestParameters: InsertAgentStatusConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusConfigResponse>;
     /**
      * Insert a canned message
      * @summary Insert a canned message
@@ -1818,6 +1958,36 @@ export interface ConversationApiInterface {
      * reset statistics within the queue
      */
     resetConversationPbxQueueStatistics(requestParameters: ResetConversationPbxQueueStatisticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Paginated search over conversation_agent_status_events_all. Filters: agent_user_id, channel, status, trigger, date range.
+     * @summary Search agent status history
+     * @param {ConversationAgentStatusHistorySearchRequest} searchRequest Search request
+     * @param {number} [limit] Maximum records per call (max 200)
+     * @param {number} [offset] Pagination offset (zero-based)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationApiInterface
+     */
+    searchAgentStatusHistoryRaw(requestParameters: SearchAgentStatusHistoryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusHistorySearchResponse>>;
+    /**
+     * Paginated search over conversation_agent_status_events_all. Filters: agent_user_id, channel, status, trigger, date range.
+     * Search agent status history
+     */
+    searchAgentStatusHistory(requestParameters: SearchAgentStatusHistoryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusHistorySearchResponse>;
+    /**
+     * Aggregated over conversation_agent_status_events_all via date_histogram + terms. Returns one row per (agent, day, channel).
+     * @summary Search per-(agent, day) rollups
+     * @param {ConversationAgentStatusRollupSearchRequest} searchRequest Search request
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationApiInterface
+     */
+    searchAgentStatusRollupsRaw(requestParameters: SearchAgentStatusRollupsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusRollupSearchResponse>>;
+    /**
+     * Aggregated over conversation_agent_status_events_all via date_histogram + terms. Returns one row per (agent, day, channel).
+     * Search per-(agent, day) rollups
+     */
+    searchAgentStatusRollups(requestParameters: SearchAgentStatusRollupsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusRollupSearchResponse>;
     /**
      * Search for canned messages by short_code
      * @summary Search for canned messages by short_code
@@ -1927,6 +2097,21 @@ export interface ConversationApiInterface {
      * Update an agent MCP server
      */
     updateAgentProfileMcp(requestParameters: UpdateAgentProfileMcpRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationMcpServerResponse>;
+    /**
+     * Update a custom status. Renaming flows through to the Twilio Activity.
+     * @summary Update a custom agent status
+     * @param {string} conversationStatusUuid
+     * @param {ConversationAgentStatusConfig} statusConfig Status config
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationApiInterface
+     */
+    updateAgentStatusConfigRaw(requestParameters: UpdateAgentStatusConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusConfigResponse>>;
+    /**
+     * Update a custom status. Renaming flows through to the Twilio Activity.
+     * Update a custom agent status
+     */
+    updateAgentStatusConfig(requestParameters: UpdateAgentStatusConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusConfigResponse>;
     /**
      * Update a canned message
      * @summary Update a canned message
@@ -2047,6 +2232,20 @@ export interface ConversationApiInterface {
      * Update pbx class of service
      */
     updatePbxClassOfService(requestParameters: UpdatePbxClassOfServiceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationPbxClassOfServiceResponse>;
+    /**
+     * Persists the IANA timezone on the Config#<merchant_id>/default DDB record (creates on first PUT).
+     * @summary Set the merchant default timezone
+     * @param {ConversationPbxDefaultTimezoneUpdateRequest} timezoneUpdate Timezone update
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ConversationApiInterface
+     */
+    updatePbxDefaultTimezoneRaw(requestParameters: UpdatePbxDefaultTimezoneRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationPbxDefaultTimezoneResponse>>;
+    /**
+     * Persists the IANA timezone on the Config#<merchant_id>/default DDB record (creates on first PUT).
+     * Set the merchant default timezone
+     */
+    updatePbxDefaultTimezone(requestParameters: UpdatePbxDefaultTimezoneRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationPbxDefaultTimezoneResponse>;
     /**
      * Update a pbx hardware phone
      * @summary Update pbx hardware phone
@@ -2220,6 +2419,16 @@ export declare class ConversationApi extends runtime.BaseAPI implements Conversa
      * Delete an agent MCP server
      */
     deleteAgentProfileMcp(requestParameters: DeleteAgentProfileMcpRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Sets active=false on the row and the DDB sync record. The Twilio Activity is preserved (Round 2 decision) so historic worker reporting still resolves the SID.
+     * Soft-deactivate a custom agent status
+     */
+    deleteAgentStatusConfigRaw(requestParameters: DeleteAgentStatusConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    /**
+     * Sets active=false on the row and the DDB sync record. The Twilio Activity is preserved (Round 2 decision) so historic worker reporting still resolves the SID.
+     * Soft-deactivate a custom agent status
+     */
+    deleteAgentStatusConfig(requestParameters: DeleteAgentStatusConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
      * Delete a conversation canned message
      * Delete a conversation canned message
@@ -2450,6 +2659,46 @@ export declare class ConversationApi extends runtime.BaseAPI implements Conversa
      * Get agent profiles
      */
     getAgentProfiles(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentProfilesResponse>;
+    /**
+     * Returns all custom statuses (active and soft-deactivated) for the merchant.
+     * List custom agent statuses
+     */
+    getAgentStatusConfigsRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusConfigsResponse>>;
+    /**
+     * Returns all custom statuses (active and soft-deactivated) for the merchant.
+     * List custom agent statuses
+     */
+    getAgentStatusConfigs(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusConfigsResponse>;
+    /**
+     * Returns ECharts-shaped agent x hour grid for the requested metric (availability, call_volume, chat_volume). Multi-day requests average the cell values across the date range.
+     * Agent x hour-of-day heatmap
+     */
+    getAgentStatusHeatmapRaw(requestParameters: GetAgentStatusHeatmapRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusHeatmapResponse>>;
+    /**
+     * Returns ECharts-shaped agent x hour grid for the requested metric (availability, call_volume, chat_volume). Multi-day requests average the cell values across the date range.
+     * Agent x hour-of-day heatmap
+     */
+    getAgentStatusHeatmap(requestParameters: GetAgentStatusHeatmapRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusHeatmapResponse>;
+    /**
+     * Top-line summary: total_agents, avg_available_pct, status_breakdown, per-agent rollups.
+     * Dashboard summary for a date range
+     */
+    getAgentStatusSummaryRaw(requestParameters: GetAgentStatusSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusSummaryResponse>>;
+    /**
+     * Top-line summary: total_agents, avg_available_pct, status_breakdown, per-agent rollups.
+     * Dashboard summary for a date range
+     */
+    getAgentStatusSummary(requestParameters: GetAgentStatusSummaryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusSummaryResponse>;
+    /**
+     * Returns merged status events + PBX calls + chat conversations for the agent on the given date. Omitting the channel parameter returns both channels merged.
+     * Day timeline for a single agent
+     */
+    getAgentStatusTimelineRaw(requestParameters: GetAgentStatusTimelineRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusTimelineResponse>>;
+    /**
+     * Returns merged status events + PBX calls + chat conversations for the agent on the given date. Omitting the channel parameter returns both channels merged.
+     * Day timeline for a single agent
+     */
+    getAgentStatusTimeline(requestParameters: GetAgentStatusTimelineRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusTimelineResponse>;
     /**
      * Retrieve a JWT to authorize an agent to make a websocket connection.
      * Get agent websocket authorization
@@ -2780,6 +3029,16 @@ export declare class ConversationApi extends runtime.BaseAPI implements Conversa
      * Get pbx class of service audit logs
      */
     getPbxCosAuditLogs(requestParameters?: GetPbxCosAuditLogsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationPbxCosAuditLogsResponse>;
+    /**
+     * Returns the merchant\'s stored default timezone (IANA name). Falls back to America/New_York when unset.
+     * Get the merchant default timezone
+     */
+    getPbxDefaultTimezoneRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationPbxDefaultTimezoneResponse>>;
+    /**
+     * Returns the merchant\'s stored default timezone (IANA name). Falls back to America/New_York when unset.
+     * Get the merchant default timezone
+     */
+    getPbxDefaultTimezone(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationPbxDefaultTimezoneResponse>;
     /**
      * Retrieve a pbx hardware phone
      * Get pbx hardware phone
@@ -3020,6 +3279,16 @@ export declare class ConversationApi extends runtime.BaseAPI implements Conversa
      * Insert an agent MCP server
      */
     insertAgentProfileMcp(requestParameters: InsertAgentProfileMcpRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationMcpServerResponse>;
+    /**
+     * Create a custom status. Enforces a 20-active-status-per-merchant cap and the 50-Twilio-Activity-per-workspace cap.
+     * Create a custom agent status
+     */
+    insertAgentStatusConfigRaw(requestParameters: InsertAgentStatusConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusConfigResponse>>;
+    /**
+     * Create a custom status. Enforces a 20-active-status-per-merchant cap and the 50-Twilio-Activity-per-workspace cap.
+     * Create a custom agent status
+     */
+    insertAgentStatusConfig(requestParameters: InsertAgentStatusConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusConfigResponse>;
     /**
      * Insert a canned message
      * Insert a canned message
@@ -3240,6 +3509,26 @@ export declare class ConversationApi extends runtime.BaseAPI implements Conversa
      * reset statistics within the queue
      */
     resetConversationPbxQueueStatistics(requestParameters: ResetConversationPbxQueueStatisticsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Paginated search over conversation_agent_status_events_all. Filters: agent_user_id, channel, status, trigger, date range.
+     * Search agent status history
+     */
+    searchAgentStatusHistoryRaw(requestParameters: SearchAgentStatusHistoryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusHistorySearchResponse>>;
+    /**
+     * Paginated search over conversation_agent_status_events_all. Filters: agent_user_id, channel, status, trigger, date range.
+     * Search agent status history
+     */
+    searchAgentStatusHistory(requestParameters: SearchAgentStatusHistoryRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusHistorySearchResponse>;
+    /**
+     * Aggregated over conversation_agent_status_events_all via date_histogram + terms. Returns one row per (agent, day, channel).
+     * Search per-(agent, day) rollups
+     */
+    searchAgentStatusRollupsRaw(requestParameters: SearchAgentStatusRollupsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusRollupSearchResponse>>;
+    /**
+     * Aggregated over conversation_agent_status_events_all via date_histogram + terms. Returns one row per (agent, day, channel).
+     * Search per-(agent, day) rollups
+     */
+    searchAgentStatusRollups(requestParameters: SearchAgentStatusRollupsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusRollupSearchResponse>;
     /**
      * Search for canned messages by short_code
      * Search for canned messages by short_code
@@ -3310,6 +3599,16 @@ export declare class ConversationApi extends runtime.BaseAPI implements Conversa
      * Update an agent MCP server
      */
     updateAgentProfileMcp(requestParameters: UpdateAgentProfileMcpRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationMcpServerResponse>;
+    /**
+     * Update a custom status. Renaming flows through to the Twilio Activity.
+     * Update a custom agent status
+     */
+    updateAgentStatusConfigRaw(requestParameters: UpdateAgentStatusConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationAgentStatusConfigResponse>>;
+    /**
+     * Update a custom status. Renaming flows through to the Twilio Activity.
+     * Update a custom agent status
+     */
+    updateAgentStatusConfig(requestParameters: UpdateAgentStatusConfigRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationAgentStatusConfigResponse>;
     /**
      * Update a canned message
      * Update a canned message
@@ -3390,6 +3689,16 @@ export declare class ConversationApi extends runtime.BaseAPI implements Conversa
      * Update pbx class of service
      */
     updatePbxClassOfService(requestParameters: UpdatePbxClassOfServiceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationPbxClassOfServiceResponse>;
+    /**
+     * Persists the IANA timezone on the Config#<merchant_id>/default DDB record (creates on first PUT).
+     * Set the merchant default timezone
+     */
+    updatePbxDefaultTimezoneRaw(requestParameters: UpdatePbxDefaultTimezoneRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConversationPbxDefaultTimezoneResponse>>;
+    /**
+     * Persists the IANA timezone on the Config#<merchant_id>/default DDB record (creates on first PUT).
+     * Set the merchant default timezone
+     */
+    updatePbxDefaultTimezone(requestParameters: UpdatePbxDefaultTimezoneRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConversationPbxDefaultTimezoneResponse>;
     /**
      * Update a pbx hardware phone
      * Update pbx hardware phone