@productcraft/social 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -13,7 +13,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List actors in a community. 50 per page by default (max 200) — paginate with the cursor returned in `pagination.next_cursor` while `pagination.has_more` is true. */
+        /** List actors in a community. 50 per page by default (max 200) — paginate with the cursor returned in `pagination.next_cursor` while `pagination.has_more` is true. Pass `?ids=<uuid,uuid,…>` (max 100) to batch-fetch specific actors instead — one hydration call for a screenful of ids; unknown ids are silently omitted and `pagination` is the exhausted shape (`next_cursor: null`). */
         get: operations["ActorController_list"];
         put?: never;
         /** Upsert an actor by external_id. Creates on first call, updates on subsequent calls with the same external_id. Idempotent on `(community, external_id)`. Note: omitted fields on a follow-up call are overwritten with the new body — pass every field you want to keep on each call. */
@@ -24,6 +24,40 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/actors/batch": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Bulk actor upsert (max 200 per call) — the import lane. Each item runs the exact single-upsert path; results come back per item with partial success (`201` even when some items fail — inspect `success` / `error` per entry). No wrapping transaction. */
+        post: operations["ActorController_batchUpsert"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/communities/{communityId}/actors/by-external/batch": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Batch-resolve external_ids to actors (max 200 per call). POST-only — external_ids are up to 256 chars and can't ride a querystring. Unknown ids come back in `missing[]` instead of failing the call. */
+        post: operations["ActorController_batchGetByExternal"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/actors/by-external/{externalId}": {
         parameters: {
             query?: never;
@@ -67,7 +101,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List actors this actor has blocked. */
+        /** List actors this actor has blocked. Pass `?expand=dst_actor` to nest each blocked actor's full row on the edge. */
         get: operations["EdgeController_listBlocks"];
         put?: never;
         post?: never;
@@ -178,7 +212,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List the actors who follow this actor. */
+        /** List the actors who follow this actor. Pass `?expand=src_actor` to nest each follower's full actor row on the edge — a followers screen renders from this one call. */
         get: operations["EdgeController_listFollowers"];
         put?: never;
         post?: never;
@@ -195,7 +229,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List the actors this actor follows. */
+        /** List the actors this actor follows. Pass `?expand=dst_actor` to nest each followee's full actor row on the edge (no N+1 hydration). */
         get: operations["EdgeController_listFollowing"];
         put?: never;
         post?: never;
@@ -322,7 +356,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List actors this actor has muted. */
+        /** List actors this actor has muted. Pass `?expand=dst_actor` to nest each muted actor's full row on the edge. */
         get: operations["EdgeController_listMutes"];
         put?: never;
         post?: never;
@@ -452,6 +486,26 @@ interface paths {
         patch: operations["NotificationController_markRead"];
         trace?: never;
     };
+    "/v1/communities/{communityId}/actors/{actorId}/post-state": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Batch viewer-state hydration: the actor's reactions, bookmark, repost, and poll-vote state for up to 200 posts in one call.
+         * @description Read-over-POST (the id list is too large for a query string) — no side effects, no Idempotency-Key needed. Renders a whole feed page's "liked by you" / saved / reposted / voted state with one request on top of the feed call.
+         */
+        post: operations["ViewerStateController_postState"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/actors/{actorId}/restricts": {
         parameters: {
             query?: never;
@@ -459,7 +513,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List actors this actor has restricted. */
+        /** List actors this actor has restricted. Pass `?expand=dst_actor` to nest each restricted actor's full row on the edge. */
         get: operations["EdgeController_listRestricts"];
         put?: never;
         post?: never;
@@ -529,6 +583,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/actors/{srcActorId}/relationships": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Batched pairwise relationship lookup: does this actor follow / mute / block / restrict each of up to 100 others (and is it followed / blocked back)?
+         * @description One query resolves the seven pairwise flags for a whole profile header or member list — no paging of full edge lists, and `blocked_by` is visible without attempting a write and handling the 409. Unknown or cross-community ids resolve to all-false flags; the id list is de-duplicated preserving request order. Bounded input (max 100 ids), so the response has no pagination envelope.
+         */
+        get: operations["EdgeController_relationships"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/blocks": {
         parameters: {
             query?: never;
@@ -613,7 +687,7 @@ interface paths {
         /** List the caller's conversations in this community, most-recent-activity first. */
         get: operations["ConversationController_list"];
         put?: never;
-        /** Open a conversation. Default `kind="direct"` is the idempotent 1-on-1 path. Pass `kind="group"` with `actor_ids` for a multi-participant chat (always creates a new row; no idempotency for groups). */
+        /** Open a conversation. Default `kind="direct"` is the naturally-idempotent 1-on-1 path (get-or-create by participant pair). Pass `kind="group"` with `actor_ids` for a multi-participant chat — group creates always insert a new row, so pass an `Idempotency-Key` header to make group-create retries safe. */
         post: operations["ConversationController_create"];
         delete?: never;
         options?: never;
@@ -702,7 +776,7 @@ interface paths {
         /** List messages in the conversation. Default newest-first cursor. Pass `since` (encoded cursor of the last-seen message) to poll for newer messages instead. */
         get: operations["ConversationController_listMessages"];
         put?: never;
-        /** Send a message in the conversation. */
+        /** Send a message in the conversation. Pass an `Idempotency-Key` header to make retries safe — a retried send never delivers the message twice. */
         post: operations["ConversationController_send"];
         delete?: never;
         options?: never;
@@ -797,6 +871,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/counters": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Batch counters (max 100 actors per call) — render a member list with follower badges from ONE call instead of one per actor. Unknown actor_ids come back in `missing[]` instead of failing the read. */
+        get: operations["CounterController_getBatchCounters"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/discover-feed": {
         parameters: {
             query?: never;
@@ -848,6 +939,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/follows/batch": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Bulk follow creation (max 200 per call) — the graph-import lane. Each item runs the exact single-follow path (block checks, counters, idempotency), so a blocked pair fails ITS item with a 409 in `error` while the rest of the batch proceeds. `201` even with failures — inspect per-item results. Set `suppress_notifications: true` when importing an existing graph. */
+        post: operations["EdgeController_batchFollows"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/follows/{srcActorId}/{dstActorId}": {
         parameters: {
             query?: never;
@@ -926,7 +1034,7 @@ interface paths {
         /** List discoverable lists in this community. Public lists are visible to anyone; private lists surface only when `viewer_actor_id` is their owner. */
         get: operations["ActorListController_list"];
         put?: never;
-        /** Create a new list. Default visibility `private`. */
+        /** Create a new list. Default visibility `private`. List creation has no natural key (an owner can hold many same-named lists), so pass an `Idempotency-Key` header to make retries safe. */
         post: operations["ActorListController_create"];
         delete?: never;
         options?: never;
@@ -1049,7 +1157,7 @@ interface paths {
         /** List posts. Pass `author_id` to filter to a single author. 50/page (max 200), cursor-paginated. */
         get: operations["PostController_list"];
         put?: never;
-        /** Create a post on behalf of an actor. */
+        /** Create a post on behalf of an actor. Pass an `Idempotency-Key` header to make retries safe — replays return the original response with `Idempotent-Replay: true` for 24h. */
         post: operations["PostController_create"];
         delete?: never;
         options?: never;
@@ -1127,7 +1235,7 @@ interface paths {
         /** List comments on a post. Default returns top-level comments newest-first; pass `parent_id` to expand a thread (oldest-first). Pass `requester_id` so DM-style `author_only` replies surface only to the post-author and the comment-author pair. */
         get: operations["CommentController_list"];
         put?: never;
-        /** Add a comment on a post. Pass `parent_id` to reply; the depth is computed and capped by the community config. */
+        /** Add a comment on a post. Pass `parent_id` to reply; the depth is computed and capped by the community config. Pass an `Idempotency-Key` header to make retries safe. */
         post: operations["CommentController_create"];
         delete?: never;
         options?: never;
@@ -1253,7 +1361,8 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        get?: never;
+        /** List reactions on a post, newest-first. Cursor encodes `(created_at, actor_id, type)` so multi-reaction-from-same-actor stays stable. Pass `type` to narrow to one reaction type. */
+        get: operations["PostReactionController_list"];
         put?: never;
         /** React to a post. Idempotent: re-posting the same (actor, type) returns the existing edge with `created: false`. */
         post: operations["PostReactionController_react"];
@@ -1499,10 +1608,10 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Read the community's active webhook (or null). */
-        get: operations["WebhookController_getActive"];
+        /** List the community's webhooks — disabled rows included, so an auto-disabled subscriber stays discoverable. */
+        get: operations["WebhookController_list"];
         put?: never;
-        /** Create the community webhook. One active subscriber per community. Returns the signing secret ONCE — store it. */
+        /** Create a community webhook. Multiple subscribers per community are supported (cap 10). Returns the signing secret ONCE — store it. Pass an `Idempotency-Key` header so a retried create replays the SAME secret instead of minting a duplicate subscriber. */
         post: operations["WebhookController_create"];
         delete?: never;
         options?: never;
@@ -1525,7 +1634,7 @@ interface paths {
         delete: operations["WebhookController_delete"];
         options?: never;
         head?: never;
-        /** Update webhook url + subscribed event types. */
+        /** Update webhook url, subscribed event types, or disabled state. `{ "disabled": false }` is the re-enable path after an auto-disable — no secret rotation required. */
         patch: operations["WebhookController_update"];
         trace?: never;
     };
@@ -1546,6 +1655,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/webhooks/{webhookId}/deliveries/{deliveryId}/redeliver": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Re-publish a past delivery from its stored request body. Async (202). The payload is byte-identical to the original (same event id), so subscriber-side event-id dedupe treats it as a redelivery. */
+        post: operations["WebhookController_redeliver"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/webhooks/{webhookId}/rotate-secret": {
         parameters: {
             query?: never;
@@ -1555,7 +1681,7 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Rotate the signing secret. Also clears any auto-disable flag. Returns the new secret ONCE. */
+        /** Rotate the signing secret. Also clears any auto-disable flag. Returns the new secret ONCE. Pass an `Idempotency-Key` header so a retried rotate replays the SAME new secret instead of rotating twice. */
         post: operations["WebhookController_rotateSecret"];
         delete?: never;
         options?: never;
@@ -1563,6 +1689,40 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/webhooks/{webhookId}/test": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Enqueue a `ping` test delivery. Async (202): the dispatch worker signs and POSTs it exactly like a real event — SSRF guard, TLS, HMAC signature and all. Watch the deliveries list for the outcome. */
+        post: operations["WebhookController_testPing"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/webhook-event-types": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List the webhook event-type catalog. Static metadata, no auth required. Create/update webhooks reject anything not in this list with a 400. */
+        get: operations["WebhookEventTypesController_list"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/workspaces/{workspaceId}/communities": {
         parameters: {
             query?: never;
@@ -1573,7 +1733,7 @@ interface paths {
         /** List communities in a workspace */
         get: operations["CommunityController_list"];
         put?: never;
-        /** Create an social community. `app_id` is optional — when supplied Social connects the community to an Auth app and refuses if the app belongs to a different workspace (cross-tenant gate) or is already connected. Omit `app_id` for a standalone community (no Auth integration; the customer manages actor identity). */
+        /** Create an social community. `app_id` is optional — when supplied Social connects the community to an Auth app and refuses if the app belongs to a different workspace (cross-tenant gate) or is already connected. Omit `app_id` for a standalone community (no Auth integration; the customer manages actor identity). Pass an `Idempotency-Key` header to make retries safe. */
         post: operations["CommunityController_create"];
         delete?: never;
         options?: never;
@@ -1626,7 +1786,7 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Apply a shadow ban to an actor. The actor sees their own content normally; everyone else sees nothing from them. Pass `duration_hours` for a timed ban or omit for indefinite. */
+        /** Apply a shadow ban to an actor. The actor sees their own content normally; everyone else sees nothing from them. Pass `duration_hours` for a timed ban or omit for indefinite. Pass an `Idempotency-Key` header so a retried timed ban doesn't restart the clock. */
         post: operations["ModerationAdminController_shadowBan"];
         /** Remove a shadow ban. No-op if not currently shadow-banned. */
         delete: operations["ModerationAdminController_unshadow"];
@@ -1712,7 +1872,7 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Apply a moderation action to a flag. Records an audit entry and updates the target post/comment status. */
+        /** Apply a moderation action to a flag. Records an audit entry and updates the target post/comment status. Pass an `Idempotency-Key` header so a retried request records ONE audit entry, not two. */
         post: operations["ModerationAdminController_act"];
         delete?: never;
         options?: never;
@@ -1946,6 +2106,17 @@ interface components {
             /** @description Up to `limit` (default 20, max 50) ranked hits. Not paginated in v1; results are bounded by `limit`. */
             data: components["schemas"]["ActorSearchHitDto"][];
         };
+        ActorsByExternalBatchResponseDto: {
+            /** @description Actors found, in request order (after de-duplication). */
+            data: components["schemas"]["ActorResponseDto"][];
+            /**
+             * @description external_ids with no actor in this community.
+             * @example [
+             *       "user_ghost"
+             *     ]
+             */
+            missing: string[];
+        };
         AddCommentReactionResponseDto: {
             /**
              * @description `true` on first call; `false` on idempotent retry.
@@ -2011,6 +2182,109 @@ interface components {
             data: components["schemas"]["ModerationActionResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
+        BatchActorResultDto: {
+            /** @description The upserted actor — present on success. */
+            actor?: components["schemas"]["ActorResponseDto"];
+            /**
+             * @description `true` if this item inserted a new row, `false` on an update of an existing external_id. Present on success.
+             * @example true
+             */
+            created?: boolean;
+            /** @description The error this item would have returned as a standalone call — present on failure. */
+            error?: components["schemas"]["ErrorResponseDto"];
+            /**
+             * @description Position of this result in the request array.
+             * @example 0
+             */
+            index: number;
+            /**
+             * @description `true` when this item was upserted; `false` when it failed (see `error`).
+             * @example true
+             */
+            success: boolean;
+        };
+        BatchActorsResponseDto: {
+            /** @description One result per input item, same order. */
+            data: components["schemas"]["BatchActorResultDto"][];
+            /**
+             * @description Count of failed items.
+             * @example 1
+             */
+            failed: number;
+            /**
+             * @description Count of successful items.
+             * @example 199
+             */
+            succeeded: number;
+        };
+        BatchCountersResponseDto: {
+            /** @description Counters for each actor found, in `actor_ids` order (after de-duplication). */
+            data: components["schemas"]["ActorCountersResponseDto"][];
+            /**
+             * @description actor_ids with no actor in this community.
+             * @example []
+             */
+            missing: string[];
+        };
+        BatchExternalIdsDto: {
+            /**
+             * @description external_ids to resolve, 1–200 items (POST body — 256-char ids can't ride a querystring). Duplicates are de-duplicated.
+             * @example [
+             *       "user_abc123",
+             *       "user_def456"
+             *     ]
+             */
+            external_ids: string[];
+        };
+        BatchFollowResultDto: {
+            /**
+             * @description `true` if this item created a new edge, `false` on an idempotent retry of an existing follow. Present on success.
+             * @example true
+             */
+            created?: boolean;
+            /** @description The follow edge — present on success. */
+            edge?: components["schemas"]["EdgeResponseDto"];
+            /** @description The error this item would have returned as a standalone call (e.g. 409 block in place, 422 self-follow, 404 unknown actor) — present on failure. */
+            error?: components["schemas"]["ErrorResponseDto"];
+            /**
+             * @description Position of this result in the request array.
+             * @example 0
+             */
+            index: number;
+            /**
+             * @description `true` when this follow was created (or already existed); `false` when it failed (see `error`).
+             * @example true
+             */
+            success: boolean;
+        };
+        BatchFollowsDto: {
+            /** @description Follow edges to create, in order. 1–200 items; each item follows the single-follow body exactly. */
+            follows: components["schemas"]["ActorEdgeDto"][];
+            /**
+             * @description Import lane: when `true`, the per-item `edge.follow.created` fan-out (follow notifications AND webhooks) is skipped for this batch. Follower/following counters still update. Use when importing an existing graph so long-standing followers don't get "X followed you" notifications.
+             * @default false
+             * @example true
+             */
+            suppress_notifications: boolean;
+        };
+        BatchFollowsResponseDto: {
+            /** @description One result per input item, same order. */
+            data: components["schemas"]["BatchFollowResultDto"][];
+            /**
+             * @description Count of failed items.
+             * @example 1
+             */
+            failed: number;
+            /**
+             * @description Count of successful items.
+             * @example 4999
+             */
+            succeeded: number;
+        };
+        BatchUpsertActorsDto: {
+            /** @description Actors to upsert, in order. 1–200 items; each item follows the single-upsert body exactly. */
+            actors: components["schemas"]["UpsertActorDto"][];
+        };
         BookmarkListResponseDto: {
             data: components["schemas"]["BookmarkResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
@@ -2250,6 +2524,48 @@ interface components {
              */
             total_posts: number;
         };
+        CommunityRankingSettingsDto: {
+            /**
+             * @description Ranked-feed candidate window in days — posts older than this are not scored. Strictly positive finite number.
+             * @default 30
+             * @example 30
+             */
+            candidate_window_days: number;
+            /**
+             * @description Recency half-life in hours for the ranked feed. Strictly positive finite number.
+             * @default 24
+             * @example 24
+             */
+            half_life_hours: number;
+            /** @description Per-signal weights for the ranked feed. Each key falls back to its default independently. */
+            weights?: components["schemas"]["CommunityRankingWeightsDto"];
+        };
+        CommunityRankingWeightsDto: {
+            /**
+             * @description Engagement signal weight (log-scaled comments + reactions). Non-negative finite number.
+             * @default 0.6
+             * @example 0.6
+             */
+            engagement: number;
+            /**
+             * @description Follow-graph bias weight. Non-negative finite number.
+             * @default 0.4
+             * @example 0.4
+             */
+            follow_bias: number;
+            /**
+             * @description Recency signal weight (exponential decay). Non-negative finite number; anything else falls back to the default.
+             * @default 1
+             * @example 1
+             */
+            recency: number;
+            /**
+             * @description Self-author boost weight (keeps the viewer's own posts visible). Non-negative finite number.
+             * @default 0.2
+             * @example 0.2
+             */
+            self_boost: number;
+        };
         CommunityResponseDto: {
             /**
              * @description Auth app UUID this community wraps; `null` for standalone communities.
@@ -2282,12 +2598,12 @@ interface components {
              */
             id: string;
             /**
-             * @description Per-community settings blob (ranking, max_comment_depth, auto_hide_flag_threshold, reaction_types).
+             * @description Per-community settings blob. See CommunitySettingsDto for every key the service reads; unrecognized keys are stored and returned unchanged but not consumed.
              * @example {
              *       "max_comment_depth": 3
              *     }
              */
-            settings: Record<string, never>;
+            settings: components["schemas"]["CommunitySettingsDto"];
             /**
              * @description URL-friendly community slug.
              * @example my-product-community
@@ -2310,6 +2626,34 @@ interface components {
              */
             workspace_id: string;
         };
+        CommunitySettingsDto: {
+            /**
+             * @description Distinct-reporter count at which a flagged post/comment is auto-hidden. Integer 0..1000; floored. Read by the moderation flag pipeline.
+             * @default 3
+             * @example 3
+             */
+            auto_hide_flag_threshold: number;
+            /**
+             * @description Minutes after publication during which a post body/title may still be edited (`EDIT_WINDOW_EXPIRED` afterwards). Strictly positive finite number. Drafts edit freely.
+             * @default 30
+             * @example 30
+             */
+            edit_window_minutes: number;
+            /**
+             * @description Maximum comment thread depth (0 = flat). Integer 0..10; floored; out-of-bounds falls back to the default. Replying past the cap returns 409.
+             * @default 3
+             * @example 3
+             */
+            max_comment_depth: number;
+            /**
+             * @description Maximum participants in a group conversation. Integer 2..200; floored. Exceeding it returns 409 on create / member add.
+             * @default 50
+             * @example 50
+             */
+            max_group_conversation_size: number;
+            /** @description Ranked-feed tuning (weights, half-life, candidate window). Read at query time by the actor feed, list feeds, and the discover feed. */
+            ranking?: components["schemas"]["CommunityRankingSettingsDto"];
+        };
         ConversationAdminListResponseDto: {
             data: components["schemas"]["ConversationAdminResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
@@ -2514,8 +2858,8 @@ interface components {
              * @example My Product Community
              */
             display_name: string;
-            /** @description Per-community settings blob (ranking, max_comment_depth, auto_hide_flag_threshold). */
-            settings?: Record<string, never>;
+            /** @description Per-community settings blob. Supported keys are typed on CommunitySettingsDto; unrecognized keys are stored verbatim but not consumed. */
+            settings?: components["schemas"]["CommunitySettingsDto"];
             /**
              * @description URL-friendly community slug. Lowercase letters, digits, and hyphens (3-64 chars).
              * @example my-product-community
@@ -2717,13 +3061,13 @@ interface components {
         };
         CreateWebhookDto: {
             /**
-             * @description Event types to subscribe to. Currently supported: `post.created`, `post.updated`, `post.reaction.created`, `repost.created`, `comment.created`, `comment.updated`, `comment.reaction.created`, `edge.follow.created`.
+             * @description Event types to subscribe to. Unknown values are rejected with a 400 naming the valid set — see GET /v1/webhook-event-types.
              * @example [
              *       "post.created",
              *       "comment.created"
              *     ]
              */
-            event_types: string[];
+            event_types: ("post.created" | "post.updated" | "post.deleted" | "post.reaction.created" | "repost.created" | "comment.created" | "comment.updated" | "comment.deleted" | "comment.reaction.created" | "edge.follow.created" | "edge.follow.deleted" | "flag.created" | "flag.updated" | "moderation.action.applied" | "actor.updated" | "dm.message.created")[];
             /**
              * @description Subscriber URL. Must be `https://`.
              * @example https://example.com/webhooks/social
@@ -2757,13 +3101,13 @@ interface components {
              */
             disabled_reason: string | null;
             /**
-             * @description Subscribed event types. Each item is one of the social event names (e.g. `post.created`, `comment.created`, `edge.follow.created`).
+             * @description Subscribed event types. Each item is one of the social event names — see GET /v1/webhook-event-types for the live catalog.
              * @example [
              *       "post.created",
              *       "comment.created"
              *     ]
              */
-            event_types: string[];
+            event_types: ("post.created" | "post.updated" | "post.deleted" | "post.reaction.created" | "repost.created" | "comment.created" | "comment.updated" | "comment.deleted" | "comment.reaction.created" | "edge.follow.created" | "edge.follow.deleted" | "flag.created" | "flag.updated" | "moderation.action.applied" | "actor.updated" | "dm.message.created")[];
             /**
              * @description Webhook UUID.
              * @example wwwwwwww-0000-0000-0000-000000000001
@@ -2814,13 +3158,60 @@ interface components {
              */
             sender_id: string;
         };
+        DeliveryJobResponseDto: {
+            /**
+             * @description Delivery attempts made so far.
+             * @example 0
+             */
+            attempt_count: number;
+            /**
+             * @description ISO timestamp.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description Stable event id (carried in the request body as `id`; stable across retries and redelivers).
+             * @example evt_…
+             */
+            event_id: string;
+            /**
+             * @description Event type. `ping` for test deliveries.
+             * @example post.created
+             */
+            event_type: string;
+            /** @description Delivery job UUID. */
+            id: string;
+            /**
+             * @description Error from the most recent failed attempt. Null before the first failure.
+             * @example null
+             */
+            last_error: string | null;
+            /**
+             * @description ISO timestamp of the next scheduled attempt (backoff: 1m, 5m, 30m, 2h, 6h, 24h).
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            next_attempt_at: string;
+            /**
+             * @description Job state.
+             * @example pending
+             * @enum {string}
+             */
+            status: "pending" | "delivering" | "succeeded" | "exhausted" | "canceled";
+            /**
+             * @description ISO timestamp.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            updated_at: string;
+            /** @description Webhook UUID the job targets. */
+            webhook_id: string;
+        };
         DeliveryListResponseDto: {
             data: components["schemas"]["DeliveryResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
         DeliveryResponseDto: {
             /**
-             * @description Attempt number. Always 1 in v1 (no retry).
+             * @description Attempt number, 1-based. Increments per retry along the backoff schedule (1m, 5m, 30m, 2h, 6h, 24h — 7 attempts total).
              * @example 1
              */
             attempt_number: number;
@@ -3079,10 +3470,6 @@ interface components {
             data: components["schemas"]["PostResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
-        EdgeListResponseDto: {
-            data: components["schemas"]["EdgeResponseDto"][];
-            pagination: components["schemas"]["PaginationResponseDto"];
-        };
         EdgeResponseDto: {
             /**
              * @description Owning community UUID.
@@ -3201,23 +3588,72 @@ interface components {
              */
             updated_at: string;
         };
-        HashtagAutocompleteResponseDto: {
-            data: components["schemas"]["HashtagResponseDto"][];
+        FollowerEdgeListResponseDto: {
+            data: components["schemas"]["FollowerEdgeResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
         };
-        HashtagDetailResponseDto: {
+        FollowerEdgeResponseDto: {
             /**
              * @description Owning community UUID.
              * @example cccccccc-cccc-cccc-cccc-cccccccccccc
              */
             community_id: string;
             /**
-             * @description ISO timestamp the tag first appeared in this community.
+             * @description ISO timestamp the edge was created.
              * @example 2026-05-01T12:00:00.000Z
              */
-            first_used_at: string;
+            created_at: string;
             /**
-             * @description Number of currently-published posts using the tag.
-             * @example 17
+             * @description Destination actor UUID (for actor edges).
+             * @example aaaaaaaa-0000-0000-0000-000000000002
+             */
+            dst_actor_id: string | null;
+            /**
+             * @description Destination post UUID (for reaction / save edges).
+             * @example null
+             */
+            dst_post_id: string | null;
+            /**
+             * @description Edge UUID.
+             * @example eeeeeeee-0000-0000-0000-000000000001
+             */
+            id: string;
+            /**
+             * @description Edge kind. The actor-edge routes emit exactly these four; post reactions and bookmarks have their own response shapes.
+             * @example follow
+             * @enum {string}
+             */
+            kind: "follow" | "mute" | "block" | "restrict";
+            /**
+             * @description Free-form payload stored on the edge (e.g. mute reason).
+             * @example {}
+             */
+            payload: Record<string, never>;
+            /** @description The follower's full actor row. Present only when requested via `?expand=src_actor`. */
+            src_actor?: components["schemas"]["ActorResponseDto"];
+            /**
+             * @description Source actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            src_actor_id: string;
+        };
+        HashtagAutocompleteResponseDto: {
+            data: components["schemas"]["HashtagResponseDto"][];
+        };
+        HashtagDetailResponseDto: {
+            /**
+             * @description Owning community UUID.
+             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             */
+            community_id: string;
+            /**
+             * @description ISO timestamp the tag first appeared in this community.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            first_used_at: string;
+            /**
+             * @description Number of currently-published posts using the tag.
+             * @example 17
              */
             post_count: number;
             /**
@@ -3595,6 +4031,55 @@ interface components {
              */
             target_kind: "actor" | "post" | "comment" | "direct_message";
         };
+        OutboundEdgeListResponseDto: {
+            data: components["schemas"]["OutboundEdgeResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        OutboundEdgeResponseDto: {
+            /**
+             * @description Owning community UUID.
+             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             */
+            community_id: string;
+            /**
+             * @description ISO timestamp the edge was created.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /** @description The destination actor's full row. Present only when requested via `?expand=dst_actor`. */
+            dst_actor?: components["schemas"]["ActorResponseDto"];
+            /**
+             * @description Destination actor UUID (for actor edges).
+             * @example aaaaaaaa-0000-0000-0000-000000000002
+             */
+            dst_actor_id: string | null;
+            /**
+             * @description Destination post UUID (for reaction / save edges).
+             * @example null
+             */
+            dst_post_id: string | null;
+            /**
+             * @description Edge UUID.
+             * @example eeeeeeee-0000-0000-0000-000000000001
+             */
+            id: string;
+            /**
+             * @description Edge kind. The actor-edge routes emit exactly these four; post reactions and bookmarks have their own response shapes.
+             * @example follow
+             * @enum {string}
+             */
+            kind: "follow" | "mute" | "block" | "restrict";
+            /**
+             * @description Free-form payload stored on the edge (e.g. mute reason).
+             * @example {}
+             */
+            payload: Record<string, never>;
+            /**
+             * @description Source actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            src_actor_id: string;
+        };
         PaginationResponseDto: {
             /**
              * @description `true` when at least one more page exists. Mirrors `next_cursor !== null`; published as a separate field so SDKs can drive a `while` loop without parsing the cursor.
@@ -3668,6 +4153,37 @@ interface components {
             data: components["schemas"]["PostResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
+        PostReactionEntryDto: {
+            /**
+             * @description Reactor actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            actor_id: string;
+            /**
+             * @description Owning community UUID.
+             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             */
+            community_id: string;
+            /**
+             * @description ISO timestamp.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description Post UUID.
+             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
+             */
+            post_id: string;
+            /**
+             * @description Reaction type label.
+             * @example like
+             */
+            type: string;
+        };
+        PostReactionListResponseDto: {
+            data: components["schemas"]["PostReactionEntryDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
         PostResponseDto: {
             /**
              * @description Author actor UUID.
@@ -3838,6 +4354,50 @@ interface components {
             /** @description Up to `limit` (default 20, max 50) hits. Not paginated in v1. */
             data: components["schemas"]["PostSearchHitDto"][];
         };
+        PostStateRequestDto: {
+            /**
+             * @description UUIDs of the posts to hydrate viewer state for. Capped at 200 (matches the batch-views precedent); ids that are unknown, removed, or from another community resolve to the empty state instead of failing the batch.
+             * @example [
+             *       "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
+             *       "cccccccc-cccc-cccc-cccc-cccccccccccc"
+             *     ]
+             */
+            post_ids: string[];
+        };
+        PostStateResponseDto: {
+            /** @description One entry per requested post id (de-duplicated, request order). Unknown / cross-community ids resolve to the empty state. */
+            data: components["schemas"]["PostViewerStateEntryDto"][];
+        };
+        PostViewerStateEntryDto: {
+            /**
+             * @description The viewer has bookmarked the post.
+             * @example true
+             */
+            bookmarked: boolean;
+            /**
+             * @description Post UUID this entry describes.
+             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
+             */
+            post_id: string;
+            /**
+             * @description Reaction types the viewer currently has on the post, sorted ascending. Empty when the viewer has not reacted.
+             * @example [
+             *       "fire",
+             *       "like"
+             *     ]
+             */
+            reacted_types: string[];
+            /**
+             * @description The viewer has a currently-published repost of the post.
+             * @example false
+             */
+            reposted: boolean;
+            /**
+             * @description Poll option index the viewer voted for; `null` when the viewer has not voted (or the post has no poll).
+             * @example null
+             */
+            voted_option: number | null;
+        };
         ReactionCountsResponseDto: {
             /**
              * @description Denormalised reaction counts after the write.
@@ -3922,6 +4482,52 @@ interface components {
              */
             post_ids: string[];
         };
+        RelationshipEntryDto: {
+            /**
+             * @description This actor has blocked the source actor — surface it BEFORE attempting a follow/react write instead of handling the 409.
+             * @example false
+             */
+            blocked_by: boolean;
+            /**
+             * @description The source actor has blocked this actor.
+             * @example false
+             */
+            blocking: boolean;
+            /**
+             * @description This actor is on the source actor's close-friend list.
+             * @example false
+             */
+            close_friend: boolean;
+            /**
+             * @description Destination actor UUID this entry describes.
+             * @example aaaaaaaa-0000-0000-0000-000000000002
+             */
+            dst_actor_id: string;
+            /**
+             * @description This actor follows the source actor.
+             * @example false
+             */
+            followed_by: boolean;
+            /**
+             * @description The source actor follows this actor.
+             * @example true
+             */
+            following: boolean;
+            /**
+             * @description The source actor has muted this actor.
+             * @example false
+             */
+            muting: boolean;
+            /**
+             * @description The source actor has restricted this actor.
+             * @example false
+             */
+            restricting: boolean;
+        };
+        RelationshipListResponseDto: {
+            /** @description One entry per requested id (de-duplicated, request order). Unknown ids resolve to all-false flags. */
+            data: components["schemas"]["RelationshipEntryDto"][];
+        };
         RemoveListMemberDto: {
             /**
              * @description Caller — social actor UUID. Must equal the list owner.
@@ -4110,7 +4716,8 @@ interface components {
         UpdateCommunityDto: {
             description?: string | null;
             display_name?: string;
-            settings?: Record<string, never>;
+            /** @description Replaces the settings blob. Supported keys are typed on CommunitySettingsDto; unrecognized keys are stored verbatim but not consumed. */
+            settings?: components["schemas"]["CommunitySettingsDto"];
             /** @enum {string} */
             status?: "active" | "suspended" | "archived";
         };
@@ -4189,8 +4796,13 @@ interface components {
             visibility?: "public" | "followers" | "close_friends" | "private";
         };
         UpdateWebhookDto: {
-            /** @description New subscription set. */
-            event_types?: string[];
+            /**
+             * @description Set `false` to re-enable a disabled webhook (clears the auto-disable state and resets the failure streak — no secret rotation required). Set `true` to disable it manually.
+             * @example false
+             */
+            disabled?: boolean;
+            /** @description New subscription set. Unknown values are rejected with a 400 naming the valid set. */
+            event_types?: ("post.created" | "post.updated" | "post.deleted" | "post.reaction.created" | "repost.created" | "comment.created" | "comment.updated" | "comment.deleted" | "comment.reaction.created" | "edge.follow.created" | "edge.follow.deleted" | "flag.created" | "flag.updated" | "moderation.action.applied" | "actor.updated" | "dm.message.created")[];
             /** @description New subscriber URL. */
             url?: string;
         };
@@ -4226,6 +4838,21 @@ interface components {
              */
             created: boolean;
         };
+        WebhookEventTypesResponseDto: {
+            /**
+             * @description Every event type a webhook can subscribe to, in catalog order.
+             * @example [
+             *       "post.created",
+             *       "post.deleted",
+             *       "comment.created"
+             *     ]
+             */
+            data: ("post.created" | "post.updated" | "post.deleted" | "post.reaction.created" | "repost.created" | "comment.created" | "comment.updated" | "comment.deleted" | "comment.reaction.created" | "edge.follow.created" | "edge.follow.deleted" | "flag.created" | "flag.updated" | "moderation.action.applied" | "actor.updated" | "dm.message.created")[];
+        };
+        WebhookListResponseDto: {
+            /** @description Every webhook on the community — disabled rows included, so auto-disabled subscribers stay discoverable. */
+            data: components["schemas"]["WebhookResponseDto"][];
+        };
         WebhookResponseDto: {
             /**
              * @description Owning community UUID.
@@ -4253,13 +4880,13 @@ interface components {
              */
             disabled_reason: string | null;
             /**
-             * @description Subscribed event types. Each item is one of the social event names (e.g. `post.created`, `comment.created`, `edge.follow.created`).
+             * @description Subscribed event types. Each item is one of the social event names — see GET /v1/webhook-event-types for the live catalog.
              * @example [
              *       "post.created",
              *       "comment.created"
              *     ]
              */
-            event_types: string[];
+            event_types: ("post.created" | "post.updated" | "post.deleted" | "post.reaction.created" | "repost.created" | "comment.created" | "comment.updated" | "comment.deleted" | "comment.reaction.created" | "edge.follow.created" | "edge.follow.deleted" | "flag.created" | "flag.updated" | "moderation.action.applied" | "actor.updated" | "dm.message.created")[];
             /**
              * @description Webhook UUID.
              * @example wwwwwwww-0000-0000-0000-000000000001
@@ -4302,10 +4929,12 @@ interface operations {
     ActorController_list: {
         parameters: {
             query?: {
-                /** @description Page size; capped at 200. */
+                /** @description Page size; capped at 200. Ignored when `ids` is passed. */
                 limit?: number;
-                /** @description Opaque cursor from the previous page's `pagination.next_cursor`. */
+                /** @description Opaque cursor from the previous page's `pagination.next_cursor`. Ignored when `ids` is passed. */
                 cursor?: string;
+                /** @description Comma-separated actor UUIDs (max 100, de-duplicated) to batch-fetch. Returns matching actors in request order; unknown ids are silently omitted. */
+                ids?: string;
             };
             header?: never;
             path: {
@@ -4316,7 +4945,7 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Page of actors with `next_cursor` + `has_more`. */
+            /** @description Page of actors with `next_cursor` + `has_more` (batch-fetch responses always report `has_more: false`). */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -4325,7 +4954,7 @@ interface operations {
                     "application/json": components["schemas"]["ActorPageResponseDto"];
                 };
             };
-            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or invalid `ids` (`INVALID_ID_LIST` — empty / non-UUID entry; `TOO_MANY_IDS` — over 100). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -4408,6 +5037,114 @@ interface operations {
             };
         };
     };
+    ActorController_batchUpsert: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BatchUpsertActorsDto"];
+            };
+        };
+        responses: {
+            /** @description Per-item results, request order. `succeeded` + `failed` summarise the batch. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BatchActorsResponseDto"];
+                };
+            };
+            /** @description Envelope validation failure: `actors` missing, empty, over 200 items, or an item shape invalid. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.create` for this community. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community not found in the PAK's workspace. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    ActorController_batchGetByExternal: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BatchExternalIdsDto"];
+            };
+        };
+        responses: {
+            /** @description Actors found (request order, de-duplicated) plus the `missing[]` external_ids. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ActorsByExternalBatchResponseDto"];
+                };
+            };
+            /** @description `external_ids` missing, empty, over 200 items, or an entry exceeding 256 chars. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.read`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community not found in the PAK's workspace. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     ActorController_getByExternal: {
         parameters: {
             query?: never;
@@ -4587,6 +5324,8 @@ interface operations {
             query?: {
                 limit?: number;
                 cursor?: string;
+                /** @description Stripe-style expansion. Pass the response field to expand (supported here: `dst_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`. */
+                expand?: "dst_actor";
             };
             header?: never;
             path: {
@@ -4605,10 +5344,10 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EdgeListResponseDto"];
+                    "application/json": components["schemas"]["OutboundEdgeListResponseDto"];
                 };
             };
-            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or unsupported `expand` value (`INVALID_EXPAND`). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -4891,6 +5630,8 @@ interface operations {
             query?: {
                 limit?: number;
                 cursor?: string;
+                /** @description Stripe-style expansion. Pass the response field to expand (supported here: `src_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`. */
+                expand?: "src_actor";
             };
             header?: never;
             path: {
@@ -4909,10 +5650,10 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EdgeListResponseDto"];
+                    "application/json": components["schemas"]["FollowerEdgeListResponseDto"];
                 };
             };
-            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or unsupported `expand` value (`INVALID_EXPAND`). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -4946,6 +5687,8 @@ interface operations {
             query?: {
                 limit?: number;
                 cursor?: string;
+                /** @description Stripe-style expansion. Pass the response field to expand (supported here: `dst_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`. */
+                expand?: "dst_actor";
             };
             header?: never;
             path: {
@@ -4964,10 +5707,10 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EdgeListResponseDto"];
+                    "application/json": components["schemas"]["OutboundEdgeListResponseDto"];
                 };
             };
-            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or unsupported `expand` value (`INVALID_EXPAND`). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -5394,6 +6137,8 @@ interface operations {
             query?: {
                 limit?: number;
                 cursor?: string;
+                /** @description Stripe-style expansion. Pass the response field to expand (supported here: `dst_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`. */
+                expand?: "dst_actor";
             };
             header?: never;
             path: {
@@ -5412,10 +6157,10 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EdgeListResponseDto"];
+                    "application/json": components["schemas"]["OutboundEdgeListResponseDto"];
                 };
             };
-            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or unsupported `expand` value (`INVALID_EXPAND`). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -5752,11 +6497,69 @@ interface operations {
             };
         };
     };
+    ViewerStateController_postState: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description Viewer actor UUID — the perspective all state is computed from. */
+                actorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PostStateRequestDto"];
+            };
+        };
+        responses: {
+            /** @description One state entry per requested post id. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PostStateResponseDto"];
+                };
+            };
+            /** @description Empty `post_ids`, more than 200 ids, or a non-UUID in the list. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community or actor not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     EdgeController_listRestricts: {
         parameters: {
             query?: {
                 limit?: number;
                 cursor?: string;
+                /** @description Stripe-style expansion. Pass the response field to expand (supported here: `dst_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`. */
+                expand?: "dst_actor";
             };
             header?: never;
             path: {
@@ -5775,10 +6578,10 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EdgeListResponseDto"];
+                    "application/json": components["schemas"]["OutboundEdgeListResponseDto"];
                 };
             };
-            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or unsupported `expand` value (`INVALID_EXPAND`). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -5942,6 +6745,61 @@ interface operations {
             };
         };
     };
+    EdgeController_relationships: {
+        parameters: {
+            query: {
+                /** @description Comma-separated destination actor UUIDs (1-100). */
+                with: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description Source actor UUID — the perspective all flags are computed from. */
+                srcActorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description One relationship entry per requested id. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RelationshipListResponseDto"];
+                };
+            };
+            /** @description Missing `with`, more than 100 ids, or a non-UUID value in the list. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community or source actor not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     EdgeController_block: {
         parameters: {
             query?: never;
@@ -6212,7 +7070,10 @@ interface operations {
     ConversationController_create: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Mostly useful for `kind="group"` (direct conversations are get-or-create by participant pair anyway). Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
                 communityId: string;
@@ -6234,7 +7095,7 @@ interface operations {
                     "application/json": components["schemas"]["ConversationResponseDto"];
                 };
             };
-            /** @description Validation failure (missing recipient for direct, missing actor_ids for group, two equal actor ids). */
+            /** @description Validation failure (missing recipient for direct, missing actor_ids for group, two equal actor ids, malformed Idempotency-Key). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -6261,7 +7122,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description A block exists, or the group exceeds `community.settings.max_group_conversation_size`. */
+            /** @description A block exists, the group exceeds `community.settings.max_group_conversation_size`, or `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -6695,7 +7556,10 @@ interface operations {
     ConversationController_send: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
                 communityId: string;
@@ -6719,7 +7583,7 @@ interface operations {
                     "application/json": components["schemas"]["DirectMessageResponseDto"];
                 };
             };
-            /** @description Validation failure (empty body for text, body too long). */
+            /** @description Validation failure (empty body for text, body too long, malformed Idempotency-Key). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -6746,7 +7610,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description A block exists between the sender and another participant. */
+            /** @description A block exists between the sender and another participant, or `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -7120,14 +7984,67 @@ interface operations {
             };
         };
         responses: {
-            /** @description Read marker updated. */
-            204: {
+            /** @description Read marker updated. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation failure (read_through not ISO). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.update`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Conversation not found or caller not a participant. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    CounterController_getBatchCounters: {
+        parameters: {
+            query: {
+                /** @description Comma-separated actor UUIDs (max 100, de-duplicated). */
+                actor_ids: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Counters for each actor found plus the `missing[]` ids. */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["BatchCountersResponseDto"];
+                };
             };
-            /** @description Validation failure (read_through not ISO). */
+            /** @description `actor_ids` missing or empty, a non-UUID entry (`INVALID_ID_LIST`), or over 100 ids (`TOO_MANY_IDS`). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -7136,7 +8053,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.update`. */
+            /** @description PAK lacks `social.read`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -7145,7 +8062,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Conversation not found or caller not a participant. */
+            /** @description Community not found in the PAK's workspace. (Unknown actors land in `missing[]`, not a 404.) */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -7346,6 +8263,60 @@ interface operations {
             };
         };
     };
+    EdgeController_batchFollows: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BatchFollowsDto"];
+            };
+        };
+        responses: {
+            /** @description Per-item results, request order. `succeeded` + `failed` summarise the batch. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BatchFollowsResponseDto"];
+                };
+            };
+            /** @description Envelope validation failure: `follows` missing, empty, over 200 items, or an item shape invalid. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.create`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community not found in the PAK's workspace. (Unknown actors fail per item, not the whole call.) */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     EdgeController_unfollow: {
         parameters: {
             query?: never;
@@ -7582,7 +8553,10 @@ interface operations {
     ActorListController_create: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 /** @description Social community UUID. */
                 communityId: string;
@@ -7604,7 +8578,7 @@ interface operations {
                     "application/json": components["schemas"]["ActorListResponseDto"];
                 };
             };
-            /** @description Validation failure. */
+            /** @description Validation failure (including malformed Idempotency-Key). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -7631,6 +8605,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description `IDEMPOTENCY_KEY_REUSE` — the supplied Idempotency-Key was already used with a different request body. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     ActorListController_getById: {
@@ -8153,7 +9136,10 @@ interface operations {
     PostController_create: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 communityId: string;
             };
@@ -8174,7 +9160,7 @@ interface operations {
                     "application/json": components["schemas"]["PostResponseDto"];
                 };
             };
-            /** @description Validation failure (missing actor_id; body/title/url all empty; bad URL; bad ISO timestamp). */
+            /** @description Validation failure (missing actor_id; body/title/url all empty; bad URL; bad ISO timestamp; malformed Idempotency-Key). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -8201,6 +9187,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description `IDEMPOTENCY_KEY_REUSE` — the supplied Idempotency-Key was already used with a different request body. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description Quote rules: `CANNOT_QUOTE_SELF` (kind='quote' with your own post as source) or `CANNOT_QUOTE_PRIVATE` (source post is private). */
             422: {
                 headers: {
@@ -8566,7 +9561,10 @@ interface operations {
     CommentController_create: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
                 communityId: string;
@@ -8590,7 +9588,7 @@ interface operations {
                     "application/json": components["schemas"]["CommentResponseDto"];
                 };
             };
-            /** @description Validation failure (missing actor_id, empty body, body too long). */
+            /** @description Validation failure (missing actor_id, empty body, body too long, malformed Idempotency-Key). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -8617,7 +9615,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Block exists between commenter and post author, or depth exceeds community.settings.max_comment_depth. */
+            /** @description Block exists between commenter and post author, depth exceeds community.settings.max_comment_depth, or `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -9113,6 +10111,63 @@ interface operations {
             };
         };
     };
+    PostReactionController_list: {
+        parameters: {
+            query?: {
+                /** @description Filter to a single reaction type label. */
+                type?: string;
+                limit?: number;
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. */
+                communityId: string;
+                /** @description Social post UUID. */
+                postId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of reactions. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PostReactionListResponseDto"];
+                };
+            };
+            /** @description Overlong `type` filter (max 64 chars). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community or post not found (or post removed). */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     PostReactionController_react: {
         parameters: {
             query?: never;
@@ -9909,7 +10964,7 @@ interface operations {
             };
         };
     };
-    WebhookController_getActive: {
+    WebhookController_list: {
         parameters: {
             query?: never;
             header?: never;
@@ -9921,13 +10976,13 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description The active webhook, or a literal JSON `null` body when the community has no active webhook registered. */
+            /** @description All webhooks on the community (no pagination — capped at 10 rows). */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["WebhookResponseDto"] | null;
+                    "application/json": components["schemas"]["WebhookListResponseDto"];
                 };
             };
             /** @description Community not found. */
@@ -9944,7 +10999,10 @@ interface operations {
     WebhookController_create: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. The signing secret is returned exactly once; a replay returns the original response (including the secret) with `Idempotent-Replay: true`. Same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 /** @description Social community UUID. */
                 communityId: string;
@@ -9966,7 +11024,7 @@ interface operations {
                     "application/json": components["schemas"]["CreatedWebhookResponseDto"];
                 };
             };
-            /** @description Validation failure (bad url, empty event_types). */
+            /** @description Validation failure (bad url, empty or unknown event_types — the message names the valid set; malformed Idempotency-Key). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -9993,7 +11051,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community already has an active webhook. */
+            /** @description Webhook cap reached (10 per community), or `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -10154,10 +11212,58 @@ interface operations {
             };
         };
     };
-    WebhookController_rotateSecret: {
+    WebhookController_redeliver: {
         parameters: {
             query?: never;
             header?: never;
+            path: {
+                /** @description Social community UUID. */
+                communityId: string;
+                /** @description Webhook UUID. */
+                webhookId: string;
+                /** @description Delivery row UUID (from GET …/deliveries). */
+                deliveryId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Redelivery enqueued. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DeliveryJobResponseDto"];
+                };
+            };
+            /** @description Webhook or delivery not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Webhook is disabled — re-enable it first. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    WebhookController_rotateSecret: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. A replay returns the original response (including the new secret) with `Idempotent-Replay: true`; a retry WITHOUT the header rotates the secret again, invalidating the previous one. Same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 /** @description Social community UUID. */
                 communityId: string;
@@ -10177,6 +11283,58 @@ interface operations {
                     "application/json": components["schemas"]["CreatedWebhookResponseDto"];
                 };
             };
+            /** @description Malformed Idempotency-Key header. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Webhook not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description `IDEMPOTENCY_KEY_REUSE` — the supplied Idempotency-Key was already used with a different request body. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    WebhookController_testPing: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. */
+                communityId: string;
+                /** @description Webhook UUID. */
+                webhookId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Ping enqueued. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DeliveryJobResponseDto"];
+                };
+            };
             /** @description Webhook not found. */
             404: {
                 headers: {
@@ -10186,6 +11344,35 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description Webhook is disabled — re-enable it first. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    WebhookEventTypesController_list: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The full event-type catalog. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookEventTypesResponseDto"];
+                };
+            };
         };
     };
     CommunityController_list: {
@@ -10225,6 +11412,8 @@ interface operations {
             query?: never;
             header: {
                 authorization: string;
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
             };
             path: {
                 /** @description ProductCraft workspace UUID owning the community. */
@@ -10247,7 +11436,7 @@ interface operations {
                     "application/json": components["schemas"]["CommunityResponseDto"];
                 };
             };
-            /** @description Validation failure (slug shape, display_name length). */
+            /** @description Validation failure (slug shape, display_name length, malformed Idempotency-Key). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -10283,7 +11472,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community slug already taken in this workspace, or the supplied `app_id` is already connected to a community. */
+            /** @description Community slug already taken in this workspace, the supplied `app_id` is already connected to a community, or `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -10480,7 +11669,10 @@ interface operations {
     ModerationAdminController_shadowBan: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 workspaceId: string;
                 communityId: string;
@@ -10503,7 +11695,7 @@ interface operations {
                     "application/json": components["schemas"]["ModerationActorResponseDto"];
                 };
             };
-            /** @description Invalid duration_hours or reason. */
+            /** @description Invalid duration_hours or reason, or malformed Idempotency-Key. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -10530,6 +11722,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description `IDEMPOTENCY_KEY_REUSE` — the supplied Idempotency-Key was already used with a different request body. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     ModerationAdminController_unshadow: {
@@ -10765,7 +11966,10 @@ interface operations {
     ModerationAdminController_act: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 workspaceId: string;
                 communityId: string;
@@ -10788,7 +11992,7 @@ interface operations {
                     "application/json": components["schemas"]["ActOnFlagResponseDto"];
                 };
             };
-            /** @description Invalid action or notes. */
+            /** @description Invalid action or notes, or malformed Idempotency-Key. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -10815,7 +12019,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description FLAG_ALREADY_CLOSED — the flag is already actioned/dismissed and the requested action is punitive (hide/remove/warn/ban). Reversals (unhide/restore/dismiss) stay legal on a closed flag. */
+            /** @description FLAG_ALREADY_CLOSED — the flag is already actioned/dismissed and the requested action is punitive (hide/remove/warn/ban); reversals (unhide/restore/dismiss) stay legal on a closed flag. Also `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). */
             409: {
                 headers: {
                     [name: string]: unknown;