@meshery/schemas 1.3.60 → 1.3.62

package/dist/constructs/v1beta3/blowhorn_ledger/BlowhornLedger.d.ts

@@ -0,0 +1,1546 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+export interface paths {
+    "/api/blowhorn/ledger": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Blowhorn ledger entries
+         * @description Returns a paginated list of Blowhorn ledger entries in the organization of the authenticated session, optionally filtered by ledger.
+         */
+        get: operations["listBlowhornLedger"];
+        put?: never;
+        /**
+         * Record Blowhorn ledger entry
+         * @description Records a ledger entry, replaying idempotently on the (ledger,
+         *     key) pair: recording an existing pair returns the stored entry
+         *     with the supplied value merged. Ownership is derived from the
+         *     authenticated session; any client-supplied owner is ignored.
+         */
+        post: operations["recordBlowhornLedgerEntry"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/blowhorn/ledger/{blowhornLedgerEntryId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get Blowhorn ledger entry by ID */
+        get: operations["getBlowhornLedgerEntry"];
+        put?: never;
+        post?: never;
+        /**
+         * Delete Blowhorn ledger entry
+         * @description Removes the ledger entry from its idempotent set.
+         */
+        delete: operations["deleteBlowhornLedgerEntry"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/blowhorn/ledger/{blowhornLedgerEntryId}/claim": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Claim Blowhorn ledger entry if absent
+         * @description Takes the entry for the holder named by `holder` when unclaimed.
+         *     An already-claimed entry is refused with a 409 - exactly-once
+         *     semantics for claim-if-absent sets.
+         */
+        post: operations["claimIfAbsentBlowhornLedgerEntry"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/blowhorn/contacts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Blowhorn contacts
+         * @description Returns a paginated list of Blowhorn contacts in the organization of the authenticated session, optionally filtered by platform.
+         */
+        get: operations["listBlowhornContacts"];
+        put?: never;
+        /**
+         * Upsert Blowhorn contact
+         * @description Creates a new Blowhorn contact when no `id` is supplied, or
+         *     updates the entry matching the provided `id`. Contacts are keyed
+         *     by the (platform, handle) pair within the organization. Ownership
+         *     is derived from the authenticated session; any client-supplied
+         *     owner is ignored.
+         */
+        post: operations["upsertBlowhornContact"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/blowhorn/mentees": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Blowhorn mentees
+         * @description Returns a paginated list of Blowhorn mentees in the organization of the authenticated session.
+         */
+        get: operations["listBlowhornMentees"];
+        put?: never;
+        /**
+         * Upsert Blowhorn mentee
+         * @description Creates a new Blowhorn mentee when no `id` is supplied, or
+         *     updates the entry matching the provided `id`. Ownership is
+         *     derived from the authenticated session; any client-supplied
+         *     owner is ignored.
+         */
+        post: operations["upsertBlowhornMentee"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/blowhorn/mentees/{blowhornMenteeId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete Blowhorn mentee
+         * @description Removes the Blowhorn mentee.
+         */
+        delete: operations["deleteBlowhornMentee"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/blowhorn/mentees/{blowhornMenteeId}/drop": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Record and drop Blowhorn mentee
+         * @description Records the mentee and drops it in a single operation, stamping
+         *     the drop time on the returned entry.
+         */
+        post: operations["recordAndDropBlowhornMentee"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /**
+         * Blowhorn Ledger Entry Schema
+         * @description Server-returned Blowhorn ledger entry as persisted by meshery-cloud.
+         *     Ledger entries form ledger-discriminated idempotent sets keyed by
+         *     (ledger, key): recording the same pair replays idempotently, and
+         *     claim-if-absent takes the entry for a holder exactly once.
+         */
+        BlowhornLedgerEntry: {
+            /**
+             * Format: uuid
+             * @description Server-generated Blowhorn ledger entry ID.
+             */
+            id: string;
+            /**
+             * Format: uuid
+             * @description Owning organization ID. Derived from the authenticated session, never client-settable.
+             */
+            organizationId: string;
+            /** @description Ledger discriminator naming the idempotent set. */
+            ledger: string;
+            /** @description Key within the ledger. Unique per ledger. */
+            entryKey: string;
+            /** @description Entry value, stored as a JSON blob. */
+            value?: Record<string, never>;
+            /** @description Holder that claimed the entry, if any. Set only by claim-if-absent. */
+            claimedBy?: string;
+            /**
+             * Format: date-time
+             * @description Time the entry was claimed, if any. Set only by claim-if-absent.
+             */
+            claimedAt?: string | null;
+            /**
+             * Format: date-time
+             * @description Timestamp of Blowhorn ledger entry creation.
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description Timestamp of last Blowhorn ledger entry modification.
+             */
+            updatedAt: string;
+        };
+        /**
+         * Blowhorn Contact Schema
+         * @description Server-returned Blowhorn contact as persisted by meshery-cloud. Contacts
+         *     are upserted per platform handle and back the credential-less platform
+         *     opt-in rows.
+         */
+        BlowhornContact: {
+            /**
+             * Format: uuid
+             * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+             */
+            id: string;
+            /**
+             * Format: uuid
+             * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+             */
+            organizationId: string;
+            /** @description Platform the contact belongs to (e.g. linkedin, github). */
+            platform: string;
+            /** @description Platform-side handle identifying the contact. Unique per platform within the organization. */
+            handle: string;
+            /** @description Human-readable contact name. */
+            displayName?: string;
+            /** @description Platform-side profile URL for the contact. */
+            profileUrl?: string;
+            /** @description Contact metadata, stored as a JSON blob. */
+            metadata?: Record<string, never>;
+            /**
+             * Format: date-time
+             * @description Timestamp of Blowhorn contact creation.
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description Timestamp of last Blowhorn contact modification.
+             */
+            updatedAt: string;
+        };
+        /**
+         * Blowhorn Mentee Schema
+         * @description Server-returned Blowhorn mentee as persisted by meshery-cloud. Mentees
+         *     track mentored subjects through stages; recording a mentee and dropping
+         *     it is a single operation that stamps the drop time.
+         */
+        BlowhornMentee: {
+            /**
+             * Format: uuid
+             * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+             */
+            id: string;
+            /**
+             * Format: uuid
+             * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+             */
+            organizationId: string;
+            /** @description Mentored subject. */
+            subject: string;
+            /** @description Mentorship stage of the subject. */
+            stage?: string;
+            /** @description Mentee metadata, stored as a JSON blob. */
+            metadata?: Record<string, never>;
+            /**
+             * Format: date-time
+             * @description Time the mentee was recorded and dropped, if any. Set only by the record-and-drop operation.
+             */
+            droppedAt?: string | null;
+            /**
+             * Format: date-time
+             * @description Timestamp of Blowhorn mentee creation.
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description Timestamp of last Blowhorn mentee modification.
+             */
+            updatedAt: string;
+        };
+        /**
+         * @description Payload for recording a Blowhorn ledger entry. Contains only
+         *     client-settable fields; the owning `organizationId` (derived from
+         *     the authenticated session), the claim columns and the
+         *     server-generated `createdAt` / `updatedAt` timestamps are
+         *     intentionally excluded.
+         */
+        BlowhornLedgerPayload: {
+            /**
+             * Format: uuid
+             * @description Existing Blowhorn ledger entry ID for updates; omit on record.
+             */
+            id?: string;
+            /** @description Ledger discriminator naming the idempotent set. */
+            ledger: string;
+            /** @description Key within the ledger. Unique per ledger. */
+            entryKey: string;
+            /** @description Entry value, stored as a JSON blob. */
+            value?: Record<string, never>;
+        };
+        /** @description Claim-if-absent payload taking an unclaimed entry for a holder. */
+        BlowhornLedgerClaimRequest: {
+            /** @description Holder taking the entry. Refused with a 409 when the entry is already claimed. */
+            holder: string;
+        };
+        /**
+         * @description Payload for creating or updating a Blowhorn contact. Contains
+         *     only client-settable fields; the owning `organizationId` (derived
+         *     from the authenticated session) and the server-generated
+         *     `createdAt` / `updatedAt` timestamps are intentionally excluded.
+         */
+        BlowhornContactPayload: {
+            /**
+             * Format: uuid
+             * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+             */
+            id?: string;
+            /** @description Platform the contact belongs to (e.g. linkedin, github). */
+            platform: string;
+            /** @description Platform-side handle identifying the contact. Unique per platform within the organization. */
+            handle: string;
+            /** @description Human-readable contact name. */
+            displayName?: string;
+            /** @description Platform-side profile URL for the contact. */
+            profileUrl?: string;
+            /** @description Contact metadata, stored as a JSON blob. */
+            metadata?: Record<string, never>;
+        };
+        /**
+         * @description Payload for creating or updating a Blowhorn mentee. Contains only
+         *     client-settable fields; the owning `organizationId` (derived from
+         *     the authenticated session), the server-managed `droppedAt` and
+         *     the server-generated `createdAt` / `updatedAt` timestamps are
+         *     intentionally excluded.
+         */
+        BlowhornMenteePayload: {
+            /**
+             * Format: uuid
+             * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+             */
+            id?: string;
+            /** @description Mentored subject. */
+            subject: string;
+            /** @description Mentorship stage of the subject. */
+            stage?: string;
+            /** @description Mentee metadata, stored as a JSON blob. */
+            metadata?: Record<string, never>;
+        };
+        /** @description Record-and-drop payload. */
+        BlowhornMenteeDropRequest: {
+            /** @description Final mentorship stage recorded with the drop. */
+            stage?: string;
+        };
+        /** @description Paginated collection of Blowhorn ledger entries. */
+        BlowhornLedgerPage: {
+            /** @description Current page number of the result set. */
+            page?: number;
+            /** @description Number of items per page. */
+            pageSize?: number;
+            /** @description Total number of items available. */
+            totalCount?: number;
+            /** @description Blowhorn ledger entries included on this page of results. */
+            blowhornLedgerEntries?: {
+                /**
+                 * Format: uuid
+                 * @description Server-generated Blowhorn ledger entry ID.
+                 */
+                id: string;
+                /**
+                 * Format: uuid
+                 * @description Owning organization ID. Derived from the authenticated session, never client-settable.
+                 */
+                organizationId: string;
+                /** @description Ledger discriminator naming the idempotent set. */
+                ledger: string;
+                /** @description Key within the ledger. Unique per ledger. */
+                entryKey: string;
+                /** @description Entry value, stored as a JSON blob. */
+                value?: Record<string, never>;
+                /** @description Holder that claimed the entry, if any. Set only by claim-if-absent. */
+                claimedBy?: string;
+                /**
+                 * Format: date-time
+                 * @description Time the entry was claimed, if any. Set only by claim-if-absent.
+                 */
+                claimedAt?: string | null;
+                /**
+                 * Format: date-time
+                 * @description Timestamp of Blowhorn ledger entry creation.
+                 */
+                createdAt: string;
+                /**
+                 * Format: date-time
+                 * @description Timestamp of last Blowhorn ledger entry modification.
+                 */
+                updatedAt: string;
+            }[];
+        };
+        /** @description Paginated collection of Blowhorn contacts. */
+        BlowhornContactPage: {
+            /** @description Current page number of the result set. */
+            page?: number;
+            /** @description Number of items per page. */
+            pageSize?: number;
+            /** @description Total number of items available. */
+            totalCount?: number;
+            /** @description Blowhorn contacts included on this page of results. */
+            blowhornContacts?: {
+                /**
+                 * Format: uuid
+                 * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                 */
+                id: string;
+                /**
+                 * Format: uuid
+                 * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                 */
+                organizationId: string;
+                /** @description Platform the contact belongs to (e.g. linkedin, github). */
+                platform: string;
+                /** @description Platform-side handle identifying the contact. Unique per platform within the organization. */
+                handle: string;
+                /** @description Human-readable contact name. */
+                displayName?: string;
+                /** @description Platform-side profile URL for the contact. */
+                profileUrl?: string;
+                /** @description Contact metadata, stored as a JSON blob. */
+                metadata?: Record<string, never>;
+                /**
+                 * Format: date-time
+                 * @description Timestamp of Blowhorn contact creation.
+                 */
+                createdAt: string;
+                /**
+                 * Format: date-time
+                 * @description Timestamp of last Blowhorn contact modification.
+                 */
+                updatedAt: string;
+            }[];
+        };
+        /** @description Paginated collection of Blowhorn mentees. */
+        BlowhornMenteePage: {
+            /** @description Current page number of the result set. */
+            page?: number;
+            /** @description Number of items per page. */
+            pageSize?: number;
+            /** @description Total number of items available. */
+            totalCount?: number;
+            /** @description Blowhorn mentees included on this page of results. */
+            blowhornMentees?: {
+                /**
+                 * Format: uuid
+                 * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                 */
+                id: string;
+                /**
+                 * Format: uuid
+                 * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                 */
+                organizationId: string;
+                /** @description Mentored subject. */
+                subject: string;
+                /** @description Mentorship stage of the subject. */
+                stage?: string;
+                /** @description Mentee metadata, stored as a JSON blob. */
+                metadata?: Record<string, never>;
+                /**
+                 * Format: date-time
+                 * @description Time the mentee was recorded and dropped, if any. Set only by the record-and-drop operation.
+                 */
+                droppedAt?: string | null;
+                /**
+                 * Format: date-time
+                 * @description Timestamp of Blowhorn mentee creation.
+                 */
+                createdAt: string;
+                /**
+                 * Format: date-time
+                 * @description Timestamp of last Blowhorn mentee modification.
+                 */
+                updatedAt: string;
+            }[];
+        };
+    };
+    responses: {
+        /** @description Invalid request body or request param */
+        400: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "text/plain": string;
+            };
+        };
+        /** @description Expired JWT token used or insufficient privilege */
+        401: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "text/plain": string;
+            };
+        };
+        /** @description Result not found */
+        404: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "text/plain": string;
+            };
+        };
+        /** @description Conflict - the ledger entry is already claimed */
+        409: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "text/plain": string;
+            };
+        };
+        /** @description Internal server error */
+        500: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "text/plain": string;
+            };
+        };
+    };
+    parameters: {
+        /** @description Blowhorn ledger entry ID */
+        blowhornLedgerEntryId: string;
+        /** @description Blowhorn mentee ID */
+        blowhornMenteeId: string;
+        /** @description Get responses by page */
+        page: number;
+        /** @description Number of items per page (canonical camelCase form). */
+        pageSize: number;
+        /**
+         * @deprecated
+         * @description Number of items per page. Deprecated alias of pageSize;
+         *     canonical `pageSize` wins when both are present.
+         */
+        pagesize: number;
+        /** @description Get responses that match search param value */
+        search: string;
+        /** @description Get ordered responses */
+        order: string;
+    };
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    listBlowhornLedger: {
+        parameters: {
+            query?: {
+                /** @description Get responses by page */
+                page?: number;
+                /** @description Number of items per page (canonical camelCase form). */
+                pageSize?: number;
+                /**
+                 * @deprecated
+                 * @description Number of items per page. Deprecated alias of pageSize;
+                 *     canonical `pageSize` wins when both are present.
+                 */
+                pagesize?: number;
+                /** @description Get responses that match search param value */
+                search?: string;
+                /** @description Get ordered responses */
+                order?: string;
+                /** @description Filter by ledger discriminator. */
+                ledger?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Blowhorn ledger entries page */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Current page number of the result set. */
+                        page?: number;
+                        /** @description Number of items per page. */
+                        pageSize?: number;
+                        /** @description Total number of items available. */
+                        totalCount?: number;
+                        /** @description Blowhorn ledger entries included on this page of results. */
+                        blowhornLedgerEntries?: {
+                            /**
+                             * Format: uuid
+                             * @description Server-generated Blowhorn ledger entry ID.
+                             */
+                            id: string;
+                            /**
+                             * Format: uuid
+                             * @description Owning organization ID. Derived from the authenticated session, never client-settable.
+                             */
+                            organizationId: string;
+                            /** @description Ledger discriminator naming the idempotent set. */
+                            ledger: string;
+                            /** @description Key within the ledger. Unique per ledger. */
+                            entryKey: string;
+                            /** @description Entry value, stored as a JSON blob. */
+                            value?: Record<string, never>;
+                            /** @description Holder that claimed the entry, if any. Set only by claim-if-absent. */
+                            claimedBy?: string;
+                            /**
+                             * Format: date-time
+                             * @description Time the entry was claimed, if any. Set only by claim-if-absent.
+                             */
+                            claimedAt?: string | null;
+                            /**
+                             * Format: date-time
+                             * @description Timestamp of Blowhorn ledger entry creation.
+                             */
+                            createdAt: string;
+                            /**
+                             * Format: date-time
+                             * @description Timestamp of last Blowhorn ledger entry modification.
+                             */
+                            updatedAt: string;
+                        }[];
+                    };
+                };
+            };
+            /** @description Expired JWT token used or insufficient privilege */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+        };
+    };
+    recordBlowhornLedgerEntry: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * Format: uuid
+                     * @description Existing Blowhorn ledger entry ID for updates; omit on record.
+                     */
+                    id?: string;
+                    /** @description Ledger discriminator naming the idempotent set. */
+                    ledger: string;
+                    /** @description Key within the ledger. Unique per ledger. */
+                    entryKey: string;
+                    /** @description Entry value, stored as a JSON blob. */
+                    value?: Record<string, never>;
+                };
+            };
+        };
+        responses: {
+            /** @description Blowhorn ledger entry recorded */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * Format: uuid
+                         * @description Server-generated Blowhorn ledger entry ID.
+                         */
+                        id: string;
+                        /**
+                         * Format: uuid
+                         * @description Owning organization ID. Derived from the authenticated session, never client-settable.
+                         */
+                        organizationId: string;
+                        /** @description Ledger discriminator naming the idempotent set. */
+                        ledger: string;
+                        /** @description Key within the ledger. Unique per ledger. */
+                        entryKey: string;
+                        /** @description Entry value, stored as a JSON blob. */
+                        value?: Record<string, never>;
+                        /** @description Holder that claimed the entry, if any. Set only by claim-if-absent. */
+                        claimedBy?: string;
+                        /**
+                         * Format: date-time
+                         * @description Time the entry was claimed, if any. Set only by claim-if-absent.
+                         */
+                        claimedAt?: string | null;
+                        /**
+                         * Format: date-time
+                         * @description Timestamp of Blowhorn ledger entry creation.
+                         */
+                        createdAt: string;
+                        /**
+                         * Format: date-time
+                         * @description Timestamp of last Blowhorn ledger entry modification.
+                         */
+                        updatedAt: string;
+                    };
+                };
+            };
+            /** @description Invalid request body or request param */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Expired JWT token used or insufficient privilege */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+        };
+    };
+    getBlowhornLedgerEntry: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Blowhorn ledger entry ID */
+                blowhornLedgerEntryId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Blowhorn ledger entry response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * Format: uuid
+                         * @description Server-generated Blowhorn ledger entry ID.
+                         */
+                        id: string;
+                        /**
+                         * Format: uuid
+                         * @description Owning organization ID. Derived from the authenticated session, never client-settable.
+                         */
+                        organizationId: string;
+                        /** @description Ledger discriminator naming the idempotent set. */
+                        ledger: string;
+                        /** @description Key within the ledger. Unique per ledger. */
+                        entryKey: string;
+                        /** @description Entry value, stored as a JSON blob. */
+                        value?: Record<string, never>;
+                        /** @description Holder that claimed the entry, if any. Set only by claim-if-absent. */
+                        claimedBy?: string;
+                        /**
+                         * Format: date-time
+                         * @description Time the entry was claimed, if any. Set only by claim-if-absent.
+                         */
+                        claimedAt?: string | null;
+                        /**
+                         * Format: date-time
+                         * @description Timestamp of Blowhorn ledger entry creation.
+                         */
+                        createdAt: string;
+                        /**
+                         * Format: date-time
+                         * @description Timestamp of last Blowhorn ledger entry modification.
+                         */
+                        updatedAt: string;
+                    };
+                };
+            };
+            /** @description Invalid request body or request param */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Expired JWT token used or insufficient privilege */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Result not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+        };
+    };
+    deleteBlowhornLedgerEntry: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Blowhorn ledger entry ID */
+                blowhornLedgerEntryId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Blowhorn ledger entry deleted */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Expired JWT token used or insufficient privilege */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Result not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+        };
+    };
+    claimIfAbsentBlowhornLedgerEntry: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Blowhorn ledger entry ID */
+                blowhornLedgerEntryId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Holder taking the entry. Refused with a 409 when the entry is already claimed. */
+                    holder: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Blowhorn ledger entry claimed */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * Format: uuid
+                         * @description Server-generated Blowhorn ledger entry ID.
+                         */
+                        id: string;
+                        /**
+                         * Format: uuid
+                         * @description Owning organization ID. Derived from the authenticated session, never client-settable.
+                         */
+                        organizationId: string;
+                        /** @description Ledger discriminator naming the idempotent set. */
+                        ledger: string;
+                        /** @description Key within the ledger. Unique per ledger. */
+                        entryKey: string;
+                        /** @description Entry value, stored as a JSON blob. */
+                        value?: Record<string, never>;
+                        /** @description Holder that claimed the entry, if any. Set only by claim-if-absent. */
+                        claimedBy?: string;
+                        /**
+                         * Format: date-time
+                         * @description Time the entry was claimed, if any. Set only by claim-if-absent.
+                         */
+                        claimedAt?: string | null;
+                        /**
+                         * Format: date-time
+                         * @description Timestamp of Blowhorn ledger entry creation.
+                         */
+                        createdAt: string;
+                        /**
+                         * Format: date-time
+                         * @description Timestamp of last Blowhorn ledger entry modification.
+                         */
+                        updatedAt: string;
+                    };
+                };
+            };
+            /** @description Invalid request body or request param */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Expired JWT token used or insufficient privilege */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Result not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Conflict - the ledger entry is already claimed */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+        };
+    };
+    listBlowhornContacts: {
+        parameters: {
+            query?: {
+                /** @description Get responses by page */
+                page?: number;
+                /** @description Number of items per page (canonical camelCase form). */
+                pageSize?: number;
+                /**
+                 * @deprecated
+                 * @description Number of items per page. Deprecated alias of pageSize;
+                 *     canonical `pageSize` wins when both are present.
+                 */
+                pagesize?: number;
+                /** @description Get responses that match search param value */
+                search?: string;
+                /** @description Get ordered responses */
+                order?: string;
+                /** @description Filter by platform (e.g. linkedin, github). */
+                platform?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Blowhorn contacts page */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Current page number of the result set. */
+                        page?: number;
+                        /** @description Number of items per page. */
+                        pageSize?: number;
+                        /** @description Total number of items available. */
+                        totalCount?: number;
+                        /** @description Blowhorn contacts included on this page of results. */
+                        blowhornContacts?: {
+                            /**
+                             * Format: uuid
+                             * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                             */
+                            id: string;
+                            /**
+                             * Format: uuid
+                             * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                             */
+                            organizationId: string;
+                            /** @description Platform the contact belongs to (e.g. linkedin, github). */
+                            platform: string;
+                            /** @description Platform-side handle identifying the contact. Unique per platform within the organization. */
+                            handle: string;
+                            /** @description Human-readable contact name. */
+                            displayName?: string;
+                            /** @description Platform-side profile URL for the contact. */
+                            profileUrl?: string;
+                            /** @description Contact metadata, stored as a JSON blob. */
+                            metadata?: Record<string, never>;
+                            /**
+                             * Format: date-time
+                             * @description Timestamp of Blowhorn contact creation.
+                             */
+                            createdAt: string;
+                            /**
+                             * Format: date-time
+                             * @description Timestamp of last Blowhorn contact modification.
+                             */
+                            updatedAt: string;
+                        }[];
+                    };
+                };
+            };
+            /** @description Expired JWT token used or insufficient privilege */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+        };
+    };
+    upsertBlowhornContact: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * Format: uuid
+                     * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                     */
+                    id?: string;
+                    /** @description Platform the contact belongs to (e.g. linkedin, github). */
+                    platform: string;
+                    /** @description Platform-side handle identifying the contact. Unique per platform within the organization. */
+                    handle: string;
+                    /** @description Human-readable contact name. */
+                    displayName?: string;
+                    /** @description Platform-side profile URL for the contact. */
+                    profileUrl?: string;
+                    /** @description Contact metadata, stored as a JSON blob. */
+                    metadata?: Record<string, never>;
+                };
+            };
+        };
+        responses: {
+            /** @description Blowhorn contact saved */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * Format: uuid
+                         * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                         */
+                        id: string;
+                        /**
+                         * Format: uuid
+                         * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                         */
+                        organizationId: string;
+                        /** @description Platform the contact belongs to (e.g. linkedin, github). */
+                        platform: string;
+                        /** @description Platform-side handle identifying the contact. Unique per platform within the organization. */
+                        handle: string;
+                        /** @description Human-readable contact name. */
+                        displayName?: string;
+                        /** @description Platform-side profile URL for the contact. */
+                        profileUrl?: string;
+                        /** @description Contact metadata, stored as a JSON blob. */
+                        metadata?: Record<string, never>;
+                        /**
+                         * Format: date-time
+                         * @description Timestamp of Blowhorn contact creation.
+                         */
+                        createdAt: string;
+                        /**
+                         * Format: date-time
+                         * @description Timestamp of last Blowhorn contact modification.
+                         */
+                        updatedAt: string;
+                    };
+                };
+            };
+            /** @description Invalid request body or request param */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Expired JWT token used or insufficient privilege */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+        };
+    };
+    listBlowhornMentees: {
+        parameters: {
+            query?: {
+                /** @description Get responses by page */
+                page?: number;
+                /** @description Number of items per page (canonical camelCase form). */
+                pageSize?: number;
+                /**
+                 * @deprecated
+                 * @description Number of items per page. Deprecated alias of pageSize;
+                 *     canonical `pageSize` wins when both are present.
+                 */
+                pagesize?: number;
+                /** @description Get responses that match search param value */
+                search?: string;
+                /** @description Get ordered responses */
+                order?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Blowhorn mentees page */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Current page number of the result set. */
+                        page?: number;
+                        /** @description Number of items per page. */
+                        pageSize?: number;
+                        /** @description Total number of items available. */
+                        totalCount?: number;
+                        /** @description Blowhorn mentees included on this page of results. */
+                        blowhornMentees?: {
+                            /**
+                             * Format: uuid
+                             * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                             */
+                            id: string;
+                            /**
+                             * Format: uuid
+                             * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                             */
+                            organizationId: string;
+                            /** @description Mentored subject. */
+                            subject: string;
+                            /** @description Mentorship stage of the subject. */
+                            stage?: string;
+                            /** @description Mentee metadata, stored as a JSON blob. */
+                            metadata?: Record<string, never>;
+                            /**
+                             * Format: date-time
+                             * @description Time the mentee was recorded and dropped, if any. Set only by the record-and-drop operation.
+                             */
+                            droppedAt?: string | null;
+                            /**
+                             * Format: date-time
+                             * @description Timestamp of Blowhorn mentee creation.
+                             */
+                            createdAt: string;
+                            /**
+                             * Format: date-time
+                             * @description Timestamp of last Blowhorn mentee modification.
+                             */
+                            updatedAt: string;
+                        }[];
+                    };
+                };
+            };
+            /** @description Expired JWT token used or insufficient privilege */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+        };
+    };
+    upsertBlowhornMentee: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /**
+                     * Format: uuid
+                     * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                     */
+                    id?: string;
+                    /** @description Mentored subject. */
+                    subject: string;
+                    /** @description Mentorship stage of the subject. */
+                    stage?: string;
+                    /** @description Mentee metadata, stored as a JSON blob. */
+                    metadata?: Record<string, never>;
+                };
+            };
+        };
+        responses: {
+            /** @description Blowhorn mentee saved */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * Format: uuid
+                         * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                         */
+                        id: string;
+                        /**
+                         * Format: uuid
+                         * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                         */
+                        organizationId: string;
+                        /** @description Mentored subject. */
+                        subject: string;
+                        /** @description Mentorship stage of the subject. */
+                        stage?: string;
+                        /** @description Mentee metadata, stored as a JSON blob. */
+                        metadata?: Record<string, never>;
+                        /**
+                         * Format: date-time
+                         * @description Time the mentee was recorded and dropped, if any. Set only by the record-and-drop operation.
+                         */
+                        droppedAt?: string | null;
+                        /**
+                         * Format: date-time
+                         * @description Timestamp of Blowhorn mentee creation.
+                         */
+                        createdAt: string;
+                        /**
+                         * Format: date-time
+                         * @description Timestamp of last Blowhorn mentee modification.
+                         */
+                        updatedAt: string;
+                    };
+                };
+            };
+            /** @description Invalid request body or request param */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Expired JWT token used or insufficient privilege */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+        };
+    };
+    deleteBlowhornMentee: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Blowhorn mentee ID */
+                blowhornMenteeId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Blowhorn mentee deleted */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Expired JWT token used or insufficient privilege */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Result not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+        };
+    };
+    recordAndDropBlowhornMentee: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Blowhorn mentee ID */
+                blowhornMenteeId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /** @description Final mentorship stage recorded with the drop. */
+                    stage?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Blowhorn mentee recorded and dropped */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * Format: uuid
+                         * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                         */
+                        id: string;
+                        /**
+                         * Format: uuid
+                         * @description A Universally Unique Identifier used to uniquely identify entities in Meshery. The UUID core definition is used across different schemas.
+                         */
+                        organizationId: string;
+                        /** @description Mentored subject. */
+                        subject: string;
+                        /** @description Mentorship stage of the subject. */
+                        stage?: string;
+                        /** @description Mentee metadata, stored as a JSON blob. */
+                        metadata?: Record<string, never>;
+                        /**
+                         * Format: date-time
+                         * @description Time the mentee was recorded and dropped, if any. Set only by the record-and-drop operation.
+                         */
+                        droppedAt?: string | null;
+                        /**
+                         * Format: date-time
+                         * @description Timestamp of Blowhorn mentee creation.
+                         */
+                        createdAt: string;
+                        /**
+                         * Format: date-time
+                         * @description Timestamp of last Blowhorn mentee modification.
+                         */
+                        updatedAt: string;
+                    };
+                };
+            };
+            /** @description Invalid request body or request param */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Expired JWT token used or insufficient privilege */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Result not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/plain": string;
+                };
+            };
+        };
+    };
+}