samva 0.18.0 → 0.20.0

package/dist/client/types.gen.d.ts

@@ -34,7 +34,7 @@ export type ResourceNotFoundError = {
 export type ExtensionRun = {
     id: string;
     eventId: string;
-    eventType: "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded";
+    eventType: "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded";
     attempt: number;
     startedAt: string;
     durationMs: number;
@@ -49,7 +49,7 @@ export type ExtensionRunList = {
 export type ExtensionRunSummary = {
     id: string;
     eventId: string;
-    eventType: "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded";
+    eventType: "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded";
     attempt: number;
     startedAt: string;
     durationMs: number;
@@ -71,7 +71,7 @@ export type ExtensionInstallation = {
     runtime: "hosted" | "webhook";
     status: "active" | "disabled";
     createdAt: string;
-    events: Array<"mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded">;
+    events: Array<"mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded">;
     permissions: Array<"read" | "update" | "send" | "quarantine.read">;
     sendMode: "send" | "approval";
     scope: {
@@ -115,13 +115,13 @@ export type ExtensionVersionChange = {
 };
 export type UserId = string;
 export type ExtensionPermissionDiff = {
-    added: Array<"permission:read" | "permission:update" | "permission:send" | "permission:quarantine.read" | "event:mailbox.message.received" | "event:mailbox.message.sent" | "event:mailbox.action.pending_approval" | "event:mailbox.message.quarantined" | "event:mailbox.message.released" | "event:mailbox.message.discarded">;
-    removed: Array<"permission:read" | "permission:update" | "permission:send" | "permission:quarantine.read" | "event:mailbox.message.received" | "event:mailbox.message.sent" | "event:mailbox.action.pending_approval" | "event:mailbox.message.quarantined" | "event:mailbox.message.released" | "event:mailbox.message.discarded">;
+    added: Array<"permission:read" | "permission:update" | "permission:send" | "permission:quarantine.read" | "event:mailbox.message.received" | "event:mailbox.message.sent" | "event:mailbox.action.pending_approval" | "event:mailbox.action.resolved" | "event:mailbox.message.quarantined" | "event:mailbox.message.released" | "event:mailbox.message.discarded">;
+    removed: Array<"permission:read" | "permission:update" | "permission:send" | "permission:quarantine.read" | "event:mailbox.message.received" | "event:mailbox.message.sent" | "event:mailbox.action.pending_approval" | "event:mailbox.action.resolved" | "event:mailbox.message.quarantined" | "event:mailbox.message.released" | "event:mailbox.message.discarded">;
 };
 export type OrganizationId = string;
 export type UpgradeExtensionPayload = {
     version?: string | ExtensionVersionId | null | undefined;
-    acceptPermissions?: Array<"permission:read" | "permission:update" | "permission:send" | "permission:quarantine.read" | "event:mailbox.message.received" | "event:mailbox.message.sent" | "event:mailbox.action.pending_approval" | "event:mailbox.message.quarantined" | "event:mailbox.message.released" | "event:mailbox.message.discarded"> | null | undefined;
+    acceptPermissions?: Array<"permission:read" | "permission:update" | "permission:send" | "permission:quarantine.read" | "event:mailbox.message.received" | "event:mailbox.message.sent" | "event:mailbox.action.pending_approval" | "event:mailbox.action.resolved" | "event:mailbox.message.quarantined" | "event:mailbox.message.released" | "event:mailbox.message.discarded"> | null | undefined;
     dryRun?: boolean | null | undefined;
 };
 export type SuccessResponse = {
@@ -170,7 +170,7 @@ export type ExtensionVersion = {
         description?: string | null | undefined;
         version: string;
         runtime: "hosted" | "webhook";
-        events: Array<"mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded">;
+        events: Array<"mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded">;
         permissions: Array<"read" | "update" | "send" | "quarantine.read">;
     };
 };
@@ -210,7 +210,7 @@ export type PublishExtensionVersionPayload = {
         description?: string | null | undefined;
         version: string;
         runtime: "hosted" | "webhook";
-        events: Array<"mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded">;
+        events: Array<"mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded">;
         permissions: Array<"read" | "update" | "send" | "quarantine.read">;
     };
     bundle?: string | null | undefined;
@@ -219,6 +219,26 @@ export type ExtensionPage = {
     items: Array<Extension>;
     nextCursor: string | null;
 };
+export type NamespaceUsage = {
+    namespaceId: NamespaceId;
+    periodStart: string;
+    periodEnd: string;
+    emailCount: number;
+    totalMessages: number;
+};
+export type NamespaceResource = {
+    type: NamespaceResourceType;
+    id: string;
+    namespaceId: NamespaceId | null;
+};
+export type NamespaceResourceType = "domain" | "sender" | "contact" | "template";
+export type AssignNamespaceResourcePayload = {
+    type: NamespaceResourceType;
+    /**
+     * The resource's id, such as `dom_...` for a domain.
+     */
+    resourceId: string;
+};
 export type Namespace = {
     id: NamespaceId;
     name: string;
@@ -369,11 +389,35 @@ export type MailboxNonSendAction = {
     threadId: MailboxThreadId | null;
     draftId: MailboxDraftId | null;
     decision: MailboxActionDecision | null;
+    /**
+     * How a held action's approval ended: who approved, denied, or cancelled it, when, and the denial reason. Null while it waits for approval and for an action that never needed one.
+     */
+    resolution: MailboxActionResolution | null;
     createdAt: string;
     updatedAt: string;
     type: "updateDraft" | "createNote" | "assignThread" | "changeThreadState" | "call" | "extensionRequest";
     state: "proposed" | "allowed" | "approvalRequired" | "policyDenied" | "approved" | "approvalDenied" | "executing" | "executed" | "failed";
 };
+/**
+ * How the action's approval ended.
+ */
+export type MailboxActionResolution = {
+    outcome: "approved" | "denied" | "cancelled";
+    /**
+     * Who resolved the approval.
+     */
+    actor: {
+        kind: "user" | "apiKey" | "extension" | "externalAgent" | "samvaAgent" | "system";
+        id: string;
+        displayName?: string | null | undefined;
+        source: "humanUi" | "externalApi" | "externalAgent" | "extension" | "system";
+    };
+    resolvedAt: string;
+    /**
+     * The denial reason; null for an approval or a cancellation.
+     */
+    reason: string | null;
+};
 export type MailboxSendAction = {
     id: MailboxActionId;
     source: "humanUi" | "externalApi" | "aiSdkTool" | "extension" | "externalAgent" | "samvaManagedAgent" | "system";
@@ -385,6 +429,10 @@ export type MailboxSendAction = {
     threadId: MailboxThreadId | null;
     draftId: MailboxDraftId | null;
     decision: MailboxActionDecision | null;
+    /**
+     * How a held action's approval ended: who approved, denied, or cancelled it, when, and the denial reason. Null while it waits for approval and for an action that never needed one.
+     */
+    resolution: MailboxActionResolution | null;
     createdAt: string;
     updatedAt: string;
     type: "sendMessage" | "reply";
@@ -410,6 +458,11 @@ export type MailboxSendSnapshot = {
     inReplyToMessageId: MessageId | null;
 };
 export type ConversationId = string;
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export type TemplateId = string;
+export type MailboxEndpointId = string;
 export type EmailAttachment = {
     filename: string;
     content?: string | null | undefined;
@@ -457,10 +510,10 @@ export type MailboxSendRefusedError = {
     message: string;
     receipt: MailboxSendReceipt;
 };
-export type MailboxChannelUnsupportedError = {
-    _tag: "MailboxChannelUnsupportedError";
+export type FlagDisabledError = {
+    _tag: "FlagDisabledError";
+    flag: string;
     message: string;
-    channel: string;
 };
 export type MailboxPendingAction = MailboxSendAction | MailboxNonSendAction;
 export type MailboxPendingSendReceipt = {
@@ -505,7 +558,6 @@ export type MailboxDraft = {
     attachments: Array<EmailAttachment>;
 };
 export type MailboxDraftState = "saved" | "locked" | "sent";
-export type MailboxEndpointId = string;
 export type UpdateMailboxDraftPayload = {
     to?: Array<string> | null | undefined;
     cc?: Array<string> | null | null | undefined;
@@ -982,7 +1034,7 @@ export type ApiKeyAccess = {
     resources: ApiKeyResourceAccess;
     mailboxes?: ApiKeyMailboxAccess | null | undefined;
     /**
-     * Confines the key to one namespace: it reaches only that namespace's mailboxes. A key scoped to a namespace or to listed mailboxes holds mailbox access only.
+     * Confines the key to one namespace: it reaches only that namespace's domains, senders, numbers, mailboxes, contacts, templates, and messages, never organization-level ones, and only endpoints that confine to a namespace (others answer 403). It holds grants only on `mailboxes`, `messages`, `email`, `domains`, `contacts`, and `templates`. A key scoped to listed mailboxes holds mailbox access only.
      */
     namespaceId?: NamespaceId | null | undefined;
 };
@@ -1130,7 +1182,7 @@ export type Organization = {
     billingAccountId: string;
     name: string;
     slug: string;
-    countryCode: string;
+    defaultRegion: PhoneRegion | null;
     timezone: string;
     plan: string;
     isActive: boolean;
@@ -1150,6 +1202,10 @@ export type Organization = {
     teamMembersUsed: number;
     messagesResetAt: string | null;
 };
+/**
+ * An ISO 3166-1 alpha-2 region code, such as US or IN.
+ */
+export type PhoneRegion = string;
 export type IanaTimezone = string;
 export type WebhookAttemptId = string;
 export type WebhookDeliveryId = string;
@@ -1210,7 +1266,7 @@ export type WebhookEndpoint = {
     id: WebhookEndpointId;
     name: string;
     url: string;
-    eventTypes: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "message.opened" | "message.clicked" | "contact.created" | "contact.updated" | "contact.deleted" | "contact.subscribed" | "contact.unsubscribed" | "contact.resubscribed" | "conversation.created" | "conversation.updated" | "conversation.archived" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated" | "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded" | "journey.webhook">;
+    eventTypes: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "message.opened" | "message.clicked" | "contact.created" | "contact.updated" | "contact.deleted" | "contact.subscribed" | "contact.unsubscribed" | "contact.resubscribed" | "contact.consent_changed" | "conversation.created" | "conversation.updated" | "conversation.archived" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated" | "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded" | "journey.webhook">;
     channels: Array<"email"> | null;
     mailboxIds: Array<MailboxId> | null;
     namespaceId: NamespaceId | null;
@@ -1224,7 +1280,7 @@ export type WebhookEndpoint = {
 export type UpdateWebhookPayload = {
     name?: string | null | undefined;
     url?: string | null | undefined;
-    eventTypes?: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "message.opened" | "message.clicked" | "contact.created" | "contact.updated" | "contact.deleted" | "contact.subscribed" | "contact.unsubscribed" | "contact.resubscribed" | "conversation.created" | "conversation.updated" | "conversation.archived" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated" | "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded" | "journey.webhook"> | null | undefined;
+    eventTypes?: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "message.opened" | "message.clicked" | "contact.created" | "contact.updated" | "contact.deleted" | "contact.subscribed" | "contact.unsubscribed" | "contact.resubscribed" | "contact.consent_changed" | "conversation.created" | "conversation.updated" | "conversation.archived" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated" | "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded" | "journey.webhook"> | null | undefined;
     channels?: Array<"email"> | null | null | undefined;
     mailboxIds?: [MailboxId, ...Array<MailboxId>] | null | null | undefined;
     namespaceId?: NamespaceId | null | null | undefined;
@@ -1241,7 +1297,7 @@ export type WebhookEndpointListItem = {
     id: WebhookEndpointId;
     name: string;
     url: string;
-    eventTypes: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "message.opened" | "message.clicked" | "contact.created" | "contact.updated" | "contact.deleted" | "contact.subscribed" | "contact.unsubscribed" | "contact.resubscribed" | "conversation.created" | "conversation.updated" | "conversation.archived" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated" | "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded" | "journey.webhook">;
+    eventTypes: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "message.opened" | "message.clicked" | "contact.created" | "contact.updated" | "contact.deleted" | "contact.subscribed" | "contact.unsubscribed" | "contact.resubscribed" | "contact.consent_changed" | "conversation.created" | "conversation.updated" | "conversation.archived" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated" | "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded" | "journey.webhook">;
     channels: Array<"email"> | null;
     mailboxIds: Array<MailboxId> | null;
     namespaceId: NamespaceId | null;
@@ -1263,7 +1319,7 @@ export type WebhookDeliveryCounts = {
 export type CreateWebhookPayload = {
     name: string;
     url: string;
-    eventTypes: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "message.opened" | "message.clicked" | "contact.created" | "contact.updated" | "contact.deleted" | "contact.subscribed" | "contact.unsubscribed" | "contact.resubscribed" | "conversation.created" | "conversation.updated" | "conversation.archived" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated" | "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded" | "journey.webhook">;
+    eventTypes: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "message.opened" | "message.clicked" | "contact.created" | "contact.updated" | "contact.deleted" | "contact.subscribed" | "contact.unsubscribed" | "contact.resubscribed" | "contact.consent_changed" | "conversation.created" | "conversation.updated" | "conversation.archived" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated" | "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded" | "journey.webhook">;
     channels?: Array<"email"> | null | undefined;
     mailboxIds?: [MailboxId, ...Array<MailboxId>] | null | undefined;
     namespaceId?: NamespaceId | null | undefined;
@@ -1338,7 +1394,6 @@ export type BrandList = {
     items: Array<Brand>;
 };
 export type TemplateProjectId = string;
-export type TemplateId = string;
 export type TemplateInputContractId = string;
 export type TemplateInputContractPage = {
     items: Array<{
@@ -1388,6 +1443,10 @@ export type Template = {
     name: string;
     channel: "email";
     projectId: TemplateProjectId;
+    /**
+     * The namespace the template's project belongs to; every entry in a project shares it. Null at organization level. A namespace-scoped key reaches only its own namespace's templates.
+     */
+    namespaceId: NamespaceId | null;
     entryPath: string;
     status: "draft" | "pending" | "approved" | "published" | "rejected" | "archived";
     isActive: boolean;
@@ -1466,6 +1525,10 @@ export type CreateTemplatePayload = {
     description?: string | null | null | undefined;
     category?: "transactional" | "marketing" | "support" | "notification" | "verification" | "reminder" | "alert" | null | null | undefined;
     isActive?: boolean | null | undefined;
+    /**
+     * The namespace the new template project belongs to; the project and every entry added to it share it. Omit for organization level. A namespace-scoped key always creates in its own namespace.
+     */
+    namespaceId?: NamespaceId | null | undefined;
     idempotencyKey: string;
 };
 export type TemplateFamily = {
@@ -1502,6 +1565,10 @@ export type TemplateSummary = {
     name: string;
     channel: "email";
     projectId: TemplateProjectId;
+    /**
+     * The namespace the template's project belongs to; every entry in a project shares it. Null at organization level. A namespace-scoped key reaches only its own namespace's templates.
+     */
+    namespaceId: NamespaceId | null;
     entryPath: string;
     status: "draft" | "pending" | "approved" | "published" | "rejected" | "archived";
     isActive: boolean;
@@ -1517,17 +1584,28 @@ export type AnalyticsQueryError = {
     _tag: "AnalyticsQueryError";
     message: string;
 };
+export type ContactId = string;
 export type UnsubscribeGroupMemberPage = {
     items: Array<{
-        id: string;
-        email: string;
-        contactId: string | null;
+        id: UnsubscribeGroupMemberId;
+        contactId: ContactId;
         source: "link" | "api" | "manual" | "complaint";
         unsubscribedAt: string;
         createdAt: string;
     }>;
     nextCursor: string | null;
 };
+export type UnsubscribeGroupMemberId = string;
+export type UnsubscribeGroupMemberRef = UnsubscribeGroupMemberByContact | UnsubscribeGroupMemberByEmail | UnsubscribeGroupMemberByPhone;
+export type UnsubscribeGroupMemberByPhone = {
+    phone: string;
+};
+export type UnsubscribeGroupMemberByEmail = {
+    email: string;
+};
+export type UnsubscribeGroupMemberByContact = {
+    contactId: ContactId;
+};
 export type UnsubscribeGroupList = {
     items: Array<{
         id: UnsubscribeId;
@@ -1556,7 +1634,6 @@ export type CustomFieldList = {
         updatedAt: string;
     }>;
 };
-export type ContactId = string;
 export type ContactGroupId = string;
 export type ContactGroupMemberPage = {
     items: Array<{
@@ -1580,9 +1657,21 @@ export type ContactGroupMemberPage = {
 };
 export type ContactIdentity = {
     id: ContactIdentityId;
-    channel: "email";
+    type: "email" | "phone";
     identifier: string;
     verified: boolean;
+    channels: Array<ContactIdentityChannel>;
+};
+export type ContactIdentityChannel = {
+    channel: "email";
+    reachability: "unknown" | "reachable" | "unreachable";
+    consent: ContactConsent | null;
+};
+export type ContactConsent = {
+    status: "opted_in" | "opted_out";
+    source: string;
+    capturedAt: string;
+    proof: JsonObject | null;
 };
 export type ContactIdentityId = string;
 export type ContactGroupPage = {
@@ -1614,11 +1703,6 @@ export type DeliveryUnavailableError = {
     message: string;
     retryAfterSeconds: number;
 };
-export type FlagDisabledError = {
-    _tag: "FlagDisabledError";
-    flag: string;
-    message: string;
-};
 export type CampaignFooterRequiredError = {
     _tag: "CampaignFooterRequiredError";
     message: string;
@@ -1688,9 +1772,6 @@ export type JourneyRunTrigger = {
     eventName: string;
     properties: JsonObject;
 };
-export type JsonObject = {
-    [key: string]: JsonValue;
-};
 export type JourneyRunExitReason = "completed" | "goal" | "archived";
 export type JourneyRunStatus = "active" | "paused" | "exited" | "failed";
 export type JourneyId = string;
@@ -2027,12 +2108,13 @@ export type ContactLocation = {
     timezone: string;
 };
 export type ContactIdentityInput = {
-    channel: "email";
+    type: "email" | "phone";
     identifier: string;
     verified?: boolean | null | undefined;
 };
 export type Contact = {
     id: ContactId;
+    namespaceId: NamespaceId | null;
     name: string;
     displayName: string | null;
     avatar: string | null;
@@ -2050,6 +2132,15 @@ export type Contact = {
 export type ContactTags = {
     tags: [string, ...Array<string>];
 };
+export type SetContactConsent = {
+    status: "opted_in" | "opted_out";
+    /**
+     * Where the consent was captured, such as a form URL or a checkout step.
+     */
+    source: string;
+    capturedAt: string;
+    proof?: JsonObject | null | undefined;
+};
 export type ContactProfileUpdate = {
     firstName?: string | null | null | undefined;
     lastName?: string | null | null | undefined;
@@ -2074,6 +2165,7 @@ export type ContactPage = {
 };
 export type ContactSummary = {
     id: ContactId;
+    namespaceId: NamespaceId | null;
     name: string;
     displayName: string | null;
     status: "active" | "paused" | "blocked" | "archived";
@@ -2127,7 +2219,7 @@ export type ConversationContact = {
     name: string;
     displayName: string | null;
     identities: Array<{
-        channel: "email";
+        type: "email" | "phone";
         identifier: string;
         verified: boolean;
     }>;
@@ -2462,6 +2554,10 @@ export type EmailSenderPage = {
         email: string;
         name: string | null;
         domainId: EmailDomainId | null;
+        /**
+         * The namespace the sender belongs to, or null at organization level. A sender on a domain takes the domain's namespace.
+         */
+        namespaceId: NamespaceId | null;
         verificationStatus: "pending" | "verified" | "failed";
         verifiedAt: string | null;
         verificationToken: string | null;
@@ -2583,6 +2679,10 @@ export type EmailDomainDetailed = {
         priority?: number | null | undefined;
     }>;
     verifiedAt: string | null;
+    /**
+     * The namespace the domain belongs to, or null at organization level. Only that namespace's keys and organization-wide callers reach it.
+     */
+    namespaceId: NamespaceId | null;
     isDefault: boolean;
     deliverability: DeliverabilityFacts;
     createdAt: string;
@@ -2716,6 +2816,10 @@ export type EmailDomainPage = {
         phase: "dns-setup" | "provisioning" | "verifying" | "ready" | "degraded" | "failed";
         dkimSelector?: string | null | undefined;
         dkimPublicKey?: string | null | undefined;
+        /**
+         * The namespace the domain belongs to, or null at organization level. Only that namespace's keys and organization-wide callers reach it.
+         */
+        namespaceId: NamespaceId | null;
         isDefault: boolean;
         deliverability: DeliverabilityFacts;
         series: SendsSeries;
@@ -2779,7 +2883,7 @@ export type CampaignRecipientPage = {
         status: "pending" | "dispatching" | "dispatched" | "failed" | "skipped";
         messageId: string | null;
         failureReason: string | null;
-        skippedReason: "unsubscribed" | "blocked" | "suppressed" | "no_identity" | "inactive" | "run_cancelled" | "run_failed" | null;
+        skippedReason: "unsubscribed" | "blocked" | "suppressed" | "opted_out" | "unreachable" | "no_identity" | "inactive" | "run_cancelled" | "run_failed" | null;
         createdAt: string;
         updatedAt: string;
     }>;
@@ -2807,6 +2911,7 @@ export type CampaignRun = {
     dispatchedCount: number;
     failedCount: number;
     skippedCount: number;
+    skippedReasons: Array<CampaignRunSkippedReason>;
     estimatedCompletionAt: string | null;
     failureReason: string | null;
     holdReason: string | null;
@@ -2818,6 +2923,10 @@ export type CampaignRun = {
     createdAt: string;
     updatedAt: string;
 };
+export type CampaignRunSkippedReason = {
+    reason: "unsubscribed" | "blocked" | "suppressed" | "opted_out" | "unreachable" | "no_identity" | "inactive" | "run_cancelled" | "run_failed";
+    count: number;
+};
 export type CampaignPolicy = {
     unsubscribeGroupId?: UnsubscribeId | null | undefined;
     pageSize?: number | null | undefined;
@@ -3122,9 +3231,15 @@ export type MessageDelivery = {
     readAt: string | null;
     failedAt: string | null;
     error: MessageDeliveryError | null;
+    estimatedProviderCost: EstimatedProviderCost | null;
     createdAt: string;
     updatedAt: string;
 };
+export type EstimatedProviderCost = {
+    amount: string;
+    currency: string;
+    billingMode: "pass_through";
+};
 export type MessageDeliveryError = {
     code: string | null;
     message: string | null;
@@ -3200,6 +3315,10 @@ export type MessagesListData = {
         conversationId?: ConversationId | null | undefined;
         contactId?: ContactId | null | undefined;
         from?: string | null | undefined;
+        /**
+         * Only this namespace's messages. A key scoped to a namespace always lists its own.
+         */
+        namespaceId?: NamespaceId | null | undefined;
         after?: string | null | undefined;
         before?: string | null | undefined;
     };
@@ -4981,6 +5100,7 @@ export type EmailListDomainsData = {
         limit?: string | null | undefined;
         cursor?: Cursor | null | undefined;
         sendable?: "true" | null | undefined;
+        namespaceId?: NamespaceId | null | undefined;
     };
     url: "/v1/email/domains";
 };
@@ -5021,6 +5141,7 @@ export type EmailAddDomainData = {
             connectionId: string;
             zone: string;
         } | null | undefined;
+        namespaceId?: NamespaceId | null | undefined;
     };
     path?: never;
     query?: never;
@@ -5039,6 +5160,10 @@ export type EmailAddDomainErrors = {
      * ForbiddenError
      */
     403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
     /**
      * ConflictError
      */
@@ -5328,6 +5453,10 @@ export type EmailDetectRegistrarErrors = {
      * ForbiddenError
      */
     403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
     /**
      * ValidationError
      */
@@ -5708,6 +5837,10 @@ export type EmailDisableCustomTrackingErrors = {
      * ForbiddenError
      */
     403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
     /**
      * ConflictError
      */
@@ -5754,6 +5887,10 @@ export type EmailGetCustomTrackingErrors = {
      * ForbiddenError
      */
     403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
     /**
      * ValidationError
      */
@@ -5794,6 +5931,10 @@ export type EmailEnableCustomTrackingErrors = {
      * ForbiddenError
      */
     403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
     /**
      * ConflictError
      */
@@ -5986,6 +6127,10 @@ export type EmailCompleteCustomTrackingDomainConnectErrors = {
      * ForbiddenError
      */
     403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
     /**
      * ValidationError
      */
@@ -6016,6 +6161,7 @@ export type EmailListSendersData = {
         verificationStatus?: "pending" | "verified" | "failed" | null | undefined;
         isActive?: string | null | undefined;
         isDefault?: string | null | undefined;
+        namespaceId?: NamespaceId | null | undefined;
     };
     url: "/v1/email/senders";
 };
@@ -6055,6 +6201,7 @@ export type EmailAddSenderData = {
         domainId?: EmailDomainId | null | undefined;
         name?: string | null | null | undefined;
         replyToEmails?: Array<string> | null | null | undefined;
+        namespaceId?: NamespaceId | null | undefined;
     };
     headers: {
         "idempotency-key": string;
@@ -6250,6 +6397,10 @@ export type EmailGetSenderResponses = {
         email: string;
         name: string | null;
         domainId: EmailDomainId | null;
+        /**
+         * The namespace the sender belongs to, or null at organization level. A sender on a domain takes the domain's namespace.
+         */
+        namespaceId: NamespaceId | null;
         verificationStatus: "pending" | "verified" | "failed";
         verifiedAt: string | null;
         verificationToken: string | null;
@@ -8605,6 +8756,7 @@ export type ContactsListData = {
     query?: {
         limit?: string | null | undefined;
         cursor?: Cursor | null | undefined;
+        namespaceId?: NamespaceId | null | undefined;
         search?: string | null | undefined;
         status?: "active" | "paused" | "blocked" | "archived" | null | undefined;
         fields?: string | null | undefined;
@@ -8647,6 +8799,7 @@ export type ContactsListResponses = {
 export type ContactsListResponse = ContactsListResponses[keyof ContactsListResponses];
 export type ContactsCreateData = {
     body: {
+        namespaceId?: NamespaceId | null | undefined;
         name: string;
         displayName?: string | null | null | undefined;
         avatar?: string | null | null | undefined;
@@ -8676,6 +8829,10 @@ export type ContactsCreateErrors = {
      * ForbiddenError
      */
     403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
     /**
      * ConflictError
      */
@@ -8707,6 +8864,7 @@ export type ContactsCreateResponses = {
 export type ContactsCreateResponse = ContactsCreateResponses[keyof ContactsCreateResponses];
 export type ContactsFindData = {
     body: {
+        namespaceId?: NamespaceId | null | undefined;
         email?: string | null | undefined;
         phone?: string | null | undefined;
         externalId?: string | null | undefined;
@@ -8724,6 +8882,10 @@ export type ContactsFindErrors = {
      * ForbiddenError
      */
     403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
     /**
      * ConflictError
      */
@@ -8751,6 +8913,7 @@ export type ContactsFindResponses = {
 export type ContactsFindResponse = ContactsFindResponses[keyof ContactsFindResponses];
 export type ContactsFindOrCreateData = {
     body: {
+        namespaceId?: NamespaceId | null | undefined;
         lookup: ContactLookup;
         create?: {
             name?: string | null | undefined;
@@ -8778,6 +8941,10 @@ export type ContactsFindOrCreateErrors = {
      * ForbiddenError
      */
     403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
     /**
      * ConflictError
      */
@@ -8962,7 +9129,7 @@ export type ContactsUpdateResponses = {
 export type ContactsUpdateResponse = ContactsUpdateResponses[keyof ContactsUpdateResponses];
 export type ContactsAddIdentityData = {
     body: {
-        channel: "email";
+        type: "email" | "phone";
         identifier: string;
         verified?: boolean | null | undefined;
     };
@@ -9053,6 +9220,58 @@ export type ContactsRemoveIdentityResponses = {
     200: Contact;
 };
 export type ContactsRemoveIdentityResponse = ContactsRemoveIdentityResponses[keyof ContactsRemoveIdentityResponses];
+export type ContactsSetConsentData = {
+    body: {
+        status: "opted_in" | "opted_out";
+        /**
+         * Where the consent was captured, such as a form URL or a checkout step.
+         */
+        source: string;
+        capturedAt: string;
+        proof?: JsonObject | null | undefined;
+    };
+    path: {
+        id: ContactId;
+        identityId: ContactIdentityId;
+        channel: "email";
+    };
+    query?: never;
+    url: "/v1/contacts/{id}/identities/{identityId}/consent/{channel}";
+};
+export type ContactsSetConsentErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
+    /**
+     * ValidationError
+     */
+    422: ValidationError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+    /**
+     * GatewayTimeoutError
+     */
+    504: GatewayTimeoutError;
+};
+export type ContactsSetConsentError = ContactsSetConsentErrors[keyof ContactsSetConsentErrors];
+export type ContactsSetConsentResponses = {
+    /**
+     * Contact
+     */
+    200: Contact;
+};
+export type ContactsSetConsentResponse = ContactsSetConsentResponses[keyof ContactsSetConsentResponses];
 export type ContactsRemoveTagsData = {
     body: {
         tags: [string, ...Array<string>];
@@ -9194,6 +9413,7 @@ export type ContactsGetEngagementResponses = {
 export type ContactsGetEngagementResponse = ContactsGetEngagementResponses[keyof ContactsGetEngagementResponses];
 export type ContactsBulkImportData = {
     body: {
+        namespaceId?: NamespaceId | null | undefined;
         contacts: Array<{
             name: string;
             displayName?: string | null | null | undefined;
@@ -9226,6 +9446,10 @@ export type ContactsBulkImportErrors = {
      * ForbiddenError
      */
     403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
     /**
      * ValidationError
      */
@@ -9738,9 +9962,9 @@ export type JourneysCreateErrors = {
      */
     402: PaymentRequiredError;
     /**
-     * ForbiddenError
+     * FlagDisabledError | ForbiddenError
      */
-    403: ForbiddenError;
+    403: FlagDisabledError | ForbiddenError;
     /**
      * ResourceNotFoundError
      */
@@ -9927,9 +10151,9 @@ export type JourneysReplaceDraftErrors = {
      */
     402: PaymentRequiredError;
     /**
-     * ForbiddenError
+     * FlagDisabledError | ForbiddenError
      */
-    403: ForbiddenError;
+    403: FlagDisabledError | ForbiddenError;
     /**
      * ResourceNotFoundError
      */
@@ -9983,9 +10207,9 @@ export type JourneysPublishErrors = {
      */
     402: PaymentRequiredError;
     /**
-     * ForbiddenError
+     * FlagDisabledError | ForbiddenError
      */
-    403: ForbiddenError;
+    403: FlagDisabledError | ForbiddenError;
     /**
      * ResourceNotFoundError
      */
@@ -10083,9 +10307,9 @@ export type JourneysResumeErrors = {
      */
     402: PaymentRequiredError;
     /**
-     * ForbiddenError
+     * FlagDisabledError | ForbiddenError
      */
-    403: ForbiddenError;
+    403: FlagDisabledError | ForbiddenError;
     /**
      * ResourceNotFoundError
      */
@@ -11389,9 +11613,9 @@ export type UnsubscribeSetDefaultResponses = {
     };
 };
 export type UnsubscribeSetDefaultResponse = UnsubscribeSetDefaultResponses[keyof UnsubscribeSetDefaultResponses];
-export type UnsubscribeRemoveEmailsData = {
+export type UnsubscribeRemoveMembersData = {
     body: {
-        emails: Array<string>;
+        members: Array<UnsubscribeGroupMemberRef>;
     };
     path: {
         id: UnsubscribeId;
@@ -11399,7 +11623,7 @@ export type UnsubscribeRemoveEmailsData = {
     query?: never;
     url: "/v1/unsubscribe-groups/{id}/members";
 };
-export type UnsubscribeRemoveEmailsErrors = {
+export type UnsubscribeRemoveMembersErrors = {
     /**
      * UnauthorizedError
      */
@@ -11425,8 +11649,8 @@ export type UnsubscribeRemoveEmailsErrors = {
      */
     504: GatewayTimeoutError;
 };
-export type UnsubscribeRemoveEmailsError = UnsubscribeRemoveEmailsErrors[keyof UnsubscribeRemoveEmailsErrors];
-export type UnsubscribeRemoveEmailsResponses = {
+export type UnsubscribeRemoveMembersError = UnsubscribeRemoveMembersErrors[keyof UnsubscribeRemoveMembersErrors];
+export type UnsubscribeRemoveMembersResponses = {
     /**
      * Success
      */
@@ -11434,7 +11658,7 @@ export type UnsubscribeRemoveEmailsResponses = {
         removed: number;
     };
 };
-export type UnsubscribeRemoveEmailsResponse = UnsubscribeRemoveEmailsResponses[keyof UnsubscribeRemoveEmailsResponses];
+export type UnsubscribeRemoveMembersResponse = UnsubscribeRemoveMembersResponses[keyof UnsubscribeRemoveMembersResponses];
 export type UnsubscribeListMembersData = {
     body?: never;
     path: {
@@ -11480,9 +11704,9 @@ export type UnsubscribeListMembersResponses = {
     200: UnsubscribeGroupMemberPage;
 };
 export type UnsubscribeListMembersResponse = UnsubscribeListMembersResponses[keyof UnsubscribeListMembersResponses];
-export type UnsubscribeAddEmailsData = {
+export type UnsubscribeAddMembersData = {
     body: {
-        emails: Array<string>;
+        members: Array<UnsubscribeGroupMemberRef>;
         source?: "link" | "api" | "manual" | "complaint" | null | undefined;
     };
     path: {
@@ -11491,11 +11715,15 @@ export type UnsubscribeAddEmailsData = {
     query?: never;
     url: "/v1/unsubscribe-groups/{id}/members";
 };
-export type UnsubscribeAddEmailsErrors = {
+export type UnsubscribeAddMembersErrors = {
     /**
      * UnauthorizedError
      */
     401: UnauthorizedError;
+    /**
+     * PaymentRequiredError
+     */
+    402: PaymentRequiredError;
     /**
      * ForbiddenError
      */
@@ -11512,13 +11740,17 @@ export type UnsubscribeAddEmailsErrors = {
      * InternalError
      */
     500: InternalError;
+    /**
+     * BillingProviderError
+     */
+    502: BillingProviderError;
     /**
      * GatewayTimeoutError
      */
     504: GatewayTimeoutError;
 };
-export type UnsubscribeAddEmailsError = UnsubscribeAddEmailsErrors[keyof UnsubscribeAddEmailsErrors];
-export type UnsubscribeAddEmailsResponses = {
+export type UnsubscribeAddMembersError = UnsubscribeAddMembersErrors[keyof UnsubscribeAddMembersErrors];
+export type UnsubscribeAddMembersResponses = {
     /**
      * Success
      */
@@ -11527,12 +11759,14 @@ export type UnsubscribeAddEmailsResponses = {
         skipped: number;
     };
 };
-export type UnsubscribeAddEmailsResponse = UnsubscribeAddEmailsResponses[keyof UnsubscribeAddEmailsResponses];
+export type UnsubscribeAddMembersResponse = UnsubscribeAddMembersResponses[keyof UnsubscribeAddMembersResponses];
 export type UnsubscribeCheckSubscriptionData = {
     body?: never;
     path?: never;
-    query: {
-        email: string;
+    query?: {
+        contactId?: ContactId | null | undefined;
+        email?: string | null | undefined;
+        phone?: string | null | undefined;
         groupIds?: string | null | undefined;
     };
     url: "/v1/unsubscribe-groups/check";
@@ -11565,7 +11799,7 @@ export type UnsubscribeCheckSubscriptionResponses = {
      * Success
      */
     200: {
-        email: string;
+        contactId: ContactId | null;
         unsubscribedGroups: Array<{
             groupId: string;
             groupName: string;
@@ -11885,6 +12119,10 @@ export type TemplatesListData = {
         status?: "draft" | "pending" | "approved" | "published" | "rejected" | "archived" | null | undefined;
         search?: string | null | undefined;
         projectId?: TemplateProjectId | null | undefined;
+        /**
+         * Only templates in this namespace. A namespace-scoped key lists its own namespace's templates only.
+         */
+        namespaceId?: NamespaceId | null | undefined;
     };
     url: "/v1/templates";
 };
@@ -11928,6 +12166,10 @@ export type TemplatesCreateData = {
         description?: string | null | null | undefined;
         category?: "transactional" | "marketing" | "support" | "notification" | "verification" | "reminder" | "alert" | null | null | undefined;
         isActive?: boolean | null | undefined;
+        /**
+         * The namespace the new template project belongs to; the project and every entry added to it share it. Omit for organization level. A namespace-scoped key always creates in its own namespace.
+         */
+        namespaceId?: NamespaceId | null | undefined;
         idempotencyKey: string;
     };
     path?: never;
@@ -11943,6 +12185,10 @@ export type TemplatesCreateErrors = {
      * ForbiddenError
      */
     403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
     /**
      * ConflictError
      */
@@ -14781,7 +15027,7 @@ export type WebhooksCreateData = {
     body: {
         name: string;
         url: string;
-        eventTypes: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "message.opened" | "message.clicked" | "contact.created" | "contact.updated" | "contact.deleted" | "contact.subscribed" | "contact.unsubscribed" | "contact.resubscribed" | "conversation.created" | "conversation.updated" | "conversation.archived" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated" | "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded" | "journey.webhook">;
+        eventTypes: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "message.opened" | "message.clicked" | "contact.created" | "contact.updated" | "contact.deleted" | "contact.subscribed" | "contact.unsubscribed" | "contact.resubscribed" | "contact.consent_changed" | "conversation.created" | "conversation.updated" | "conversation.archived" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated" | "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded" | "journey.webhook">;
         channels?: Array<"email"> | null | undefined;
         mailboxIds?: [MailboxId, ...Array<MailboxId>] | null | undefined;
         namespaceId?: NamespaceId | null | undefined;
@@ -14935,7 +15181,7 @@ export type WebhooksUpdateData = {
     body: {
         name?: string | null | undefined;
         url?: string | null | undefined;
-        eventTypes?: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "message.opened" | "message.clicked" | "contact.created" | "contact.updated" | "contact.deleted" | "contact.subscribed" | "contact.unsubscribed" | "contact.resubscribed" | "conversation.created" | "conversation.updated" | "conversation.archived" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated" | "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded" | "journey.webhook"> | null | undefined;
+        eventTypes?: Array<"message.sent" | "message.delivered" | "message.read" | "message.failed" | "message.bounced" | "message.complained" | "message.received" | "message.opened" | "message.clicked" | "contact.created" | "contact.updated" | "contact.deleted" | "contact.subscribed" | "contact.unsubscribed" | "contact.resubscribed" | "contact.consent_changed" | "conversation.created" | "conversation.updated" | "conversation.archived" | "webhook.created" | "webhook.updated" | "webhook.deleted" | "webhook.test" | "domain.updated" | "domain.warming.updated" | "mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded" | "journey.webhook"> | null | undefined;
         channels?: Array<"email"> | null | null | undefined;
         mailboxIds?: [MailboxId, ...Array<MailboxId>] | null | null | undefined;
         namespaceId?: NamespaceId | null | null | undefined;
@@ -15314,7 +15560,7 @@ export type OrganizationsUpdateData = {
     body: {
         name?: string | null | undefined;
         slug?: string | null | undefined;
-        countryCode?: string | null | undefined;
+        defaultRegion?: PhoneRegion | null | null | undefined;
         timezone?: IanaTimezone | null | undefined;
         isActive?: boolean | null | undefined;
         metadata?: {
@@ -16102,9 +16348,9 @@ export type MailboxesCreateErrors = {
      */
     402: PaymentRequiredError;
     /**
-     * ForbiddenError
+     * FlagDisabledError | ForbiddenError
      */
-    403: ForbiddenError;
+    403: FlagDisabledError | ForbiddenError;
     /**
      * ResourceNotFoundError
      */
@@ -16114,9 +16360,9 @@ export type MailboxesCreateErrors = {
      */
     409: ConflictError;
     /**
-     * ValidationError | MailboxChannelUnsupportedError
+     * ValidationError
      */
-    422: ValidationError | MailboxChannelUnsupportedError;
+    422: ValidationError;
     /**
      * InternalError
      */
@@ -16289,9 +16535,9 @@ export type MailboxesCreateEndpointErrors = {
      */
     401: UnauthorizedError;
     /**
-     * ForbiddenError
+     * FlagDisabledError | ForbiddenError
      */
-    403: ForbiddenError;
+    403: FlagDisabledError | ForbiddenError;
     /**
      * ResourceNotFoundError
      */
@@ -16301,9 +16547,9 @@ export type MailboxesCreateEndpointErrors = {
      */
     409: ConflictError;
     /**
-     * ValidationError | MailboxChannelUnsupportedError
+     * ValidationError
      */
-    422: ValidationError | MailboxChannelUnsupportedError;
+    422: ValidationError;
     /**
      * InternalError
      */
@@ -17724,9 +17970,9 @@ export type MailboxesSendMessageErrors = {
      */
     402: PaymentRequiredError;
     /**
-     * MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
+     * FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
      */
-    403: MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
+    403: FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
     /**
      * ResourceNotFoundError
      */
@@ -17736,9 +17982,9 @@ export type MailboxesSendMessageErrors = {
      */
     409: MailboxSendConflictError | ConflictError;
     /**
-     * MailboxChannelUnsupportedError | ValidationError
+     * Samva API operation.
      */
-    422: MailboxChannelUnsupportedError | ValidationError;
+    422: ValidationError;
     /**
      * RateLimitedError
      */
@@ -17979,9 +18225,9 @@ export type MailboxesReplyErrors = {
      */
     402: PaymentRequiredError;
     /**
-     * MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
+     * FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
      */
-    403: MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
+    403: FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
     /**
      * ResourceNotFoundError
      */
@@ -17991,9 +18237,9 @@ export type MailboxesReplyErrors = {
      */
     409: MailboxSendConflictError | ConflictError;
     /**
-     * MailboxChannelUnsupportedError | ValidationError
+     * Samva API operation.
      */
-    422: MailboxChannelUnsupportedError | ValidationError;
+    422: ValidationError;
     /**
      * RateLimitedError
      */
@@ -18056,9 +18302,9 @@ export type MailboxesReplyAllErrors = {
      */
     402: PaymentRequiredError;
     /**
-     * MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
+     * FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
      */
-    403: MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
+    403: FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
     /**
      * ResourceNotFoundError
      */
@@ -18068,9 +18314,9 @@ export type MailboxesReplyAllErrors = {
      */
     409: MailboxSendConflictError | ConflictError;
     /**
-     * MailboxChannelUnsupportedError | ValidationError
+     * Samva API operation.
      */
-    422: MailboxChannelUnsupportedError | ValidationError;
+    422: ValidationError;
     /**
      * RateLimitedError
      */
@@ -18133,9 +18379,9 @@ export type MailboxesForwardErrors = {
      */
     402: PaymentRequiredError;
     /**
-     * MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
+     * FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
      */
-    403: MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
+    403: FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
     /**
      * ResourceNotFoundError
      */
@@ -18145,9 +18391,9 @@ export type MailboxesForwardErrors = {
      */
     409: MailboxSendConflictError | ConflictError;
     /**
-     * MailboxChannelUnsupportedError | ValidationError
+     * Samva API operation.
      */
-    422: MailboxChannelUnsupportedError | ValidationError;
+    422: ValidationError;
     /**
      * RateLimitedError
      */
@@ -18406,9 +18652,9 @@ export type MailboxesCreateDraftErrors = {
      */
     404: ResourceNotFoundError;
     /**
-     * MailboxChannelUnsupportedError | ValidationError
+     * ValidationError
      */
-    422: MailboxChannelUnsupportedError | ValidationError;
+    422: ValidationError;
     /**
      * InternalError
      */
@@ -18590,9 +18836,9 @@ export type MailboxesSendDraftErrors = {
      */
     402: PaymentRequiredError;
     /**
-     * MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
+     * FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
      */
-    403: MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
+    403: FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
     /**
      * ResourceNotFoundError
      */
@@ -18602,9 +18848,9 @@ export type MailboxesSendDraftErrors = {
      */
     409: MailboxSendConflictError | ConflictError;
     /**
-     * MailboxChannelUnsupportedError | ValidationError
+     * Samva API operation.
      */
-    422: MailboxChannelUnsupportedError | ValidationError;
+    422: ValidationError;
     /**
      * RateLimitedError
      */
@@ -18749,9 +18995,9 @@ export type MailboxesCancelActionErrors = {
      */
     402: PaymentRequiredError;
     /**
-     * MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
+     * FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
      */
-    403: MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
+    403: FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
     /**
      * ResourceNotFoundError
      */
@@ -18761,9 +19007,9 @@ export type MailboxesCancelActionErrors = {
      */
     409: MailboxSendConflictError | ConflictError;
     /**
-     * MailboxChannelUnsupportedError | ValidationError
+     * Samva API operation.
      */
-    422: MailboxChannelUnsupportedError | ValidationError;
+    422: ValidationError;
     /**
      * RateLimitedError
      */
@@ -18816,9 +19062,9 @@ export type MailboxesRetryActionErrors = {
      */
     402: PaymentRequiredError;
     /**
-     * MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
+     * FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
      */
-    403: MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
+    403: FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
     /**
      * ResourceNotFoundError
      */
@@ -18828,9 +19074,9 @@ export type MailboxesRetryActionErrors = {
      */
     409: MailboxSendConflictError | ConflictError;
     /**
-     * MailboxChannelUnsupportedError | ValidationError
+     * Samva API operation.
      */
-    422: MailboxChannelUnsupportedError | ValidationError;
+    422: ValidationError;
     /**
      * RateLimitedError
      */
@@ -18883,9 +19129,9 @@ export type MailboxesApproveActionErrors = {
      */
     402: PaymentRequiredError;
     /**
-     * MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
+     * FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError
      */
-    403: MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
+    403: FlagDisabledError | MailboxSendRefusedError | OnboardingReviewRequiredError | ForbiddenError;
     /**
      * ResourceNotFoundError
      */
@@ -18895,9 +19141,9 @@ export type MailboxesApproveActionErrors = {
      */
     409: MailboxSendConflictError | ConflictError;
     /**
-     * MailboxChannelUnsupportedError | ValidationError
+     * Samva API operation.
      */
-    422: MailboxChannelUnsupportedError | ValidationError;
+    422: ValidationError;
     /**
      * RateLimitedError
      */
@@ -19250,6 +19496,151 @@ export type NamespacesUpdateResponses = {
     200: Namespace;
 };
 export type NamespacesUpdateResponse = NamespacesUpdateResponses[keyof NamespacesUpdateResponses];
+export type NamespacesAssignResourceData = {
+    body: {
+        type: NamespaceResourceType;
+        /**
+         * The resource's id, such as `dom_...` for a domain.
+         */
+        resourceId: string;
+    };
+    path: {
+        id: NamespaceId;
+    };
+    query?: never;
+    url: "/v1/namespaces/{id}/resources";
+};
+export type NamespacesAssignResourceErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
+    /**
+     * ConflictError
+     */
+    409: ConflictError;
+    /**
+     * ValidationError
+     */
+    422: ValidationError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+    /**
+     * GatewayTimeoutError
+     */
+    504: GatewayTimeoutError;
+};
+export type NamespacesAssignResourceError = NamespacesAssignResourceErrors[keyof NamespacesAssignResourceErrors];
+export type NamespacesAssignResourceResponses = {
+    /**
+     * NamespaceResource
+     */
+    200: NamespaceResource;
+};
+export type NamespacesAssignResourceResponse = NamespacesAssignResourceResponses[keyof NamespacesAssignResourceResponses];
+export type NamespacesRemoveResourceData = {
+    body?: never;
+    path: {
+        id: NamespaceId;
+        type: NamespaceResourceType;
+        resourceId: string;
+    };
+    query?: never;
+    url: "/v1/namespaces/{id}/resources/{type}/{resourceId}";
+};
+export type NamespacesRemoveResourceErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
+    /**
+     * ConflictError
+     */
+    409: ConflictError;
+    /**
+     * ValidationError
+     */
+    422: ValidationError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+    /**
+     * GatewayTimeoutError
+     */
+    504: GatewayTimeoutError;
+};
+export type NamespacesRemoveResourceError = NamespacesRemoveResourceErrors[keyof NamespacesRemoveResourceErrors];
+export type NamespacesRemoveResourceResponses = {
+    /**
+     * NamespaceResource
+     */
+    200: NamespaceResource;
+};
+export type NamespacesRemoveResourceResponse = NamespacesRemoveResourceResponses[keyof NamespacesRemoveResourceResponses];
+export type NamespacesGetUsageData = {
+    body?: never;
+    path: {
+        id: NamespaceId;
+    };
+    query?: {
+        after?: string | null | undefined;
+        before?: string | null | undefined;
+    };
+    url: "/v1/namespaces/{id}/usage";
+};
+export type NamespacesGetUsageErrors = {
+    /**
+     * UnauthorizedError
+     */
+    401: UnauthorizedError;
+    /**
+     * ForbiddenError
+     */
+    403: ForbiddenError;
+    /**
+     * ResourceNotFoundError
+     */
+    404: ResourceNotFoundError;
+    /**
+     * ValidationError
+     */
+    422: ValidationError;
+    /**
+     * InternalError
+     */
+    500: InternalError;
+    /**
+     * GatewayTimeoutError
+     */
+    504: GatewayTimeoutError;
+};
+export type NamespacesGetUsageError = NamespacesGetUsageErrors[keyof NamespacesGetUsageErrors];
+export type NamespacesGetUsageResponses = {
+    /**
+     * NamespaceUsage
+     */
+    200: NamespaceUsage;
+};
+export type NamespacesGetUsageResponse = NamespacesGetUsageResponses[keyof NamespacesGetUsageResponses];
 export type ExtensionsListData = {
     body?: never;
     path?: never;
@@ -19303,7 +19694,7 @@ export type ExtensionsPublishData = {
             description?: string | null | undefined;
             version: string;
             runtime: "hosted" | "webhook";
-            events: Array<"mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded">;
+            events: Array<"mailbox.message.received" | "mailbox.message.sent" | "mailbox.action.pending_approval" | "mailbox.action.resolved" | "mailbox.message.quarantined" | "mailbox.message.released" | "mailbox.message.discarded">;
             permissions: Array<"read" | "update" | "send" | "quarantine.read">;
         };
         bundle?: string | null | undefined;
@@ -19680,7 +20071,7 @@ export type ExtensionInstallationsGetResponse = ExtensionInstallationsGetRespons
 export type ExtensionInstallationsUpgradeData = {
     body: {
         version?: string | ExtensionVersionId | null | undefined;
-        acceptPermissions?: Array<"permission:read" | "permission:update" | "permission:send" | "permission:quarantine.read" | "event:mailbox.message.received" | "event:mailbox.message.sent" | "event:mailbox.action.pending_approval" | "event:mailbox.message.quarantined" | "event:mailbox.message.released" | "event:mailbox.message.discarded"> | null | undefined;
+        acceptPermissions?: Array<"permission:read" | "permission:update" | "permission:send" | "permission:quarantine.read" | "event:mailbox.message.received" | "event:mailbox.message.sent" | "event:mailbox.action.pending_approval" | "event:mailbox.action.resolved" | "event:mailbox.message.quarantined" | "event:mailbox.message.released" | "event:mailbox.message.discarded"> | null | undefined;
         dryRun?: boolean | null | undefined;
     };
     path: {