@signalhousellc/sdk 1.1.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signalhousellc/sdk",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Signal House SDK for use with the Signal House platform",
   "type": "module",
   "main": "src/SignalHouseSDK.js",

package/src/SignalHouseSDK.js

@@ -4,6 +4,7 @@ import axios from "axios";
  * @typedef {Object} RequestOptions
  * @property {string} [token] - An optional bearer token to include in the request for authentication
  * @property {object} [headers] - Additional headers to include in the request
+ * @property {string} [idempotencyKey] - Sent as the Idempotency-Key header; a retry with the same key and request replays the first response instead of repeating it
  */
 
 /**
@@ -103,10 +104,12 @@ export class SignalHouseSDK {
 		const instance = axios.create({ baseURL: this.baseUrl, headers: isMultipart ? {} : { "Content-Type": "application/json" } });
 
 		// Add a request interceptor to include the API key in the Authorization header
-		instance.interceptors.request.use((/** @type {import('axios').InternalAxiosRequestConfig & { token?: string }} */ config) => {
+		instance.interceptors.request.use((/** @type {import('axios').InternalAxiosRequestConfig & { token?: string, idempotencyKey?: string }} */ config) => {
 			const token = config.token || this.apiKey;
 			config.headers.Authorization = `Bearer ${token}`;
+			if (config.idempotencyKey) config.headers["Idempotency-Key"] = config.idempotencyKey;
 			delete config.token; // Remove token from config to avoid sending it as a header
+			delete config.idempotencyKey;
 			return config;
 		});
 

package/src/domains/Agents.js

@@ -67,6 +67,57 @@
  * @property {string} updatedAt - Last-update timestamp.
  */
 
+/**
+ * The fields of an endpoint binding: which agent answers a number.
+ * @typedef {Object} AgentEndpointData
+ * @property {string} agentProfileId - The agent that answers the number (required). It must be active, in the number's group, and either belong to the number's subgroup or be a group-level agent with an enabled deployment there.
+ * @property {string} [answerMode] - Which inbound messages the agent answers: "all_inbound" (the only mode, and the default).
+ */
+
+/**
+ * An endpoint binding (which agent answers a number), as returned by the server.
+ * @typedef {Object} AgentEndpoint
+ * @property {string} agentEndpointId - The binding id ("AEP..." prefix).
+ * @property {string} groupId - The group that owns the binding.
+ * @property {string|null} subgroupId - The subgroup the number belongs to.
+ * @property {string} channel - The channel; "sms" in v1.
+ * @property {string} endpointType - The endpoint kind; "sms_number" in v1.
+ * @property {string} endpointValue - The phone number: digits only, country code included, no "+".
+ * @property {string} agentProfileId - The agent that answers the number.
+ * @property {string} answerMode - Which inbound messages the agent answers ("all_inbound").
+ * @property {Object|null} overrides - Free-form per-endpoint overrides; null when none.
+ * @property {boolean} enabled - Whether the binding is live.
+ * @property {string} createdAt - Creation timestamp.
+ * @property {string} updatedAt - Last-update timestamp.
+ */
+
+/**
+ * A reply an SMS agent wrote but did not send, held for a person to approve or reject (the
+ * Pending Replies queue), as returned by the server.
+ * @typedef {Object} AgentReplyDraft
+ * @property {string} agentReplyDraftId - The draft id ("ARD..." prefix).
+ * @property {string} groupId - The group that owns the draft.
+ * @property {string|null} subgroupId - The subgroup whose number the reply goes out from.
+ * @property {string} agentProfileId - The agent that wrote the reply.
+ * @property {string|null} conversationId - The conversation the reply belongs to.
+ * @property {string} channel - The channel; "sms".
+ * @property {string} endpointValue - The agent's number the reply is sent from, digits only.
+ * @property {string} contactPhoneNumber - The contact the reply is sent to, digits only.
+ * @property {string} inboundText - The contact message the agent was answering.
+ * @property {string} draftText - The reply as the agent wrote it.
+ * @property {string|null} sentText - The text actually sent; differs from draftText when edited.
+ * @property {string} reason - Why it was held: "review_mode", "escalation", "fallback" or "guardrail".
+ * @property {string} status - "pending", "sending", "sent", "rejected" or "failed" (the send path accepted nothing, e.g. the contact opted out).
+ * @property {string|null} decidedBy - The user who approved or rejected it.
+ * @property {string|null} decidedAt - When it was approved or rejected.
+ * @property {string|null} sentMessageId - The outbound message id once sent (for an external delivery, the id you reported).
+ * @property {string|null} claimId - The current claim's id (set when a decision claims the draft); complete and release must name it.
+ * @property {string|null} deliveredBy - Who delivers an approved reply: "signalhouse" (approveAgentReplyDraft) or "external" (claimAgentReplyDraft); null until decided.
+ * @property {string|null} failureReason - "delivery_unconfirmed" when an external claim was never completed or released; otherwise null.
+ * @property {string} createdAt - Creation timestamp.
+ * @property {string} updatedAt - Last-update timestamp.
+ */
+
 /**
  * The per-channel settings for one agent. Model, voice and sampling settings live here rather
  * than on the profile: each channel is served by a different runtime, and the model catalogues
@@ -458,6 +509,186 @@ export class Agents {
 		return this.client(`/agent/profiles/${safeId}/deployments/${safeSubgroupId}`, { method: "DELETE", ...options });
 	}
 
+	/**
+	 * List the endpoint bindings (which agent answers which number) in a group.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for listing endpoint bindings.
+	 * @param {string} params.groupId - The group whose bindings to list (required).
+	 * @param {string} [params.subgroupId] - Narrow to one subgroup's bindings.
+	 * @param {string} [params.agentProfileId] - Narrow to one agent's bindings.
+	 * @param {string} [params.channel] - Narrow to one channel ("sms").
+	 * @param {RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the groupId parameter is missing.
+	 * @returns {Promise<SdkResponse<AgentEndpoint[]>>} - The bindings, ordered by number, returned from the server.
+	 */
+	async getAgentEndpoints({ groupId, subgroupId, agentProfileId, channel, options = {} }) {
+		this.client._require({ groupId });
+		const queryString = this.client._getQueryString({ groupId, subgroupId, agentProfileId, channel });
+		return this.client(`/agent/endpoints${queryString}`, { method: "GET", ...options });
+	}
+
+	/**
+	 * Assign an agent to answer a number (upsert keyed by channel + number). Assigning again
+	 * replaces the previous agent, so a number has one agent per channel. v1 binds SMS numbers only.
+	 * @async
+	 * @roles api, admin, developer
+	 * @param {Object} params - The parameters for the upsert.
+	 * @param {string} params.channel - The channel to bind; must be "sms".
+	 * @param {string} params.endpointValue - The phone number: 10 to 15 digits, country code included, no "+".
+	 * @param {AgentEndpointData} params.endpointData - The agent to assign and its answer mode.
+	 * @param {RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if channel, endpointValue, or endpointData.agentProfileId is missing.
+	 * @returns {Promise<SdkResponse<AgentEndpoint>>} - The created or updated binding returned from the server.
+	 */
+	async upsertAgentEndpoint({ channel, endpointValue, endpointData, options = {} }) {
+		this.client._require({ channel, endpointValue, agentProfileId: endpointData?.agentProfileId });
+		const safeChannel = encodeURIComponent(channel);
+		const safeEndpointValue = encodeURIComponent(endpointValue);
+		return this.client(`/agent/endpoints/${safeChannel}/${safeEndpointValue}`, { method: "PUT", body: endpointData, ...options });
+	}
+
+	/**
+	 * Remove the agent assigned to a number.
+	 * @async
+	 * @roles api, admin, developer
+	 * @param {Object} params - The parameters for the delete.
+	 * @param {string} params.channel - The bound channel; must be "sms".
+	 * @param {string} params.endpointValue - The phone number: digits only, country code included, no "+".
+	 * @param {RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if channel or endpointValue is missing.
+	 * @returns {Promise<SdkResponse<AgentEndpoint>>} - The removed binding returned from the server.
+	 */
+	async deleteAgentEndpoint({ channel, endpointValue, options = {} }) {
+		this.client._require({ channel, endpointValue });
+		const safeChannel = encodeURIComponent(channel);
+		const safeEndpointValue = encodeURIComponent(endpointValue);
+		return this.client(`/agent/endpoints/${safeChannel}/${safeEndpointValue}`, { method: "DELETE", ...options });
+	}
+
+	/**
+	 * List held agent replies (the Pending Replies queue) in a group, newest first.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for listing drafts.
+	 * @param {string} params.groupId - The group whose drafts to list (required).
+	 * @param {string} [params.subgroupId] - Narrow to one subgroup.
+	 * @param {string} [params.agentProfileId] - Narrow to one agent.
+	 * @param {string} [params.status] - Narrow to one status, e.g. "pending".
+	 * @param {number} [params.page] - Page number for pagination.
+	 * @param {number} [params.limit] - Items per page (default 25, max 500).
+	 * @param {RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the groupId parameter is missing.
+	 * @returns {Promise<SdkResponse<AgentReplyDraft[]>>} - The drafts returned from the server.
+	 */
+	async getAgentReplyDrafts({ groupId, subgroupId, agentProfileId, status, page, limit, options = {} }) {
+		this.client._require({ groupId });
+		const queryString = this.client._getQueryString({ groupId, subgroupId, agentProfileId, status, page, limit });
+		return this.client(`/agent/drafts${queryString}`, { method: "GET", ...options });
+	}
+
+	/**
+	 * Approve a held agent reply and send it from the agent's number, optionally with edited text.
+	 * It goes through the normal SMS send path, so opt-out and billing apply; the draft comes back
+	 * "failed" when the send path accepted nothing. A draft that is no longer pending returns 409.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for the approval.
+	 * @param {string} params.agentReplyDraftId - The draft to approve.
+	 * @param {string} [params.text] - Replacement text when a person edited the reply.
+	 * @param {RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the agentReplyDraftId parameter is missing.
+	 * @returns {Promise<SdkResponse<AgentReplyDraft>>} - The draft, now sent (or failed), returned from the server.
+	 */
+	async approveAgentReplyDraft({ agentReplyDraftId, text, options = {} }) {
+		this.client._require({ agentReplyDraftId });
+		const safeId = encodeURIComponent(agentReplyDraftId);
+		const body = text === undefined ? {} : { text };
+		return this.client(`/agent/drafts/${safeId}/approve`, { method: "POST", body, ...options });
+	}
+
+	/**
+	 * Reject a held agent reply so it is never sent. A draft that is no longer pending returns 409.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for the rejection.
+	 * @param {string} params.agentReplyDraftId - The draft to reject.
+	 * @param {RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the agentReplyDraftId parameter is missing.
+	 * @returns {Promise<SdkResponse<AgentReplyDraft>>} - The rejected draft returned from the server.
+	 */
+	async rejectAgentReplyDraft({ agentReplyDraftId, options = {} }) {
+		this.client._require({ agentReplyDraftId });
+		const safeId = encodeURIComponent(agentReplyDraftId);
+		return this.client(`/agent/drafts/${safeId}/reject`, { method: "POST", ...options });
+	}
+
+	/**
+	 * Claim a held agent reply for delivery through your own channel instead of Signal House's send path.
+	 * Nothing is sent: the draft becomes "sending" with `deliveredBy: "external"`, `sentText` and a new
+	 * `claimId` set, and you then report the outcome with `completeAgentReplyDraft` or `releaseAgentReplyDraft`,
+	 * passing that `claimId`. The claim
+	 * means two approvals can never both deliver. A draft that is no longer pending returns 409; one whose
+	 * number has left its subgroup returns 400 and is closed as failed.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for the claim.
+	 * @param {string} params.agentReplyDraftId - The draft to claim.
+	 * @param {string} [params.text] - Replacement text when a person edited the reply.
+	 * @param {RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the agentReplyDraftId parameter is missing.
+	 * @returns {Promise<SdkResponse<AgentReplyDraft>>} - The claimed draft returned from the server.
+	 */
+	async claimAgentReplyDraft({ agentReplyDraftId, text, options = {} }) {
+		this.client._require({ agentReplyDraftId });
+		const safeId = encodeURIComponent(agentReplyDraftId);
+		const body = text === undefined ? {} : { text };
+		return this.client(`/agent/drafts/${safeId}/claim`, { method: "POST", body, ...options });
+	}
+
+	/**
+	 * Mark a claimed agent reply sent once your channel accepted it. Only the claim named by `claimId` can be
+	 * completed (anything else returns 409). It is also accepted after an unfinished claim was closed as
+	 * "failed" with `failureReason: "delivery_unconfirmed"`, which it turns into "sent".
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for the completion.
+	 * @param {string} params.agentReplyDraftId - The claimed draft.
+	 * @param {string} params.claimId - The claim being completed, as returned by `claimAgentReplyDraft`.
+	 * @param {string} [params.externalMessageId] - Your channel's id for the sent message, stored as `sentMessageId`.
+	 * @param {RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the agentReplyDraftId or claimId parameter is missing.
+	 * @returns {Promise<SdkResponse<AgentReplyDraft>>} - The draft, now sent, returned from the server.
+	 */
+	async completeAgentReplyDraft({ agentReplyDraftId, claimId, externalMessageId, options = {} }) {
+		this.client._require({ agentReplyDraftId, claimId });
+		const safeId = encodeURIComponent(agentReplyDraftId);
+		const body = externalMessageId === undefined ? { claimId } : { claimId, externalMessageId };
+		return this.client(`/agent/drafts/${safeId}/complete`, { method: "POST", body, ...options });
+	}
+
+	/**
+	 * Give back a claim whose reply certainly did not go out: the draft returns to "pending", or with
+	 * `permanent` is closed as "failed". If you cannot tell whether it went out, do not release it; a claim
+	 * left unfinished for 30 minutes is closed as failed with `failureReason: "delivery_unconfirmed"`.
+	 * Only the claim named by `claimId` can be released; anything else returns 409.
+	 * @async
+	 * @roles api, admin, developer, billing, user
+	 * @param {Object} params - The parameters for the release.
+	 * @param {string} params.agentReplyDraftId - The claimed draft.
+	 * @param {string} params.claimId - The claim being released, as returned by `claimAgentReplyDraft`.
+	 * @param {boolean} [params.permanent] - True closes the draft as failed instead of returning it to pending.
+	 * @param {RequestOptions} [params.options] - Additional options for the request.
+	 * @throws {Error} Throws an error if the agentReplyDraftId or claimId parameter is missing.
+	 * @returns {Promise<SdkResponse<AgentReplyDraft>>} - The draft, pending again or failed, returned from the server.
+	 */
+	async releaseAgentReplyDraft({ agentReplyDraftId, claimId, permanent, options = {} }) {
+		this.client._require({ agentReplyDraftId, claimId });
+		const safeId = encodeURIComponent(agentReplyDraftId);
+		const body = permanent === undefined ? { claimId } : { claimId, permanent };
+		return this.client(`/agent/drafts/${safeId}/release`, { method: "POST", body, ...options });
+	}
+
 	/**
 	 * Publish an agent profile, setting its `publishStatus` to "published" and stamping
 	 * `publishedAt`. The server rejects the call with 400 when the agent has no enabled

package/src/domains/Auth.js

@@ -63,13 +63,20 @@ export class Auth {
 	 * @param {boolean} [params.acceptedTermsOfService] - Whether the user accepted the Terms of Service
 	 * @param {string} [params.psXid] - PartnerStack click id (ps_xid) captured from a referral link
 	 * @param {string} [params.psPartnerKey] - PartnerStack partner key (ps_partner_key) captured from a referral link
+	 * @param {Object} [params.attribution] - Marketing attribution captured at signup
+	 * @param {string} [params.attribution.posthogDistinctId] - PostHog distinct id of the registering visitor
+	 * @param {Object} [params.attribution.firstTouch] - First-ever visit: utmSource, utmMedium, utmCampaign, utmTerm, utmContent, gclid, gbraid, wbraid, fbclid, msclkid, referrer, landingUrl, timestamp
+	 * @param {Object} [params.attribution.lastTouch] - Visit that registered, same keys as firstTouch
+	 * @param {string} [params.attribution.shLanding] - Marketing-site landing page passed on the register link (sh_landing)
+	 * @param {string} [params.attribution.shCta] - Marketing-site CTA that sent the visitor (sh_cta)
+	 * @param {string} [params.attribution.shGuide] - Marketing-site guide the CTA was on (sh_guide)
 	 * @param {RequestOptions} [params.options] - Additional options for the request
 	 * @returns {Promise<SdkResponse<any>>} The response from the server (contains the JWT token)
 	 */
-	async register({ businessName, fullName, email, password, phone, dialCode, country, volume, products, acceptedTermsOfService, psXid, psPartnerKey, options = {} }) {
+	async register({ businessName, fullName, email, password, phone, dialCode, country, volume, products, acceptedTermsOfService, psXid, psPartnerKey, attribution, options = {} }) {
 		return this.client(`/auth/register`, {
 			method: "POST",
-			body: { businessName, fullName, email, password, phone, dialCode, country, volume, products, acceptedTermsOfService, psXid, psPartnerKey },
+			body: { businessName, fullName, email, password, phone, dialCode, country, volume, products, acceptedTermsOfService, psXid, psPartnerKey, attribution },
 			...options,
 		});
 	}

package/src/domains/Messages.js

@@ -26,7 +26,8 @@ export class Messages {
 	 * Estimate regional SMS/MMS retail cost; no charge or send. A Canadian sender requires a Ready Canadian sender and
 	 * Canadian or US recipients, and is unavailable unless Canada is enabled for the environment. A +44 (UK) sender
 	 * estimates SMS to GB mobiles only and returns region "GB"; while UK sending is disabled for the environment a UK
-	 * sender is refused with a 400.
+	 * sender is refused with a 400. The sender may also be a READY alphanumeric sender ID (e.g. "ACME"; UK recipients,
+	 * SMS only); its estimate counts the "\nOpt out: sihou.io/o/{code}" footer the server appends to every such message.
 	 * @async
 	 * @param {Object} params - Sender, up to 100 recipients (10-15 digits each), messageBody and request options.
 	 * @returns {Promise<SdkResponse<any>>} - Per-recipient rates and total in microdollars; unknown carriers use the upper fallback.
@@ -50,15 +51,15 @@ export class Messages {
 	 * @param {string} [params.direction] - Filter messages by their direction (INBOUND, OUTBOUND)
 	 * @param {string|string[]} [params.messageType] - Filter messages by their type. Accepts a single value or an array (e.g. ["SMS", "MMS"]). Allowed values: SMS, MMS, RCS, WHATSAPP, VIBER, P2P. When omitted, defaults to all non-P2P types.
 	 * @param {string|string[]} [params.channel] - Filter messages by channel. Accepts a single value or an array. Allowed values: tenDLC, virtualLongCode, tollFree, shortCode, p2p. Each message records its channel when it is saved, and this filters on that stored value; older messages from before this feature have no channel and count as tenDLC. Ignored when matchAny is true (matchAny takes precedence).
-	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (UK is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Accepted whether or not the environment serves hourly analytics.
+	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (any case of UK/GB/GBR/United Kingdom is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Accepted whether or not the environment serves hourly analytics.
 	 * @param {Object[]|string} [params.regionScopes] - Array of OR-ed branches `{ region, channels, brandId?, campaignId?, phoneNumber? }` (channels among tenDLC, virtualLongCode, tollFree, shortCode, p2p); `[]` matches nothing. Sent as JSON unless already a string. Accepted whether or not the environment serves hourly analytics.
 	 * @param {boolean} [params.matchAny] - When true, the provided campaignId/brandId/phoneNumber filters are OR'd (a message matches ANY of them) instead of the default most-specific-single behavior. subgroupId stays an AND scope. Opt-in/additive.
 	 * @param {string} [params.carrier] - Filter messages by the carrier used for sending
 	 * @param {string|string[]} [params.sentimentLabel] - Filter messages by sentiment bucket. Accepts a single value or an array (e.g. ["positive", "negative"]). Allowed values: positive, neutral, negative. Applied as the sentimentScore range the ±25 label threshold produces, so unscored messages match no bucket and outbound messages (never scored) are excluded.
 	 * @param {string|string[]} [params.errorCode] - Filter FAILED messages by Signal House error code (single value or array). "OUT" is the campaign opt-out, displayed as RECIPIENT_OPTED_OUT. Carrier codes are not filterable here; they live inside successOrFailureReason.
 	 * @param {string|string[]} [params.phoneNumber] - Filter messages by a business number on either side of the message. Accepts a single value or an array; OR'd with campaignId/brandId when matchAny is true
-	 * @param {string} [params.senderPhoneNumber] - Filter messages by the sender's 5-6 digit Short Code or 10+ digit phone number
-	 * @param {string} [params.recipientPhoneNumber] - Filter messages by the recipient's phone number
+	 * @param {string} [params.senderPhoneNumber] - Filter messages by the sender's 5-6 digit Short Code or 10+ digit phone number. Use % as a wildcard for a partial match (e.g. "%1234" matches numbers ending in 1234); a plain value is an exact match. 3-15 digits required alongside any %.
+	 * @param {string} [params.recipientPhoneNumber] - Filter messages by the recipient's phone number. Use % as a wildcard for a partial match (e.g. "%1234" matches numbers ending in 1234); a plain value is an exact match. 3-15 digits required alongside any %.
 	 * @param {string} [params.startDate] - ISO-8601 date or timestamp; bound per dateBounds: a bare date is always that whole UTC day (inclusive); a timestamp is widened to its whole UTC day in "day" mode and bound as the instant it names, in whatever offset it was written, in "exact" mode
 	 * @param {string} [params.endDate] - ISO-8601 date or timestamp; bound per dateBounds: a bare date is always that whole UTC day (inclusive); a timestamp is widened to its whole UTC day in "day" mode and bound as the instant it names, in whatever offset it was written, in "exact" mode. In "exact" mode day buckets align to the UTC offset this bound carries, so a client that sends its own midnights gets its own calendar dates back
 	 * @param {string} [params.sortField] - The field to sort the messages by (createdAt, segmentCount, status, sentimentScore)
@@ -143,7 +144,7 @@ export class Messages {
 	 * @param {boolean} [params.matchAny] - When true, the provided campaignId/brandId/phoneNumber filters are OR'd (match ANY) instead of the default most-specific-single behavior. subgroupId stays an AND scope. Opt-in/additive.
 	 * @param {(string|string[])} [params.messageType] - Message type(s) the SENTIMENT figures are scoped to: SMS, MMS or P2P (single value, array, or comma-separated string). Omit for all scored types. Does NOT narrow the message counts, which are always returned split per type (smsInbound/mmsInbound/p2pInbound) and have no filterable type dimension.
 	 * @param {string|string[]} [params.channel] - Filter analytics by channel (tenDLC, virtualLongCode, tollFree, shortCode, p2p). Filters on the stored channel column; a tenDLC selection also includes older messages that have no channel, and p2p is a real channel here (matched by carrier). Accepts a single value or an array. Ignored when matchAny is true (matchAny takes precedence).
-	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (UK is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
+	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (any case of UK/GB/GBR/United Kingdom is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
 	 * @param {Object[]|string} [params.regionScopes] - Array of OR-ed branches `{ region, channels, brandId?, campaignId?, phoneNumber? }` (channels among tenDLC, virtualLongCode, tollFree, shortCode, p2p); `[]` matches nothing. Sent as JSON unless already a string. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
 	 * @param {("day"|"exact")} [params.dateBounds] - Which contract binds startDate/endDate. "day": each bound is widened to its whole UTC day. "exact": a timestamp is bound as the instant it names and a bare date is its whole UTC day. Omitted: "day".
 	 * @param {RequestOptions} [params.options] - Additional options for the request
@@ -179,7 +180,7 @@ export class Messages {
 	 * @param {string} [params.endDate] - ISO-8601 date or timestamp. At day granularity it is bound per dateBounds: a bare date is always that whole UTC day (inclusive); a timestamp is widened to its whole UTC day in "day" mode and bound as the instant it names, in whatever offset it was written, in "exact" mode. In "exact" mode day buckets align to the UTC offset this bound carries, so a client that sends its own midnights gets its own calendar dates back; at hour granularity it is honoured as given.
 	 * @param {(string|string[])} [params.messageType] - Message type(s) the SENTIMENT figures are scoped to: SMS, MMS or P2P (single value, array, or comma-separated string). Omit for all scored types. Does NOT narrow the message counts, which are always returned split per type (smsInbound/mmsInbound/p2pInbound) and have no filterable type dimension.
 	 * @param {string|string[]} [params.channel] - Filter analytics by channel (tenDLC, virtualLongCode, tollFree, shortCode, p2p). Filters on the stored channel column; a tenDLC selection also includes older messages that have no channel, and p2p is a real channel here. Accepts a single value or an array.
-	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (UK is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
+	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (any case of UK/GB/GBR/United Kingdom is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
 	 * @param {Object[]|string} [params.regionScopes] - Array of OR-ed branches `{ region, channels, brandId?, campaignId?, phoneNumber? }` (channels among tenDLC, virtualLongCode, tollFree, shortCode, p2p); `[]` matches nothing. Sent as JSON unless already a string. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
 	 * @param {("day"|"hour")} [params.granularity] - Time-bucket grain of the byDate rows. Omit for day (each row's _id is a "YYYY-MM-DD" date). "hour" buckets by hour (each row's _id is a "YYYY-MM-DD HH:MM:SS" UTC hour) and is capped to a 7-day span. Only accepted where the environment serves hourly analytics; elsewhere any value, including "day", is rejected with a 400 -- omit the parameter unless hour grain is wanted.
 	 * @param {("carrier"|"carrierFamily")} [params.breakdown] - Adds a byBreakdown time × dimension series to the response ({ dimension, rows }: each row is one byDate bucket (_id) for one carrier or carrier family (key), over the top 50 keys by volume, 10DLC only) and caps the span at 31 days. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400 -- omit the parameter unless it is wanted.
@@ -234,7 +235,7 @@ export class Messages {
 	 * @roles api, admin, developer, billing, user
 	 * @param {Object} params - The parameters for getting analytics filter options
 	 * @param {string} params.groupId - The ID of the group whose filter options to load
-	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (UK is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
+	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (any case of UK/GB/GBR/United Kingdom is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
 	 * @param {RequestOptions} [params.options] - Additional options for the request
 	 * @returns {Promise<SdkResponse<any>>} - A promise that resolves to { subgroups, brands, campaigns, phoneNumbers }. Each phone number carries type (TOLL_FREE, SHORT_CODE, ALPHANUMERIC, VIRTUAL_LONG_NUMBER, ...) and country (ISO-2), null when unknown: TOLL_FREE, SHORT_CODE and ALPHANUMERIC are channels by type; any other US number is 10DLC and a non-US one is a Virtual Long Code.
 	 */
@@ -265,7 +266,7 @@ export class Messages {
 	 * @param {("tenDLC"|"virtualLongCode"|"tollFree"|"shortCode"|"p2p"|"both")|Array<"tenDLC"|"virtualLongCode"|"tollFree"|"shortCode"|"p2p">} [params.channel="both"] - Filter and rank rows by the stored channel column. "both" (default) means all activity. tenDLC/virtualLongCode/tollFree/shortCode/p2p (single value or array) limit to the selected channel(s).
 	 * @param {(string|string[])} [params.messageType] - Message type(s) the SENTIMENT figures are scoped to: SMS, MMS or P2P (single value, array, or comma-separated string). Omit for all scored types. Does NOT narrow the message counts, which are always returned split per type (smsInbound/mmsInbound/p2pInbound) and have no filterable type dimension.
 	 * @param {("day"|"exact")} [params.dateBounds] - Which contract binds startDate/endDate. "day": each bound is widened to its whole UTC day. "exact": a timestamp is bound as the instant it names and a bare date is its whole UTC day. Omitted: "day".
-	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (UK is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
+	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (any case of UK/GB/GBR/United Kingdom is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
 	 * @param {Object[]|string} [params.regionScopes] - Array of OR-ed branches `{ region, channels, brandId?, campaignId?, phoneNumber? }` (channels among tenDLC, virtualLongCode, tollFree, shortCode, p2p); `[]` matches nothing. Sent as JSON unless already a string. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
 	 * @param {RequestOptions} [params.options]
 	 * @returns {Promise<SdkResponse<any>>} - { rows, totalCount, page, limit }. Each row carries sms/mms/p2p metric columns plus `smsOptOuts` and `mmsOptOuts` from the DNC analytics MV (P2P has no opt-outs).
@@ -297,7 +298,7 @@ export class Messages {
 	 * @param {number} [params.limit=50] - max 50 per page
 	 * @param {("tenDLC"|"virtualLongCode"|"tollFree"|"shortCode"|"p2p"|"both")|Array<"tenDLC"|"virtualLongCode"|"tollFree"|"shortCode"|"p2p">} [params.channel="both"] - Filter and rank rows by the stored channel column. "both" (default) means every code. tenDLC/virtualLongCode/tollFree/shortCode/p2p (single value or array) limit to the selected channel(s); when one channel is selected, totalErrors reflects only that channel.
 	 * @param {("day"|"exact")} [params.dateBounds] - Which contract binds startDate/endDate. "day": each bound is widened to its whole UTC day. "exact": a timestamp is bound as the instant it names and a bare date is its whole UTC day. Omitted: "day".
-	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (UK is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
+	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (any case of UK/GB/GBR/United Kingdom is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
 	 * @param {Object[]|string} [params.regionScopes] - Array of OR-ed branches `{ region, channels, brandId?, campaignId?, phoneNumber? }` (channels among tenDLC, virtualLongCode, tollFree, shortCode, p2p); `[]` matches nothing. Sent as JSON unless already a string. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
 	 * @param {RequestOptions} [params.options]
 	 * @returns {Promise<SdkResponse<any>>} - { rows, totalCount, totalErrors: { sms, mms, p2p, all }, page, limit }
@@ -324,7 +325,7 @@ export class Messages {
 	 * @param {string} [params.endDate] - ISO-8601 date or timestamp; bound per dateBounds: a bare date is always that whole UTC day (inclusive); a timestamp is widened to its whole UTC day in "day" mode and bound as the instant it names, in whatever offset it was written, in "exact" mode. In "exact" mode day buckets align to the UTC offset this bound carries, so a client that sends its own midnights gets its own calendar dates back
 	 * @param {string|string[]} [params.channel] - Filter by channel (tenDLC, virtualLongCode, tollFree, shortCode). Opt-outs are A2P-only, so p2p applies no filter. Filters on the stored channel column; a tenDLC selection also includes older opt-outs that have no channel.
 	 * @param {("day"|"exact")} [params.dateBounds] - Which contract binds startDate/endDate. "day": each bound is widened to its whole UTC day. "exact": a timestamp is bound as the instant it names and a bare date is its whole UTC day. Omitted: "day".
-	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (UK is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
+	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (any case of UK/GB/GBR/United Kingdom is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
 	 * @param {Object[]|string} [params.regionScopes] - Array of OR-ed branches `{ region, channels, brandId?, campaignId?, phoneNumber? }` (channels among tenDLC, virtualLongCode, tollFree, shortCode, p2p); `[]` matches nothing. Sent as JSON unless already a string. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
 	 * @param {RequestOptions} [params.options] - Additional options for the request
 	 * @returns {Promise<SdkResponse<any>>} - A promise that resolves to the DNC analytics data (totals, byDate, byPhoneNumber, bySenderNumber, byCampaign, bySubgroup, byType, byCarrier, byKeyword). bySenderNumber ({ senderPhoneNumber, total, sms, mms }) attributes each opt-out to the first business number that received it, so it is unchanged by later campaign moves and START replies. byCampaign ({ campaignId, ... }) counts campaign-scoped opt-outs only, by the campaign at the time of the STOP; subgroup-scoped opt-outs (non-US recipients) are never attributed to a campaign and appear under bySubgroup ({ subgroupId, ... }) instead. byType ({ messageType, total }) splits SMS/MMS. byKeyword breaks opt-outs down by the normalized keyword that revoked consent ({ optOutKeyword, total, sms, mms }); opt-outs recorded before keyword capture shipped appear as a single optOutKeyword: null bucket ("not recorded"). The distinct keyword set is open-ended (campaigns register their own keywords beyond the mandatory floor) — render top-N plus Other, never a fixed list.
@@ -355,7 +356,7 @@ export class Messages {
 	 * @param {string} [params.sortOrder] - Sort direction (asc, desc)
 	 * @param {string|string[]} [params.channel] - Filter by channel (tenDLC, virtualLongCode, tollFree, shortCode). Opt-outs are A2P-only, so p2p applies no filter. Filters on the stored channel column; a tenDLC selection also includes older opt-outs that have no channel.
 	 * @param {("day"|"exact")} [params.dateBounds] - Which contract binds startDate/endDate. "day": each bound is widened to its whole UTC day. "exact": a timestamp is bound as the instant it names and a bare date is its whole UTC day. Omitted: "day".
-	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (UK is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
+	 * @param {string|string[]} [params.region] - ISO-2 country filter: US, GB or CA (any case of UK/GB/GBR/United Kingdom is accepted for GB); one value, an array, or a comma-separated string; omitted = every region. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
 	 * @param {Object[]|string} [params.regionScopes] - Array of OR-ed branches `{ region, channels, brandId?, campaignId?, phoneNumber? }` (channels among tenDLC, virtualLongCode, tollFree, shortCode, p2p); `[]` matches nothing. Sent as JSON unless already a string. Only accepted where the environment serves hourly analytics; elsewhere any value is rejected with a 400.
 	 * @param {RequestOptions} [params.options] - Additional options for the request
 	 * @returns {Promise<SdkResponse<any>>} - A promise that resolves to the paginated DNC records. Each record carries senderPhoneNumber — the first business number that received the opt-out (set once, never changed by a later STOP or a campaign move; the same value as phoneNumber) — optOutKeyword — the normalized keyword that revoked consent (e.g. "stop", "opt out"; a repeat opt-out records the most recent word), null for opt-outs recorded before keyword capture shipped — and carrierFamily, the resolved carrier family of the recipient number (Default, ATT, TMobile, Verizon, USCellular, GoogleVoice, ClearSky, Interop, RogueMobile, Standard, IceWireless), copied from the inbound message that triggered the opt-out. campaignId is null on subgroup-scoped records (non-US recipients).
@@ -381,7 +382,7 @@ export class Messages {
 	 * @async
 	 * @roles api, admin, developer, billing, user
 	 * @param {Object} params - The parameters for sending an SMS message
-	 * @param {string} params.senderPhoneNumber - The 5-6 digit Short Code or 10+ digit phone number to send the message from
+	 * @param {string} params.senderPhoneNumber - The 5-6 digit Short Code or 10+ digit phone number to send the message from, or a READY alphanumeric sender ID (e.g. "ACME"; UK recipients and SMS only). Every message from an alphanumeric sender gets "\nOpt out: sihou.io/o/{code}" appended by the server, counted in segments.
 	 * @param {string|string[]} params.recipientPhoneNumbers - The 10+ digit phone number(s) to send the message to. A Short Code sender permits exactly one recipient, and it must be a +1 (US/Canada) number; a bare 10-digit number is treated as +1. The API rejects Short Code sends with multiple recipients or a non-+1 recipient.
 	 * @param {string} params.messageBody - The body of the SMS message
 	 * @param {string} [params.statusCallbackUrl] - The URL to receive status callbacks

package/src/domains/Onboarding.js

@@ -39,6 +39,40 @@ export class Onboarding {
 					const safeGroupId = encodeURIComponent(groupId);
 					return this.client(`/group/onboarding/${safeGroupId}`, { method: "GET", ...options });
 				},
+
+				/**
+				 * Add an internal comment/note to a group's admin Pricing editor. Staff-only.
+				 * @async
+				 * @roles signalhouse_admin, signalhouse_user
+				 * @param {Object} params
+				 * @param {string} params.groupId - The group ID to comment on
+				 * @param {string} params.comment - The comment/note text
+				 * @param {RequestOptions} [params.options] - Additional options for the request
+				 * @throws {Error} Throws an error if the groupId or comment parameter is missing
+				 * @returns {Promise<SdkResponse<any>>} - The updated onboarding record
+				 */
+				addPricingComment: async ({ groupId, comment, options = {} }) => {
+					this.client._require({ groupId, comment });
+					const safeGroupId = encodeURIComponent(groupId);
+					return this.client(`/group/onboarding/${safeGroupId}/pricing-comments`, { method: "POST", body: { comment }, ...options });
+				},
+
+				/**
+				 * Add an internal comment/note to a group's admin Credits page. Staff-only.
+				 * @async
+				 * @roles signalhouse_admin, signalhouse_user
+				 * @param {Object} params
+				 * @param {string} params.groupId - The group ID to comment on
+				 * @param {string} params.comment - The comment/note text
+				 * @param {RequestOptions} [params.options] - Additional options for the request
+				 * @throws {Error} Throws an error if the groupId or comment parameter is missing
+				 * @returns {Promise<SdkResponse<any>>} - The updated onboarding record
+				 */
+				addCreditComment: async ({ groupId, comment, options = {} }) => {
+					this.client._require({ groupId, comment });
+					const safeGroupId = encodeURIComponent(groupId);
+					return this.client(`/group/onboarding/${safeGroupId}/credit-comments`, { method: "POST", body: { comment }, ...options });
+				},
 			};
 		}
 	}

package/src/domains/Registrations.js

@@ -7,7 +7,8 @@
 /**
  * Sender registrations for every jurisdiction and type: the catalog of what a region offers, retail quotes,
  * customer submissions and staff review operations. `type` selects the shape of `data`
- * (for VIRTUAL_LONG_CODE: quantity, useCases and the optional voice dossier).
+ * (for VIRTUAL_LONG_CODE: quantity, useCases and the optional voice dossier; for GB ALPHANUMERIC_SENDER_ID: requestedSenderId,
+ * trafficOrigin, trafficType and the company details).
  */
 export class Registrations {
 	constructor(client, enableAdmin) {
@@ -126,7 +127,7 @@ export class Registrations {
 	 * @async
 	 * @roles api, admin, developer, billing, user
 	 * @param {Object} params - The parameters for the catalog
-	 * @param {string} params.region - ISO-2 jurisdiction (US, GB or CA; UK is accepted for GB)
+	 * @param {string} params.region - ISO-2 jurisdiction (US, GB or CA; any case of UK/GB/GBR/United Kingdom is accepted for GB)
 	 * @param {RequestOptions} [params.options] - Additional options for the request
 	 * @returns {Promise<SdkResponse<any>>} A promise that resolves to { region, jurisdiction, sendingRequiresRegistration, registeredThrough, provisioning, types }
 	 */
@@ -138,13 +139,14 @@ export class Registrations {
 
 	/**
 	 * Get retail quotes for a registration type: one quote per capability bundle with per-number setupAmount
-	 * and monthlyAmount, the totals for the quantity (integer microdollars) and etaDays.
+	 * and monthlyAmount, the totals for the quantity (integer microdollars) and etaDays. GB ALPHANUMERIC_SENDER_ID
+	 * quotes one ["SMS"] bundle (6000000 setup and 6000000 monthly by default).
 	 * Unavailable (400) while the type cannot be acquired in the region.
 	 * @async
 	 * @roles api, admin, developer, billing, user
 	 * @param {Object} params - The parameters for the quote
-	 * @param {string} params.region - ISO-2 jurisdiction (UK is accepted for GB)
-	 * @param {string} params.type - Registration type (e.g. VIRTUAL_LONG_CODE)
+	 * @param {string} params.region - ISO-2 jurisdiction (any case of UK/GB/GBR/United Kingdom is accepted for GB)
+	 * @param {string} params.type - Registration type (e.g. VIRTUAL_LONG_CODE, or ALPHANUMERIC_SENDER_ID for GB)
 	 * @param {number} [params.quantity=1] - Number of numbers to quote (1-100)
 	 * @param {string} [params.groupId] - Group to price for; staff only
 	 * @param {RequestOptions} [params.options] - Additional options for the request
@@ -214,26 +216,30 @@ export class Registrations {
 
 	/**
 	 * Submit a registration. `type` selects the shape of `data`: for VIRTUAL_LONG_CODE it is { quantity (1-100),
-	 * useCases (1-10 descriptions), voice? } where voice is required exactly when capabilities include VOICE.
-	 * Reuse the same clientRequestId only when retrying an identical payload (409 otherwise).
+	 * useCases (1-10 descriptions), voice? } where voice is required exactly when capabilities include VOICE. For GB
+	 * ALPHANUMERIC_SENDER_ID (capabilities ["SMS"]) it is { requestedSenderId (3-11 letters/digits/space/dot/dash,
+	 * at least one letter), trafficOrigin (LOCAL | INTERNATIONAL), trafficType (TRANSACTIONAL | PROMOTIONAL),
+	 * companyName, companyCountry, companyWebsite, industry, messageExample, senderRelationship? } where
+	 * senderRelationship is required when requestedSenderId differs from companyName; quantity is always 1 and
+	 * data.phoneNumbers carries the granted sender (e.g. ["ACME"]) once APPROVED.
+	 * Pass options.idempotencyKey to make a retry safe: an identical retry with the same key replays the first response.
 	 * Unavailable (400) while the type cannot be acquired in the region.
 	 * @async
 	 * @roles api, admin, developer, billing, user
 	 * @param {Object} params - The parameters for the registration
-	 * @param {string} params.region - ISO-2 jurisdiction (UK is accepted for GB)
-	 * @param {string} params.type - Registration type (e.g. VIRTUAL_LONG_CODE)
+	 * @param {string} params.region - ISO-2 jurisdiction (any case of UK/GB/GBR/United Kingdom is accepted for GB)
+	 * @param {string} params.type - Registration type (e.g. VIRTUAL_LONG_CODE, or ALPHANUMERIC_SENDER_ID for GB)
 	 * @param {string} params.subgroupId - Subgroup that will own the registration and any allocated numbers
-	 * @param {string} params.clientRequestId - Idempotency key (UUID)
 	 * @param {string[]} params.capabilities - One of the type's bundles, e.g. ["SMS"] or ["SMS", "VOICE"]
 	 * @param {Object} params.data - The type's submission fields
 	 * @param {RequestOptions} [params.options] - Additional options for the request
 	 * @returns {Promise<SdkResponse<any>>} A promise that resolves to the created registration
 	 */
-	async createRegistration({ region, type, subgroupId, clientRequestId, capabilities, data, options = {} }) {
-		this.client._require({ region, type, subgroupId, clientRequestId, capabilities, data });
+	async createRegistration({ region, type, subgroupId, capabilities, data, options = {} }) {
+		this.client._require({ region, type, subgroupId, capabilities, data });
 		return this.client("/registration", {
 			method: "POST",
-			body: { region, type, subgroupId, clientRequestId, capabilities, data },
+			body: { region, type, subgroupId, capabilities, data },
 			...options,
 		});
 	}

package/src/domains/Shortlinks.js

@@ -25,6 +25,36 @@ export class Shortlinks {
 		return this.client(`/shortlink/redirect/${safeShortlinkId}`, { method: "GET", ...options });
 	}
 
+	/**
+	 * Get the recipient opt-out details behind an alphanumeric-sender opt-out link (sihou.io/o/{code})
+	 * @async
+	 * @roles public
+	 * @param {Object} params - The parameters for getting the opt-out details
+	 * @param {string} params.code - The opt-out code from the link
+	 * @param {RequestOptions} [params.options] - Additional options for the request
+	 * @returns {Promise<SdkResponse<any>>} A promise that resolves to `{ code, senderName, maskedRecipient, optedOut }`
+	 */
+	async getOptOut({ code, options = {} }) {
+		this.client._require({ code });
+		const safeCode = encodeURIComponent(code);
+		return this.client(`/shortlink/optout/${safeCode}`, { method: "GET", ...options });
+	}
+
+	/**
+	 * Confirm the recipient opt-out behind an alphanumeric-sender opt-out link; idempotent
+	 * @async
+	 * @roles public
+	 * @param {Object} params - The parameters for confirming the opt-out
+	 * @param {string} params.code - The opt-out code from the link
+	 * @param {RequestOptions} [params.options] - Additional options for the request
+	 * @returns {Promise<SdkResponse<any>>} A promise that resolves to `{ code, senderName, maskedRecipient, optedOut: true }`
+	 */
+	async confirmOptOut({ code, options = {} }) {
+		this.client._require({ code });
+		const safeCode = encodeURIComponent(code);
+		return this.client(`/shortlink/optout/${safeCode}`, { method: "POST", ...options });
+	}
+
 	/**
 	 * Get details of a shortlink by its ID, with optional filters
 	 * @async