@centrali-io/centrali-sdk 6.6.0 → 6.7.0

package/dist/index.d.ts

@@ -285,6 +285,11 @@ declare function getAllowedDomainsApiPath(workspaceId: string, domainId?: string
  * Generate Webhook Subscriptions API URL PATH.
  */
 declare function getWebhookSubscriptionsApiPath(workspaceId: string, subscriptionId?: string): string;
+/**
+ * Generate the payload-versions API URL PATH. Lists the outbound payload
+ * versions a subscription can be pinned to.
+ */
+declare function getWebhookPayloadVersionsApiPath(workspaceId: string): string;
 /**
  * Generate rotate-secret API URL PATH for a webhook subscription.
  */
@@ -2339,6 +2344,8 @@ interface FunctionRun {
     triggerType?: string | null;
     orchestrationRunId?: string | null;
     orchestrationStepId?: string | null;
+    /** Inbound durable buffer link (CEN-1297) — set for buffered webhook-trigger runs. */
+    inboundEventId?: string | null;
     originalRunId?: string | null;
     isRerun: boolean;
     rerunCount: number;
@@ -2693,6 +2700,20 @@ interface WebhookSubscription {
      * undefined on subsequent reads so it is safe to pass subscriptions around.
      */
     secret?: string;
+    /**
+     * Outbound payload version this subscription receives — a date-string
+     * (`YYYY-MM`). Deliveries are projected into the shape this version
+     * describes. Frozen at creation; change it to upgrade to a newer shape.
+     */
+    payloadVersion: string;
+    /**
+     * Opaque builder-supplied tenant identifier. Carried onto outbound
+     * delivery rows by the platform so embeds and tenant-scoped views can
+     * filter to a single customer without leaking cross-tenant events.
+     * Centrali never parses or interprets this value — it's the builder's
+     * own customer/account/workspace id, whatever shape that takes.
+     */
+    tenantId?: string | null;
     workspaceSlug: string;
     createdAt?: string;
     updatedAt?: string;
@@ -2716,6 +2737,8 @@ interface WebhookDelivery {
     responseBody?: string | null;
     /** Delivery ID the row was replayed from, or null for original deliveries. */
     replayedFrom?: string | null;
+    /** Outbound payload version this delivery was projected into and served with. */
+    payloadVersion: string;
     createdAt: string;
     updatedAt: string;
 }
@@ -2732,6 +2755,19 @@ interface CreateWebhookSubscriptionInput {
     /** Optional — restrict to a subset of collections. Omit for all collections. */
     recordSlugs?: string[];
     active?: boolean;
+    /**
+     * Optional outbound payload version to pin the subscription to. Omit to
+     * freeze to the latest version at creation time. Must be a value returned
+     * by `getPayloadVersions()`.
+     */
+    payloadVersion?: string;
+    /**
+     * Optional opaque tenant identifier — typically the builder's own
+     * customer or account id. Surfaces on every delivery the subscription
+     * produces so tenant-scoped views (e.g. an embedded Event Log) can
+     * filter to one customer.
+     */
+    tenantId?: string | null;
 }
 interface UpdateWebhookSubscriptionInput {
     name?: string;
@@ -2744,6 +2780,26 @@ interface UpdateWebhookSubscriptionInput {
      */
     recordSlugs?: string[];
     active?: boolean;
+    /**
+     * Upgrade (or downgrade) the outbound payload version. Must be a value
+     * returned by `getPayloadVersions()`. Omit to leave the version unchanged.
+     */
+    payloadVersion?: string;
+    /**
+     * Update the opaque tenant identifier. Pass `null` to clear it; omit to
+     * leave it unchanged. Past deliveries are not retroactively rewritten —
+     * the new value applies to deliveries created after the update.
+     */
+    tenantId?: string | null;
+}
+/**
+ * Outbound payload versions a subscription can be pinned to. Returned by
+ * `getPayloadVersions()`. `versions` is oldest-first; `latest` is what a
+ * subscription created without an explicit version is frozen to.
+ */
+interface WebhookPayloadVersions {
+    versions: string[];
+    latest: string;
 }
 interface ListWebhookDeliveriesOptions {
     status?: WebhookDeliveryStatus;
@@ -5112,6 +5168,18 @@ declare class WebhookSubscriptionsManager {
      * capture it before closing the response.
      */
     rotateSecret(subscriptionId: string): Promise<ApiResponse<WebhookSubscription>>;
+    /**
+     * List the outbound payload versions a subscription can be pinned to via
+     * `create`/`update`'s `payloadVersion`. Each version selects the shape its
+     * deliveries are projected into; subscribers upgrade on their own timeline.
+     *
+     * @example
+     * ```ts
+     * const { data } = await centrali.webhookSubscriptions.getPayloadVersions();
+     * console.log('Latest payload version:', data.latest);
+     * ```
+     */
+    getPayloadVersions(): Promise<ApiResponse<WebhookPayloadVersions>>;
 }
 
 /** Mirror of `@centrali/query`'s `ValidateOptions`. */
@@ -6058,4 +6126,4 @@ declare class CentraliSDK {
     checkAuthorization(options: CheckAuthorizationOptions): Promise<ApiResponse<AuthorizationResult>>;
 }
 
-export { type AcceptSuggestionResult, type AddAllowedDomainOptions, type AllowedDomain, type AllowedDomainsListResponse, AllowedDomainsManager, type AnomalyAnalysisResult, type AnomalyDetectionData, type AnomalyEventType, type AnomalyInsight, type AnomalyInsightData, AnomalyInsightsManager, type ApiResponse, type ArrayPropertyDefinition, AuditLogManager, type AuthorizationResult, type BasePropertyDefinition, type BatchScanResult, type BatchScanStatus, type BooleanPropertyDefinition, type BulkOperationResult, CANONICAL_OPERATORS, type CanonicalOperator, CentraliError, CentraliSDK, type CentraliSDKOptions, type CheckAuthorizationOptions, CollectionsManager, type ComputeEventType, type ComputeFunction, ComputeFunctionsManager, type ComputeJobStatus, type ComputeJobStatusResponse, type ConditionOperator, type CreateComputeFunctionInput, type CreateOrchestrationInput, type CreateSmartQueryInput, type CreateStructureInput, type CreateTriggerInput, type CreateWebhookSubscriptionInput, type DateTimePropertyDefinition, type DateWindowOption, type DeleteRecordOptions, type EndpointResponse, type ExecuteSavedQueryValues, type ExecuteSmartQueryOptions, type ExpandOptions, type FieldCondition, type FieldConditionMap, type FileMetadata, FilesManager, type FilterOperators, type FilterValue, type FunctionMemoryUsage, type FunctionRun, type FunctionRunError, type FunctionRunExecutionSource, type FunctionRunStatus, FunctionRunsManager, type FunctionTrigger, type GetRecordOptions, type IncludeClause, type InsightSeverity, type InsightStatus, type InsightType, type InsightsSummary, type InvokeEndpointOptions, type InvokeTriggerOptions, JOINS_MAX_LENGTH, type JoinClause, type JoinType, type LegacyTranslateOptions, type LegacyTranslateResult, type LegacyTranslateWarning, type ListAllTriggersOptions, type ListCollectionsOptions, type ListComputeFunctionsOptions, type ListFunctionRunsOptions, type ListInsightsOptions, type ListOrchestrationRunsOptions, type ListOrchestrationsOptions, type ListSmartQueryOptions, type ListStructuresOptions, type ListValidationSuggestionsOptions, type ListWebhookDeliveriesOptions, type NumberPropertyDefinition, OPERATOR_METADATA, type ObjectPropertyDefinition, type OperatorMeta, type OperatorTypeApplicability, type OperatorValueShape, type Orchestration, type OrchestrationCaseEvaluation, type OrchestrationCondition, type OrchestrationConditionEvaluation, type OrchestrationDecisionCase, type OrchestrationDecisionResult, type OrchestrationDelayConfig, type OrchestrationEventType, type OrchestrationFailureReason, type OrchestrationOnFailure, type OrchestrationOnSuccess, type OrchestrationRetryConfig, type OrchestrationRun, type OrchestrationRunStatus, type OrchestrationRunStep, OrchestrationRunsManager, type OrchestrationScheduleType, type OrchestrationStatus, type OrchestrationStep, type OrchestrationStepError, type OrchestrationStepStatus, type OrchestrationStepType, type OrchestrationTrigger, type OrchestrationTriggerMetadata, type OrchestrationTriggerType, OrchestrationsManager, type PageClause, type PaginatedResponse, type ParsedUrlQuery, type PropertyDefinition, type PropertyType, type QueryDefinition, type QueryError, type QueryErrorCode, type QueryExecutionMode, type QueryHttpError, type QueryHttpErrorCode, QueryManager, type QueryRecordOptions, type QueryResult, type QueryResultMeta, type QueryValidateOptions, type QueryVariableDefinition, RECORDS_PAGE_DEFAULT_LIMIT, RECORDS_PAGE_MAX_LIMIT, type RealtimeAnomalyDetectionEvent, type RealtimeAnomalyInsightEvent, type RealtimeCloseEvent, type RealtimeError, type RealtimeEvent, type RealtimeEventType, type RealtimeFunctionRunEvent, RealtimeManager, type RealtimeOrchestrationRunEvent, type RealtimeRecordEvent, type RealtimeSubscribeOptions, type RealtimeSubscription, type RealtimeValidationBatchEvent, type RealtimeValidationSuggestionEvent, type RecordEventType, RecordEvents, type RecordTtlOptions, RecordsManager, type ReferencePropertyDefinition, type ResourceCategory, type SavedQueryDefinition, type SavedQueryScalarBinding, type ScalarValue, type SchemaDiscoveryMode, type SearchHit, type SearchOptions, type SearchResponse, type SelectClause, SmartQueriesManager, type SmartQuery, type SmartQueryDefinition, type SmartQueryExecuteResult, type SmartQueryFieldCondition, type SmartQueryJoin, type SmartQuerySort, type SmartQueryWhereClause, type SortClause, type StepEncryptedParam, type StringPropertyDefinition, type Structure, StructuresManager, type TestComputeFunctionInput, type TestComputeFunctionResult, type TestSmartQueryInput, type TextSearchClause, type TriggerExecutionType, type TriggerHealthMetrics, type TriggerHealthStatus, type TriggerInvokeResponse, type TriggerOrchestrationRunOptions, type TriggerScanOptions, type TriggerWithHealth, TriggersManager, type UpdateComputeFunctionInput, type UpdateOrchestrationInput, type UpdateSmartQueryInput, type UpdateStructureInput, type UpdateTriggerInput, type UpdateWebhookSubscriptionInput, type UrlParserOptions, type ValidateStructureInput, type ValidationBatchData, type ValidationEventType, type ValidationIssueType, ValidationManager, type ValidationResult, type ValidationSuggestion, type ValidationSuggestionData, type ValidationSuggestionStatus, type ValidationSummary, type VariableType, type WaitForScanOptions, type WebhookCancelResponse, type WebhookDeliveriesListMeta, type WebhookDelivery, type WebhookDeliveryStatus, type WebhookDeliverySummary, type WebhookReplayResponse, type WebhookSubscription, WebhookSubscriptionsManager, type WhereExpression, fetchClientToken, getAllowedDomainsApiPath, getAnomalyAnalysisTriggerApiPath, getAnomalyInsightAcknowledgeApiPath, getAnomalyInsightDismissApiPath, getAnomalyInsightsApiPath, getAnomalyInsightsBulkAcknowledgeApiPath, getAnomalyInsightsSummaryApiPath, getApiUrl, getAuthUrl, getCollectionBySlugApiPath, getCollectionInsightsApiPath, getCollectionValidateApiPath, getCollectionsApiPath, getComputeFunctionTestApiPath, getComputeFunctionsApiPath, getComputeJobStatusApiPath, getEndpointApiPath, getFileUploadApiPath, getFilesCanonicalApiPath, getFunctionRunsApiPath, getFunctionRunsByFunctionApiPath, getFunctionRunsByTriggerApiPath, getFunctionTriggerExecuteApiPath, getFunctionTriggerPauseApiPath, getFunctionTriggerResumeApiPath, getFunctionTriggersApiPath, getOrchestrationRunStepsApiPath, getOrchestrationRunsApiPath, getOrchestrationRunsCanonicalApiPath, getOrchestrationsApiPath, getRealtimeUrl, getRecordApiPath, getSavedQueryCanonicalByIdPath, getSavedQueryCanonicalCollectionPath, getSavedQueryCanonicalExecutePath, getSavedQueryCanonicalTestPath, getSearchApiPath, getSmartQueriesApiPath, getSmartQueriesStructureApiPath, getSmartQueryByNameApiPath, getSmartQueryExecuteApiPath, getSmartQueryTestApiPath, getStructureBySlugApiPath, getStructureInsightsApiPath, getStructureValidateApiPath, getStructuresApiPath, getValidationBulkAcceptApiPath, getValidationBulkRejectApiPath, getValidationPendingCountApiPath, getValidationRecordSuggestionsApiPath, getValidationScanApiPath, getValidationSuggestionAcceptApiPath, getValidationSuggestionRejectApiPath, getValidationSuggestionsApiPath, getValidationSummaryApiPath, getWebhookDeliveryCancelApiPath, getWebhookDeliveryRetryApiPath, getWebhookSubscriptionDeliveriesApiPath, getWebhookSubscriptionRotateSecretApiPath, getWebhookSubscriptionsApiPath, isCentraliError, operatorsForFieldType };
+export { type AcceptSuggestionResult, type AddAllowedDomainOptions, type AllowedDomain, type AllowedDomainsListResponse, AllowedDomainsManager, type AnomalyAnalysisResult, type AnomalyDetectionData, type AnomalyEventType, type AnomalyInsight, type AnomalyInsightData, AnomalyInsightsManager, type ApiResponse, type ArrayPropertyDefinition, AuditLogManager, type AuthorizationResult, type BasePropertyDefinition, type BatchScanResult, type BatchScanStatus, type BooleanPropertyDefinition, type BulkOperationResult, CANONICAL_OPERATORS, type CanonicalOperator, CentraliError, CentraliSDK, type CentraliSDKOptions, type CheckAuthorizationOptions, CollectionsManager, type ComputeEventType, type ComputeFunction, ComputeFunctionsManager, type ComputeJobStatus, type ComputeJobStatusResponse, type ConditionOperator, type CreateComputeFunctionInput, type CreateOrchestrationInput, type CreateSmartQueryInput, type CreateStructureInput, type CreateTriggerInput, type CreateWebhookSubscriptionInput, type DateTimePropertyDefinition, type DateWindowOption, type DeleteRecordOptions, type EndpointResponse, type ExecuteSavedQueryValues, type ExecuteSmartQueryOptions, type ExpandOptions, type FieldCondition, type FieldConditionMap, type FileMetadata, FilesManager, type FilterOperators, type FilterValue, type FunctionMemoryUsage, type FunctionRun, type FunctionRunError, type FunctionRunExecutionSource, type FunctionRunStatus, FunctionRunsManager, type FunctionTrigger, type GetRecordOptions, type IncludeClause, type InsightSeverity, type InsightStatus, type InsightType, type InsightsSummary, type InvokeEndpointOptions, type InvokeTriggerOptions, JOINS_MAX_LENGTH, type JoinClause, type JoinType, type LegacyTranslateOptions, type LegacyTranslateResult, type LegacyTranslateWarning, type ListAllTriggersOptions, type ListCollectionsOptions, type ListComputeFunctionsOptions, type ListFunctionRunsOptions, type ListInsightsOptions, type ListOrchestrationRunsOptions, type ListOrchestrationsOptions, type ListSmartQueryOptions, type ListStructuresOptions, type ListValidationSuggestionsOptions, type ListWebhookDeliveriesOptions, type NumberPropertyDefinition, OPERATOR_METADATA, type ObjectPropertyDefinition, type OperatorMeta, type OperatorTypeApplicability, type OperatorValueShape, type Orchestration, type OrchestrationCaseEvaluation, type OrchestrationCondition, type OrchestrationConditionEvaluation, type OrchestrationDecisionCase, type OrchestrationDecisionResult, type OrchestrationDelayConfig, type OrchestrationEventType, type OrchestrationFailureReason, type OrchestrationOnFailure, type OrchestrationOnSuccess, type OrchestrationRetryConfig, type OrchestrationRun, type OrchestrationRunStatus, type OrchestrationRunStep, OrchestrationRunsManager, type OrchestrationScheduleType, type OrchestrationStatus, type OrchestrationStep, type OrchestrationStepError, type OrchestrationStepStatus, type OrchestrationStepType, type OrchestrationTrigger, type OrchestrationTriggerMetadata, type OrchestrationTriggerType, OrchestrationsManager, type PageClause, type PaginatedResponse, type ParsedUrlQuery, type PropertyDefinition, type PropertyType, type QueryDefinition, type QueryError, type QueryErrorCode, type QueryExecutionMode, type QueryHttpError, type QueryHttpErrorCode, QueryManager, type QueryRecordOptions, type QueryResult, type QueryResultMeta, type QueryValidateOptions, type QueryVariableDefinition, RECORDS_PAGE_DEFAULT_LIMIT, RECORDS_PAGE_MAX_LIMIT, type RealtimeAnomalyDetectionEvent, type RealtimeAnomalyInsightEvent, type RealtimeCloseEvent, type RealtimeError, type RealtimeEvent, type RealtimeEventType, type RealtimeFunctionRunEvent, RealtimeManager, type RealtimeOrchestrationRunEvent, type RealtimeRecordEvent, type RealtimeSubscribeOptions, type RealtimeSubscription, type RealtimeValidationBatchEvent, type RealtimeValidationSuggestionEvent, type RecordEventType, RecordEvents, type RecordTtlOptions, RecordsManager, type ReferencePropertyDefinition, type ResourceCategory, type SavedQueryDefinition, type SavedQueryScalarBinding, type ScalarValue, type SchemaDiscoveryMode, type SearchHit, type SearchOptions, type SearchResponse, type SelectClause, SmartQueriesManager, type SmartQuery, type SmartQueryDefinition, type SmartQueryExecuteResult, type SmartQueryFieldCondition, type SmartQueryJoin, type SmartQuerySort, type SmartQueryWhereClause, type SortClause, type StepEncryptedParam, type StringPropertyDefinition, type Structure, StructuresManager, type TestComputeFunctionInput, type TestComputeFunctionResult, type TestSmartQueryInput, type TextSearchClause, type TriggerExecutionType, type TriggerHealthMetrics, type TriggerHealthStatus, type TriggerInvokeResponse, type TriggerOrchestrationRunOptions, type TriggerScanOptions, type TriggerWithHealth, TriggersManager, type UpdateComputeFunctionInput, type UpdateOrchestrationInput, type UpdateSmartQueryInput, type UpdateStructureInput, type UpdateTriggerInput, type UpdateWebhookSubscriptionInput, type UrlParserOptions, type ValidateStructureInput, type ValidationBatchData, type ValidationEventType, type ValidationIssueType, ValidationManager, type ValidationResult, type ValidationSuggestion, type ValidationSuggestionData, type ValidationSuggestionStatus, type ValidationSummary, type VariableType, type WaitForScanOptions, type WebhookCancelResponse, type WebhookDeliveriesListMeta, type WebhookDelivery, type WebhookDeliveryStatus, type WebhookDeliverySummary, type WebhookPayloadVersions, type WebhookReplayResponse, type WebhookSubscription, WebhookSubscriptionsManager, type WhereExpression, fetchClientToken, getAllowedDomainsApiPath, getAnomalyAnalysisTriggerApiPath, getAnomalyInsightAcknowledgeApiPath, getAnomalyInsightDismissApiPath, getAnomalyInsightsApiPath, getAnomalyInsightsBulkAcknowledgeApiPath, getAnomalyInsightsSummaryApiPath, getApiUrl, getAuthUrl, getCollectionBySlugApiPath, getCollectionInsightsApiPath, getCollectionValidateApiPath, getCollectionsApiPath, getComputeFunctionTestApiPath, getComputeFunctionsApiPath, getComputeJobStatusApiPath, getEndpointApiPath, getFileUploadApiPath, getFilesCanonicalApiPath, getFunctionRunsApiPath, getFunctionRunsByFunctionApiPath, getFunctionRunsByTriggerApiPath, getFunctionTriggerExecuteApiPath, getFunctionTriggerPauseApiPath, getFunctionTriggerResumeApiPath, getFunctionTriggersApiPath, getOrchestrationRunStepsApiPath, getOrchestrationRunsApiPath, getOrchestrationRunsCanonicalApiPath, getOrchestrationsApiPath, getRealtimeUrl, getRecordApiPath, getSavedQueryCanonicalByIdPath, getSavedQueryCanonicalCollectionPath, getSavedQueryCanonicalExecutePath, getSavedQueryCanonicalTestPath, getSearchApiPath, getSmartQueriesApiPath, getSmartQueriesStructureApiPath, getSmartQueryByNameApiPath, getSmartQueryExecuteApiPath, getSmartQueryTestApiPath, getStructureBySlugApiPath, getStructureInsightsApiPath, getStructureValidateApiPath, getStructuresApiPath, getValidationBulkAcceptApiPath, getValidationBulkRejectApiPath, getValidationPendingCountApiPath, getValidationRecordSuggestionsApiPath, getValidationScanApiPath, getValidationSuggestionAcceptApiPath, getValidationSuggestionRejectApiPath, getValidationSuggestionsApiPath, getValidationSummaryApiPath, getWebhookDeliveryCancelApiPath, getWebhookDeliveryRetryApiPath, getWebhookPayloadVersionsApiPath, getWebhookSubscriptionDeliveriesApiPath, getWebhookSubscriptionRotateSecretApiPath, getWebhookSubscriptionsApiPath, isCentraliError, operatorsForFieldType };

package/dist/index.js

@@ -150,6 +150,7 @@ __export(index_exports, {
   getValidationSummaryApiPath: () => getValidationSummaryApiPath,
   getWebhookDeliveryCancelApiPath: () => getWebhookDeliveryCancelApiPath,
   getWebhookDeliveryRetryApiPath: () => getWebhookDeliveryRetryApiPath,
+  getWebhookPayloadVersionsApiPath: () => getWebhookPayloadVersionsApiPath,
   getWebhookSubscriptionDeliveriesApiPath: () => getWebhookSubscriptionDeliveriesApiPath,
   getWebhookSubscriptionRotateSecretApiPath: () => getWebhookSubscriptionRotateSecretApiPath,
   getWebhookSubscriptionsApiPath: () => getWebhookSubscriptionsApiPath,
@@ -385,6 +386,9 @@ function getWebhookSubscriptionsApiPath(workspaceId, subscriptionId) {
   const basePath = `data/workspace/${workspaceId}/api/v1/webhook-subscriptions`;
   return subscriptionId ? `${basePath}/${subscriptionId}` : basePath;
 }
+function getWebhookPayloadVersionsApiPath(workspaceId) {
+  return `data/workspace/${workspaceId}/api/v1/webhook-subscriptions/payload-versions`;
+}
 function getWebhookSubscriptionRotateSecretApiPath(workspaceId, subscriptionId) {
   return `data/workspace/${workspaceId}/api/v1/webhook-subscriptions/${subscriptionId}/rotate-secret`;
 }
@@ -7999,6 +8003,21 @@ var WebhookSubscriptionsManager = class {
     const path = getWebhookSubscriptionRotateSecretApiPath(this.workspaceId, subscriptionId);
     return this.requestFn("POST", path);
   }
+  /**
+   * List the outbound payload versions a subscription can be pinned to via
+   * `create`/`update`'s `payloadVersion`. Each version selects the shape its
+   * deliveries are projected into; subscribers upgrade on their own timeline.
+   *
+   * @example
+   * ```ts
+   * const { data } = await centrali.webhookSubscriptions.getPayloadVersions();
+   * console.log('Latest payload version:', data.latest);
+   * ```
+   */
+  getPayloadVersions() {
+    const path = getWebhookPayloadVersionsApiPath(this.workspaceId);
+    return this.requestFn("GET", path);
+  }
 };
 
 // src/client.ts
@@ -9315,6 +9334,7 @@ var CentraliSDK = class {
   getValidationSummaryApiPath,
   getWebhookDeliveryCancelApiPath,
   getWebhookDeliveryRetryApiPath,
+  getWebhookPayloadVersionsApiPath,
   getWebhookSubscriptionDeliveriesApiPath,
   getWebhookSubscriptionRotateSecretApiPath,
   getWebhookSubscriptionsApiPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@centrali-io/centrali-sdk",
-  "version": "6.6.0",
+  "version": "6.7.0",
   "description": "Centrali Node SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/internal/paths.ts

@@ -424,6 +424,14 @@ export function getWebhookSubscriptionsApiPath(workspaceId: string, subscription
     return subscriptionId ? `${basePath}/${subscriptionId}` : basePath;
 }
 
+/**
+ * Generate the payload-versions API URL PATH. Lists the outbound payload
+ * versions a subscription can be pinned to.
+ */
+export function getWebhookPayloadVersionsApiPath(workspaceId: string): string {
+    return `data/workspace/${workspaceId}/api/v1/webhook-subscriptions/payload-versions`;
+}
+
 /**
  * Generate rotate-secret API URL PATH for a webhook subscription.
  */

package/src/managers/webhookSubscriptions.ts

@@ -11,12 +11,14 @@ import type {
     WebhookDeliveriesListMeta,
     WebhookReplayResponse,
     WebhookCancelResponse,
+    WebhookPayloadVersions,
     CreateWebhookSubscriptionInput,
     UpdateWebhookSubscriptionInput,
     ListWebhookDeliveriesOptions,
 } from '../types/webhooks';
 import {
     getWebhookSubscriptionsApiPath,
+    getWebhookPayloadVersionsApiPath,
     getWebhookSubscriptionRotateSecretApiPath,
     getWebhookSubscriptionDeliveriesApiPath,
     getWebhookDeliveryRetryApiPath,
@@ -203,4 +205,20 @@ export class WebhookSubscriptionsManager {
         const path = getWebhookSubscriptionRotateSecretApiPath(this.workspaceId, subscriptionId);
         return this.requestFn<WebhookSubscription>('POST', path);
     }
+
+    /**
+     * List the outbound payload versions a subscription can be pinned to via
+     * `create`/`update`'s `payloadVersion`. Each version selects the shape its
+     * deliveries are projected into; subscribers upgrade on their own timeline.
+     *
+     * @example
+     * ```ts
+     * const { data } = await centrali.webhookSubscriptions.getPayloadVersions();
+     * console.log('Latest payload version:', data.latest);
+     * ```
+     */
+    public getPayloadVersions(): Promise<ApiResponse<WebhookPayloadVersions>> {
+        const path = getWebhookPayloadVersionsApiPath(this.workspaceId);
+        return this.requestFn<WebhookPayloadVersions>('GET', path);
+    }
 }

package/src/types/compute.ts

@@ -102,6 +102,8 @@ export interface FunctionRun {
     triggerType?: string | null;
     orchestrationRunId?: string | null;
     orchestrationStepId?: string | null;
+    /** Inbound durable buffer link (CEN-1297) — set for buffered webhook-trigger runs. */
+    inboundEventId?: string | null;
     originalRunId?: string | null;
     isRerun: boolean;
     rerunCount: number;

package/src/types/webhooks.ts

@@ -22,6 +22,20 @@ export interface WebhookSubscription {
      * undefined on subsequent reads so it is safe to pass subscriptions around.
      */
     secret?: string;
+    /**
+     * Outbound payload version this subscription receives — a date-string
+     * (`YYYY-MM`). Deliveries are projected into the shape this version
+     * describes. Frozen at creation; change it to upgrade to a newer shape.
+     */
+    payloadVersion: string;
+    /**
+     * Opaque builder-supplied tenant identifier. Carried onto outbound
+     * delivery rows by the platform so embeds and tenant-scoped views can
+     * filter to a single customer without leaking cross-tenant events.
+     * Centrali never parses or interprets this value — it's the builder's
+     * own customer/account/workspace id, whatever shape that takes.
+     */
+    tenantId?: string | null;
     workspaceSlug: string;
     createdAt?: string;
     updatedAt?: string;
@@ -46,6 +60,8 @@ export interface WebhookDelivery {
     responseBody?: string | null;
     /** Delivery ID the row was replayed from, or null for original deliveries. */
     replayedFrom?: string | null;
+    /** Outbound payload version this delivery was projected into and served with. */
+    payloadVersion: string;
     createdAt: string;
     updatedAt: string;
 }
@@ -64,6 +80,19 @@ export interface CreateWebhookSubscriptionInput {
     /** Optional — restrict to a subset of collections. Omit for all collections. */
     recordSlugs?: string[];
     active?: boolean;
+    /**
+     * Optional outbound payload version to pin the subscription to. Omit to
+     * freeze to the latest version at creation time. Must be a value returned
+     * by `getPayloadVersions()`.
+     */
+    payloadVersion?: string;
+    /**
+     * Optional opaque tenant identifier — typically the builder's own
+     * customer or account id. Surfaces on every delivery the subscription
+     * produces so tenant-scoped views (e.g. an embedded Event Log) can
+     * filter to one customer.
+     */
+    tenantId?: string | null;
 }
 
 export interface UpdateWebhookSubscriptionInput {
@@ -77,6 +106,27 @@ export interface UpdateWebhookSubscriptionInput {
      */
     recordSlugs?: string[];
     active?: boolean;
+    /**
+     * Upgrade (or downgrade) the outbound payload version. Must be a value
+     * returned by `getPayloadVersions()`. Omit to leave the version unchanged.
+     */
+    payloadVersion?: string;
+    /**
+     * Update the opaque tenant identifier. Pass `null` to clear it; omit to
+     * leave it unchanged. Past deliveries are not retroactively rewritten —
+     * the new value applies to deliveries created after the update.
+     */
+    tenantId?: string | null;
+}
+
+/**
+ * Outbound payload versions a subscription can be pinned to. Returned by
+ * `getPayloadVersions()`. `versions` is oldest-first; `latest` is what a
+ * subscription created without an explicit version is frozen to.
+ */
+export interface WebhookPayloadVersions {
+    versions: string[];
+    latest: string;
 }
 
 export interface ListWebhookDeliveriesOptions {