@mentio-dev/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,4550 @@
+type AuthToken = string | undefined;
+interface Auth {
+    /**
+     * Which part of the request do we use to send the auth?
+     *
+     * @default 'header'
+     */
+    in?: 'header' | 'query' | 'cookie';
+    /**
+     * A unique identifier for the security scheme.
+     *
+     * Defined only when there are multiple security schemes whose `Auth`
+     * shape would otherwise be identical.
+     */
+    key?: string;
+    /**
+     * Header or query parameter name.
+     *
+     * @default 'Authorization'
+     */
+    name?: string;
+    scheme?: 'basic' | 'bearer';
+    type: 'apiKey' | 'http';
+}
+
+interface SerializerOptions<T> {
+    /**
+     * @default true
+     */
+    explode: boolean;
+    style: T;
+}
+type ArrayStyle = 'form' | 'spaceDelimited' | 'pipeDelimited';
+type ObjectStyle = 'form' | 'deepObject';
+
+type QuerySerializer = (query: Record<string, unknown>) => string;
+type BodySerializer = (body: unknown) => unknown;
+type QuerySerializerOptionsObject = {
+    allowReserved?: boolean;
+    array?: Partial<SerializerOptions<ArrayStyle>>;
+    object?: Partial<SerializerOptions<ObjectStyle>>;
+};
+type QuerySerializerOptions = QuerySerializerOptionsObject & {
+    /**
+     * Per-parameter serialization overrides. When provided, these settings
+     * override the global array/object settings for specific parameter names.
+     */
+    parameters?: Record<string, QuerySerializerOptionsObject>;
+};
+
+type HttpMethod = 'connect' | 'delete' | 'get' | 'head' | 'options' | 'patch' | 'post' | 'put' | 'trace';
+type Client$1<RequestFn = never, Config = unknown, MethodFn = never, BuildUrlFn = never, SseFn = never> = {
+    /**
+     * Returns the final request URL.
+     */
+    buildUrl: BuildUrlFn;
+    getConfig: () => Config;
+    request: RequestFn;
+    setConfig: (config: Config) => Config;
+} & {
+    [K in HttpMethod]: MethodFn;
+} & ([SseFn] extends [never] ? {
+    sse?: never;
+} : {
+    sse: {
+        [K in HttpMethod]: SseFn;
+    };
+});
+interface Config$1 {
+    /**
+     * Auth token or a function returning auth token. The resolved value will be
+     * added to the request payload as defined by its `security` array.
+     */
+    auth?: ((auth: Auth) => Promise<AuthToken> | AuthToken) | AuthToken;
+    /**
+     * A function for serializing request body parameter. By default,
+     * {@link JSON.stringify()} will be used.
+     */
+    bodySerializer?: BodySerializer | null;
+    /**
+     * An object containing any HTTP headers that you want to pre-populate your
+     * `Headers` object with.
+     *
+     * {@link https://developer.mozilla.org/docs/Web/API/Headers/Headers#init See more}
+     */
+    headers?: RequestInit['headers'] | Record<string, string | number | boolean | (string | number | boolean)[] | null | undefined | unknown>;
+    /**
+     * The request method.
+     *
+     * {@link https://developer.mozilla.org/docs/Web/API/fetch#method See more}
+     */
+    method?: Uppercase<HttpMethod>;
+    /**
+     * A function for serializing request query parameters. By default, arrays
+     * will be exploded in form style, objects will be exploded in deepObject
+     * style, and reserved characters are percent-encoded.
+     *
+     * This method will have no effect if the native `paramsSerializer()` Axios
+     * API function is used.
+     *
+     * {@link https://swagger.io/docs/specification/serialization/#query View examples}
+     */
+    querySerializer?: QuerySerializer | QuerySerializerOptions;
+    /**
+     * A function validating request data. This is useful if you want to ensure
+     * the request conforms to the desired shape, so it can be safely sent to
+     * the server.
+     */
+    requestValidator?: (data: unknown) => Promise<unknown>;
+    /**
+     * A function transforming response data before it's returned. This is useful
+     * for post-processing data, e.g., converting ISO strings into Date objects.
+     */
+    responseTransformer?: (data: unknown) => Promise<unknown>;
+    /**
+     * A function validating response data. This is useful if you want to ensure
+     * the response conforms to the desired shape, so it can be safely passed to
+     * the transformers and returned to the user.
+     */
+    responseValidator?: (data: unknown) => Promise<unknown>;
+}
+/**
+ * Arbitrary metadata passed through the `meta` request option.
+ */
+interface ClientMeta {
+}
+
+type ServerSentEventsOptions<TData = unknown> = Omit<RequestInit, 'method'> & Pick<Config$1, 'method' | 'responseTransformer' | 'responseValidator'> & {
+    /**
+     * Fetch API implementation. You can use this option to provide a custom
+     * fetch instance.
+     *
+     * @default globalThis.fetch
+     */
+    fetch?: typeof fetch;
+    /**
+     * Implementing clients can call request interceptors inside this hook.
+     */
+    onRequest?: (url: string, init: RequestInit) => Promise<Request>;
+    /**
+     * Callback invoked when a network or parsing error occurs during streaming.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @param error The error that occurred.
+     */
+    onSseError?: (error: unknown) => void;
+    /**
+     * Callback invoked when an event is streamed from the server.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @param event Event streamed from the server.
+     * @returns Nothing (void).
+     */
+    onSseEvent?: (event: StreamEvent<TData>) => void;
+    serializedBody?: RequestInit['body'];
+    /**
+     * Default retry delay in milliseconds.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @default 3000
+     */
+    sseDefaultRetryDelay?: number;
+    /**
+     * Maximum number of retry attempts before giving up.
+     */
+    sseMaxRetryAttempts?: number;
+    /**
+     * Maximum retry delay in milliseconds.
+     *
+     * Applies only when exponential backoff is used.
+     *
+     * This option applies only if the endpoint returns a stream of events.
+     *
+     * @default 30000
+     */
+    sseMaxRetryDelay?: number;
+    /**
+     * Optional sleep function for retry backoff.
+     *
+     * Defaults to using `setTimeout`.
+     */
+    sseSleepFn?: (ms: number) => Promise<void>;
+    url: string;
+};
+interface StreamEvent<TData = unknown> {
+    data: TData;
+    event?: string;
+    id?: string;
+    retry?: number;
+}
+type ServerSentEventsResult<TData = unknown, TReturn = void, TNext = unknown> = {
+    stream: AsyncGenerator<TData extends Record<string, unknown> ? TData[keyof TData] : TData, TReturn, TNext>;
+};
+
+type ErrInterceptor<Err, Res, Req, Options> = (error: Err, 
+/** response may be undefined due to a network error where no response object is produced */
+response: Res | undefined, 
+/** request may be undefined, because error may be from building the request object itself */
+request: Req | undefined, options: Options) => Err | Promise<Err>;
+type ReqInterceptor<Req, Options> = (request: Req, options: Options) => Req | Promise<Req>;
+type ResInterceptor<Res, Req, Options> = (response: Res, request: Req, options: Options) => Res | Promise<Res>;
+declare class Interceptors<Interceptor> {
+    fns: Array<Interceptor | null>;
+    clear(): void;
+    eject(id: number | Interceptor): void;
+    exists(id: number | Interceptor): boolean;
+    getInterceptorIndex(id: number | Interceptor): number;
+    update(id: number | Interceptor, fn: Interceptor): number | Interceptor | false;
+    use(fn: Interceptor): number;
+}
+interface Middleware<Req, Res, Err, Options> {
+    error: Interceptors<ErrInterceptor<Err, Res, Req, Options>>;
+    request: Interceptors<ReqInterceptor<Req, Options>>;
+    response: Interceptors<ResInterceptor<Res, Req, Options>>;
+}
+declare const createConfig: <T extends ClientOptions$1 = ClientOptions$1>(override?: Config<Omit<ClientOptions$1, keyof T> & T>) => Config<Omit<ClientOptions$1, keyof T> & T>;
+
+type ResponseStyle = 'data' | 'fields';
+interface Config<T extends ClientOptions$1 = ClientOptions$1> extends Omit<RequestInit, 'body' | 'headers' | 'method'>, Config$1 {
+    /**
+     * Base URL for all requests made by this client.
+     */
+    baseUrl?: T['baseUrl'];
+    /**
+     * Fetch API implementation. You can use this option to provide a custom
+     * fetch instance.
+     *
+     * @default globalThis.fetch
+     */
+    fetch?: typeof fetch;
+    /**
+     * Please don't use the Fetch client for Next.js applications. The `next`
+     * options won't have any effect.
+     *
+     * Install {@link https://www.npmjs.com/package/@hey-api/client-next `@hey-api/client-next`} instead.
+     */
+    next?: never;
+    /**
+     * Return the response data parsed in a specified format. By default, `auto`
+     * will infer the appropriate method from the `Content-Type` response header.
+     * You can override this behavior with any of the {@link Body} methods.
+     * Select `stream` if you don't want to parse response data at all.
+     *
+     * @default 'auto'
+     */
+    parseAs?: 'arrayBuffer' | 'auto' | 'blob' | 'formData' | 'json' | 'stream' | 'text';
+    /**
+     * Should we return only data or multiple fields (data, error, response, etc.)?
+     *
+     * @default 'fields'
+     */
+    responseStyle?: ResponseStyle;
+    /**
+     * Throw an error instead of returning it in the response?
+     *
+     * @default false
+     */
+    throwOnError?: T['throwOnError'];
+}
+interface RequestOptions<TData = unknown, TResponseStyle extends ResponseStyle = 'fields', ThrowOnError extends boolean = boolean, Url extends string = string> extends Config<{
+    responseStyle: TResponseStyle;
+    throwOnError: ThrowOnError;
+}>, Pick<ServerSentEventsOptions<TData>, 'onRequest' | 'onSseError' | 'onSseEvent' | 'sseDefaultRetryDelay' | 'sseMaxRetryAttempts' | 'sseMaxRetryDelay'> {
+    /**
+     * Any body that you want to add to your request.
+     *
+     * {@link https://developer.mozilla.org/docs/Web/API/fetch#body}
+     */
+    body?: unknown;
+    path?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    /**
+     * Security mechanism(s) to use for the request.
+     */
+    security?: ReadonlyArray<Auth>;
+    url: Url;
+}
+interface ResolvedRequestOptions<TResponseStyle extends ResponseStyle = 'fields', ThrowOnError extends boolean = boolean, Url extends string = string> extends RequestOptions<unknown, TResponseStyle, ThrowOnError, Url> {
+    headers: Headers;
+    serializedBody?: string;
+}
+type RequestResult<TData = unknown, TError = unknown, ThrowOnError extends boolean = boolean, TResponseStyle extends ResponseStyle = 'fields'> = ThrowOnError extends true ? Promise<TResponseStyle extends 'data' ? TData extends Record<string, unknown> ? TData[keyof TData] : TData : {
+    data: TData extends Record<string, unknown> ? TData[keyof TData] : TData;
+    request: Request;
+    response: Response;
+}> : Promise<TResponseStyle extends 'data' ? (TData extends Record<string, unknown> ? TData[keyof TData] : TData) | undefined : ({
+    data: TData extends Record<string, unknown> ? TData[keyof TData] : TData;
+    error: undefined;
+} | {
+    data: undefined;
+    error: TError extends Record<string, unknown> ? TError[keyof TError] : TError;
+}) & {
+    /** request may be undefined, because error may be from building the request object itself */
+    request?: Request;
+    /** response may be undefined, because error may be from building the request object itself or from a network error */
+    response?: Response;
+}>;
+interface ClientOptions$1 {
+    baseUrl?: string;
+    responseStyle?: ResponseStyle;
+    throwOnError?: boolean;
+}
+type MethodFn = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<TData, TResponseStyle, ThrowOnError>, 'method'>) => RequestResult<TData, TError, ThrowOnError, TResponseStyle>;
+type SseFn = <TData = unknown, _TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<never, TResponseStyle, ThrowOnError>, 'method'>) => Promise<ServerSentEventsResult<TData>>;
+type RequestFn = <TData = unknown, TError = unknown, ThrowOnError extends boolean = false, TResponseStyle extends ResponseStyle = 'fields'>(options: Omit<RequestOptions<TData, TResponseStyle, ThrowOnError>, 'method'> & Pick<Required<RequestOptions<TData, TResponseStyle, ThrowOnError>>, 'method'>) => RequestResult<TData, TError, ThrowOnError, TResponseStyle>;
+type BuildUrlFn = <TData extends {
+    body?: unknown;
+    path?: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    url: string;
+}>(options: TData & Options$1<TData>) => string;
+type Client = Client$1<RequestFn, Config, MethodFn, BuildUrlFn, SseFn> & {
+    interceptors: Middleware<Request, Response, unknown, ResolvedRequestOptions>;
+};
+interface TDataShape {
+    body?: unknown;
+    headers?: unknown;
+    path?: unknown;
+    query?: unknown;
+    url: string;
+}
+type OmitKeys<T, K> = Pick<T, Exclude<keyof T, K>>;
+type Options$1<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown, TResponseStyle extends ResponseStyle = 'fields'> = OmitKeys<RequestOptions<TResponse, TResponseStyle, ThrowOnError>, 'body' | 'path' | 'query' | 'url'> & ([TData] extends [never] ? unknown : Omit<TData, 'url'>);
+
+declare const createClient: (config?: Config) => Client;
+
+type ClientOptions = {
+    baseUrl: 'https://api.mentio.dev' | (string & {});
+};
+type Keyword = {
+    /**
+     * Keyword id (kw_...).
+     */
+    id: string;
+    term: string;
+    kind: 'brand' | 'competitor' | 'topic';
+    muted: boolean;
+    /**
+     * Platforms this keyword is tracked on; null means every platform.
+     */
+    platforms: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin'> | null;
+    /**
+     * Computed over this workspace's matches.
+     */
+    stats: {
+        /**
+         * Every match ever, relevant or not: the number billing counts.
+         */
+        mentions: number;
+        /**
+         * Matches scored at or above the relevance threshold.
+         */
+        relevant: number;
+        /**
+         * Matches published in the last 7 days.
+         */
+        last7d: number;
+        /**
+         * Newest matched post; null until the first one.
+         */
+        lastMentionAt: string | null;
+    };
+    /**
+     * Poll health per platform polled on a schedule. Live feeds (Bluesky) have no entry.
+     */
+    polling: Array<{
+        /**
+         * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin.
+         */
+        platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin';
+        /**
+         * Newest poll of this platform for the term; null until the first one.
+         */
+        lastPolledAt: string | null;
+        /**
+         * Consecutive polls that found nothing new; the scheduler slows down as it grows.
+         */
+        emptyPolls: number;
+    }>;
+    /**
+     * ISO 8601 timestamp, UTC.
+     */
+    createdAt: string;
+};
+type ErrorResponse = {
+    /**
+     * The error.
+     */
+    error: {
+        /**
+         * Stable machine-readable code (not_found, validation_error, ...); branch on this.
+         */
+        code: string;
+        /**
+         * Human-readable detail; may change between releases.
+         */
+        message: string;
+    };
+};
+type Mention = {
+    /**
+     * Mention id (mm_...): one post matched to one of your keywords. A post matching two keywords has two ids.
+     */
+    id: string;
+    /**
+     * open: nobody handled it yet. ignored: hidden from the feed and channels by you. done: handled.
+     */
+    status: 'open' | 'ignored' | 'done';
+    /**
+     * The classifier scored it at or above the delivery threshold (40).
+     */
+    relevant: boolean;
+    /**
+     * Reached at least one of your channels.
+     */
+    delivered: boolean;
+    /**
+     * Attention score, one decimal, computed at read time: relevance halved, author reach on a follower ladder (unknown reach counts 8), the strongest intent (buy intent 20 down to praise 5), minus 2 per day of age floored at 20.
+     */
+    priority: number;
+    /**
+     * The keyword this post matched.
+     */
+    keyword: {
+        id: string;
+        term: string;
+    };
+    post: {
+        /**
+         * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin.
+         */
+        platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin';
+        /**
+         * Permalink of the post.
+         */
+        url: string;
+        /**
+         * Title and body, truncated to 8 KB at ingest.
+         */
+        text: string;
+        /**
+         * When the post was published.
+         */
+        publishedAt: string;
+        /**
+         * The post this one replies to (X, Bluesky); null for top-level posts.
+         */
+        replyTo: {
+            /**
+             * Parent post author as the platform names them.
+             */
+            author: string | null;
+            /**
+             * Parent post URL.
+             */
+            url: string | null;
+            /**
+             * Parent post text, when the platform gave it.
+             */
+            text: string | null;
+        } | null;
+    };
+    /**
+     * Who posted it; null when the platform gave no author at all.
+     */
+    author: {
+        /**
+         * Person id (aut_...) for GET /v1/people/{id}; null when the account is not in the audience yet.
+         */
+        id: string | null;
+        /**
+         * Display name as the platform reports it.
+         */
+        name: string | null;
+        /**
+         * Platform handle derived from the profile URL, formatted as the platform shows it (@name, u/name); null where the platform has none.
+         */
+        handle: string | null;
+        /**
+         * Profile URL.
+         */
+        url: string | null;
+        /**
+         * Profile picture; null where the platform has none.
+         */
+        avatarUrl: string | null;
+        /**
+         * Follower count as of their newest post; null where the platform has none.
+         */
+        followers: number | null;
+        /**
+         * Your workspace tags on this person.
+         */
+        tags: Array<string>;
+    } | null;
+    /**
+     * The classifier verdict; null while the post is still queued for classification.
+     */
+    classification: {
+        /**
+         * 0 to 100; null only when classification failed.
+         */
+        relevance: number | null;
+        /**
+         * Classifier sentiment.
+         */
+        sentiment: 'positive' | 'neutral' | 'negative';
+        /**
+         * Detected intents: buy_intent, question, complaint, praise, comparison.
+         */
+        intents: Array<string>;
+        /**
+         * One sentence from the classifier explaining the score.
+         */
+        note: string | null;
+        /**
+         * true when the model could not score this post; it stays in the feed and is not billed.
+         */
+        failed: boolean;
+    } | null;
+    triage: {
+        /**
+         * Workspace member this mention is assigned to; null when unassigned.
+         */
+        assignee: {
+            id: string;
+            name: string | null;
+            email: string | null;
+        } | null;
+        /**
+         * Until when the mention stays out of the feed; null when not snoozed.
+         */
+        snoozedUntil: string | null;
+        /**
+         * Internal note; null when none.
+         */
+        note: string | null;
+    };
+    /**
+     * When the match was recorded; the default feed order.
+     */
+    createdAt: string;
+};
+type Person = {
+    /**
+     * Person id (aut_...): the canonical account. An account merged into someone resolves to that person.
+     */
+    id: string;
+    /**
+     * Platform of the canonical account; `accounts` lists every account.
+     */
+    platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin';
+    /**
+     * Display name as of their newest post; null when the platform has none.
+     */
+    name: string | null;
+    /**
+     * Platform handle of the canonical account, formatted as the platform shows it.
+     */
+    handle: string | null;
+    /**
+     * Profile URL of the canonical account.
+     */
+    url: string | null;
+    avatarUrl: string | null;
+    /**
+     * Every account this workspace treats as this person, the canonical one first.
+     */
+    accounts: Array<{
+        /**
+         * The account id (aut_...); the canonical one equals the person id.
+         */
+        id: string;
+        /**
+         * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin.
+         */
+        platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin';
+        /**
+         * Display name as the platform reports it.
+         */
+        name: string | null;
+        /**
+         * Platform handle derived from the profile URL, formatted as the platform shows it.
+         */
+        handle: string | null;
+        /**
+         * Profile URL.
+         */
+        url: string | null;
+    }>;
+    /**
+     * Platform counts as of their newest post; null where the platform has no such number.
+     */
+    reach: {
+        followers: number | null;
+        following: number | null;
+        posts: number | null;
+    };
+    /**
+     * Public profile facts; null until looked up.
+     */
+    profile: {
+        bio: string | null;
+        company: string | null;
+        location: string | null;
+        website: string | null;
+        /**
+         * Only when the person made it public on the platform.
+         */
+        email: string | null;
+        /**
+         * Other accounts the person lists on their profile.
+         */
+        links: Array<{
+            provider: string;
+            url: string;
+        }>;
+        /**
+         * When the profile was read.
+         */
+        fetchedAt: string;
+    } | null;
+    /**
+     * Computed over this workspace's matches.
+     */
+    stats: {
+        /**
+         * Every match of theirs for this workspace, relevant or not.
+         */
+        mentions: number;
+        /**
+         * Of those, scored relevant.
+         */
+        relevant: number;
+        sentiment: {
+            positive: number;
+            neutral: number;
+            negative: number;
+        };
+        /**
+         * Their oldest matched post.
+         */
+        firstSeenAt: string;
+        /**
+         * Their newest matched post.
+         */
+        lastSeenAt: string;
+    };
+    /**
+     * What this workspace wrote about the person.
+     */
+    annotations: {
+        tags: Array<string>;
+        notes: string;
+        /**
+         * Their posts stay out of the feed and every channel; ingest and billing are untouched.
+         */
+        muted: boolean;
+    };
+};
+type Segment = {
+    /**
+     * Segment id (seg_...).
+     */
+    id: string;
+    name: string;
+    description: string;
+    filter: {
+        /**
+         * People with an account on any of these platforms.
+         */
+        platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin'>;
+        /**
+         * People carrying any of these tags.
+         */
+        tags?: Array<string>;
+        /**
+         * At least this many followers. Unknown reach never matches.
+         */
+        minFollowers?: number;
+        /**
+         * At most this many followers. Unknown reach never matches.
+         */
+        maxFollowers?: number;
+        /**
+         * At least this many matched mentions.
+         */
+        minMentions?: number;
+        /**
+         * At least this many negative mentions.
+         */
+        minNegative?: number;
+        /**
+         * At least one mention carrying any of these intents.
+         */
+        intents?: Array<string>;
+        /**
+         * Mentioned a keyword of any of these kinds.
+         */
+        keywordKinds?: Array<'brand' | 'competitor' | 'topic'>;
+        /**
+         * Never mentioned a keyword of these kinds.
+         */
+        neverKeywordKinds?: Array<'brand' | 'competitor' | 'topic'>;
+        /**
+         * First seen within this many days.
+         */
+        newSinceDays?: number;
+        /**
+         * true: only muted people; false: only unmuted.
+         */
+        muted?: boolean;
+    };
+    /**
+     * People in the segment right now; it is evaluated on every read.
+     */
+    count: number;
+    /**
+     * ISO 8601 timestamp, UTC.
+     */
+    createdAt: string;
+    /**
+     * ISO 8601 timestamp, UTC.
+     */
+    updatedAt: string;
+};
+type Company = {
+    /**
+     * Brand or company name, as the classifier should call it.
+     */
+    name: string;
+    /**
+     * What the company does, one paragraph.
+     */
+    description: string;
+    /**
+     * What people use the product for.
+     */
+    useCases: Array<string>;
+    /**
+     * Your own accounts, so your own posts are recognized.
+     */
+    accounts: {
+        /**
+         * X handle without the @.
+         */
+        x: string | null;
+        /**
+         * LinkedIn page slug or URL.
+         */
+        linkedin: string | null;
+    };
+    /**
+     * The text the classifier reads. Composed from the fields above unless you override it.
+     */
+    context: string;
+};
+type Alert = {
+    /**
+     * Alert id (feed_...).
+     */
+    id: string;
+    name: string;
+    enabled: boolean;
+    /**
+     * instant: each matching mention as it happens. daily: one digest at the scheduled local time.
+     */
+    mode: 'instant' | 'daily';
+    filter: {
+        /**
+         * Only these keywords.
+         */
+        keywordIds?: Array<string>;
+        /**
+         * Only posts from these platforms.
+         */
+        platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin'>;
+        /**
+         * Only mentions scored at least this; unclassified ones never pass.
+         */
+        minRelevance?: number;
+        /**
+         * Only these sentiments.
+         */
+        sentiments?: Array<'positive' | 'neutral' | 'negative'>;
+        /**
+         * At least one of these intents.
+         */
+        intents?: Array<string>;
+        /**
+         * Never these authors: display names, handles or profile URLs.
+         */
+        excludeAuthors?: Array<string>;
+        /**
+         * Only authors with at least this many followers. Unknown reach never passes.
+         */
+        minFollowers?: number;
+        /**
+         * Only authors your workspace tagged with any of these.
+         */
+        tags?: Array<string>;
+    };
+    /**
+     * Daily alerts only.
+     */
+    schedule: {
+        hour: number;
+        minute?: number;
+        timezone: string;
+        skipEmpty?: boolean;
+    } | null;
+    /**
+     * Event name carried in webhook payloads; the mode default unless you set one.
+     */
+    event: string;
+    /**
+     * Where it sends.
+     */
+    channels: Array<{
+        id: string;
+        kind: 'slack' | 'email' | 'webhook' | 'telegram';
+        label: string;
+    }>;
+    /**
+     * Computed over this workspace's deliveries.
+     */
+    stats: {
+        /**
+         * Deliveries in the last 7 days, across channels.
+         */
+        sentLast7d: number;
+        /**
+         * ISO 8601 timestamp, UTC.
+         */
+        lastSentAt: string | null;
+        /**
+         * Daily alerts: the next digest; null when disabled or instant.
+         */
+        nextRunAt: string | null;
+    };
+    /**
+     * ISO 8601 timestamp, UTC.
+     */
+    createdAt: string;
+};
+type AnalyticsSummary = {
+    /**
+     * The window the report covers.
+     */
+    window: {
+        /**
+         * First day, inclusive.
+         */
+        from: string;
+        /**
+         * Last day, inclusive.
+         */
+        to: string;
+        /**
+         * Length of the window in days.
+         */
+        days: number;
+        /**
+         * IANA zone the days were cut in.
+         */
+        timezone: string;
+    };
+    /**
+     * Every match in the window, relevant or not: the number usage counts.
+     */
+    matched: number;
+    /**
+     * Matches scored at or above the relevance threshold.
+     */
+    relevant: number;
+    /**
+     * Distinct posts behind the matches: a post matching two keywords is two matches, one post.
+     */
+    posts: number;
+    /**
+     * Distinct authors behind the matches.
+     */
+    people: number;
+    /**
+     * Matched mentions by classifier sentiment.
+     */
+    sentiment: {
+        /**
+         * Classified positive.
+         */
+        positive: number;
+        /**
+         * Classified neutral.
+         */
+        neutral: number;
+        /**
+         * Classified negative.
+         */
+        negative: number;
+        /**
+         * Not scored: still queued, or the classifier failed on it.
+         */
+        unclassified: number;
+    };
+    /**
+     * Matches carrying the buy_intent intent.
+     */
+    buyIntent: number;
+    /**
+     * Matches carrying the question intent.
+     */
+    questions: number;
+    /**
+     * Estimated reach.
+     */
+    reach: {
+        /**
+         * Followers summed over the distinct authors whose count is known: an estimate of the feeds the posts landed in.
+         */
+        followers: number;
+        /**
+         * How many of `people` have a known follower count.
+         */
+        people: number;
+    };
+    /**
+     * Where the matches stand in your inbox.
+     */
+    triage: {
+        /**
+         * Status open.
+         */
+        open: number;
+        /**
+         * Status ignored.
+         */
+        ignored: number;
+        /**
+         * Status done.
+         */
+        done: number;
+        /**
+         * Relevant, still open, and matched more than 24 hours ago.
+         */
+        waiting: number;
+        /**
+         * done divided by relevant, 0 to 1; null when nothing was relevant.
+         */
+        handledRate: number | null;
+        /**
+         * Median milliseconds from match to done; null when nothing was done.
+         */
+        medianTimeToDoneMs: number | null;
+    };
+    /**
+     * The same counts over the period of the same length right before the window; null unless compare=true.
+     */
+    previous: {
+        /**
+         * Every match in the window, relevant or not: the number usage counts.
+         */
+        matched: number;
+        /**
+         * Matches scored at or above the relevance threshold.
+         */
+        relevant: number;
+        /**
+         * Distinct posts behind the matches: a post matching two keywords is two matches, one post.
+         */
+        posts: number;
+        /**
+         * Distinct authors behind the matches.
+         */
+        people: number;
+        /**
+         * Matched mentions by classifier sentiment.
+         */
+        sentiment: {
+            /**
+             * Classified positive.
+             */
+            positive: number;
+            /**
+             * Classified neutral.
+             */
+            neutral: number;
+            /**
+             * Classified negative.
+             */
+            negative: number;
+            /**
+             * Not scored: still queued, or the classifier failed on it.
+             */
+            unclassified: number;
+        };
+        /**
+         * Matches carrying the buy_intent intent.
+         */
+        buyIntent: number;
+        /**
+         * Matches carrying the question intent.
+         */
+        questions: number;
+        /**
+         * Estimated reach.
+         */
+        reach: {
+            /**
+             * Followers summed over the distinct authors whose count is known: an estimate of the feeds the posts landed in.
+             */
+            followers: number;
+            /**
+             * How many of `people` have a known follower count.
+             */
+            people: number;
+        };
+        /**
+         * Where the matches stand in your inbox.
+         */
+        triage: {
+            /**
+             * Status open.
+             */
+            open: number;
+            /**
+             * Status ignored.
+             */
+            ignored: number;
+            /**
+             * Status done.
+             */
+            done: number;
+            /**
+             * Relevant, still open, and matched more than 24 hours ago.
+             */
+            waiting: number;
+            /**
+             * done divided by relevant, 0 to 1; null when nothing was relevant.
+             */
+            handledRate: number | null;
+            /**
+             * Median milliseconds from match to done; null when nothing was done.
+             */
+            medianTimeToDoneMs: number | null;
+        };
+    } | null;
+};
+type AnalyticsSeries = {
+    /**
+     * The window the report covers.
+     */
+    window: {
+        /**
+         * First day, inclusive.
+         */
+        from: string;
+        /**
+         * Last day, inclusive.
+         */
+        to: string;
+        /**
+         * Length of the window in days.
+         */
+        days: number;
+        /**
+         * IANA zone the days were cut in.
+         */
+        timezone: string;
+        /**
+         * Point granularity: day, or week (Monday to Sunday).
+         */
+        bucket: 'day' | 'week';
+    };
+    /**
+     * One item per series, most matched first; a single "total" item when not split.
+     */
+    data: Array<{
+        /**
+         * Platform name, keyword id, "total" for the unsplit series, or "other" for the keys beyond the top 20.
+         */
+        key: string;
+        /**
+         * Readable name: the platform, the keyword term, "Total" or "Other".
+         */
+        label: string;
+        /**
+         * Set when split by keyword; null otherwise.
+         */
+        keyword: {
+            /**
+             * Keyword id (kw_...).
+             */
+            id: string;
+            /**
+             * The tracked term.
+             */
+            term: string;
+            /**
+             * brand, competitor or topic.
+             */
+            kind: 'brand' | 'competitor' | 'topic';
+        } | null;
+        /**
+         * One point per bucket across the window, oldest first, zero-filled.
+         */
+        points: Array<{
+            /**
+             * The day, or the Monday of the week.
+             */
+            date: string;
+            /**
+             * Every match published in the bucket.
+             */
+            matched: number;
+            /**
+             * Of those, scored at or above the relevance threshold.
+             */
+            relevant: number;
+            /**
+             * Classified positive.
+             */
+            positive: number;
+            /**
+             * Classified neutral.
+             */
+            neutral: number;
+            /**
+             * Classified negative.
+             */
+            negative: number;
+            /**
+             * Not scored: still queued, or the classifier failed on it.
+             */
+            unclassified: number;
+        }>;
+    }>;
+    /**
+     * The same items over the period right before the window, in the same order, points aligned by index with `data` (the last bucket may be missing when weeks split differently); null unless compare=true.
+     */
+    previous: Array<{
+        /**
+         * Platform name, keyword id, "total" for the unsplit series, or "other" for the keys beyond the top 20.
+         */
+        key: string;
+        /**
+         * Readable name: the platform, the keyword term, "Total" or "Other".
+         */
+        label: string;
+        /**
+         * Set when split by keyword; null otherwise.
+         */
+        keyword: {
+            /**
+             * Keyword id (kw_...).
+             */
+            id: string;
+            /**
+             * The tracked term.
+             */
+            term: string;
+            /**
+             * brand, competitor or topic.
+             */
+            kind: 'brand' | 'competitor' | 'topic';
+        } | null;
+        /**
+         * One point per bucket across the window, oldest first, zero-filled.
+         */
+        points: Array<{
+            /**
+             * The day, or the Monday of the week.
+             */
+            date: string;
+            /**
+             * Every match published in the bucket.
+             */
+            matched: number;
+            /**
+             * Of those, scored at or above the relevance threshold.
+             */
+            relevant: number;
+            /**
+             * Classified positive.
+             */
+            positive: number;
+            /**
+             * Classified neutral.
+             */
+            neutral: number;
+            /**
+             * Classified negative.
+             */
+            negative: number;
+            /**
+             * Not scored: still queued, or the classifier failed on it.
+             */
+            unclassified: number;
+        }>;
+    }> | null;
+};
+type AnalyticsBreakdown = {
+    /**
+     * The window the report covers.
+     */
+    window: {
+        /**
+         * First day, inclusive.
+         */
+        from: string;
+        /**
+         * Last day, inclusive.
+         */
+        to: string;
+        /**
+         * Length of the window in days.
+         */
+        days: number;
+        /**
+         * IANA zone the days were cut in.
+         */
+        timezone: string;
+    };
+    /**
+     * The dimension the rows are grouped by.
+     */
+    by: 'platform' | 'keyword' | 'sentiment' | 'intent' | 'status' | 'hour' | 'person';
+    /**
+     * Most matched first, at most 50 groups. by=hour is chronological and unlimited (168 cells at most).
+     */
+    data: Array<{
+        /**
+         * The group: platform name, keyword id, sentiment, intent, status, "weekday-hour" for by=hour, or an opaque person key.
+         */
+        key: string;
+        /**
+         * Readable name: the keyword term, the person name, otherwise the key.
+         */
+        label: string;
+        /**
+         * by=keyword only; null otherwise.
+         */
+        keyword: {
+            /**
+             * Keyword id (kw_...).
+             */
+            id: string;
+            /**
+             * The tracked term.
+             */
+            term: string;
+            /**
+             * brand, competitor or topic.
+             */
+            kind: 'brand' | 'competitor' | 'topic';
+        } | null;
+        /**
+         * by=person only; null otherwise.
+         */
+        person: {
+            /**
+             * Person id (aut_...); null for posts ingested before people were linked.
+             */
+            id: string | null;
+            /**
+             * Display name as the platform shows it.
+             */
+            name: string | null;
+            /**
+             * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin.
+             */
+            platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin';
+            /**
+             * Profile URL.
+             */
+            url: string | null;
+            /**
+             * Avatar image URL, when the platform gave one.
+             */
+            avatarUrl: string | null;
+            /**
+             * From the audience profile; null when unknown.
+             */
+            followers: number | null;
+        } | null;
+        /**
+         * by=hour only: the weekday and hour of day in `timezone`; null otherwise.
+         */
+        slot: {
+            /**
+             * 0 = Sunday through 6 = Saturday.
+             */
+            weekday: number;
+            /**
+             * Hour of day, 0 to 23.
+             */
+            hour: number;
+        } | null;
+        /**
+         * Matches in the group.
+         */
+        matched: number;
+        /**
+         * Of those, scored at or above the relevance threshold.
+         */
+        relevant: number;
+        /**
+         * Percent of the window's matched mentions in this group, one decimal. Intents overlap, so their shares can add up past 100.
+         */
+        share: number;
+        /**
+         * Matched mentions by classifier sentiment.
+         */
+        sentiment: {
+            /**
+             * Classified positive.
+             */
+            positive: number;
+            /**
+             * Classified neutral.
+             */
+            neutral: number;
+            /**
+             * Classified negative.
+             */
+            negative: number;
+            /**
+             * Not scored: still queued, or the classifier failed on it.
+             */
+            unclassified: number;
+        };
+        /**
+         * The same group over the period right before the window; null unless compare=true.
+         */
+        previous: {
+            /**
+             * Matches in the group then.
+             */
+            matched: number;
+            /**
+             * Relevant matches in the group then.
+             */
+            relevant: number;
+        } | null;
+    }>;
+};
+type ShareOfVoice = {
+    /**
+     * The window the report covers.
+     */
+    window: {
+        /**
+         * First day, inclusive.
+         */
+        from: string;
+        /**
+         * Last day, inclusive.
+         */
+        to: string;
+        /**
+         * Length of the window in days.
+         */
+        days: number;
+        /**
+         * IANA zone the days were cut in.
+         */
+        timezone: string;
+    };
+    /**
+     * Every keyword matched in the window, most matched first.
+     */
+    data: Array<{
+        /**
+         * The keyword this row is about.
+         */
+        keyword: {
+            /**
+             * Keyword id (kw_...).
+             */
+            id: string;
+            /**
+             * The tracked term.
+             */
+            term: string;
+            /**
+             * brand, competitor or topic.
+             */
+            kind: 'brand' | 'competitor' | 'topic';
+        };
+        /**
+         * Matches of this keyword in the window.
+         */
+        matched: number;
+        /**
+         * Of those, scored at or above the relevance threshold.
+         */
+        relevant: number;
+        /**
+         * Of those, classified negative.
+         */
+        negative: number;
+        /**
+         * Of those, carrying the buy_intent intent.
+         */
+        buyIntent: number;
+        /**
+         * Percent of brand plus competitor matches, one decimal; null for topics, which stay out of the split.
+         */
+        share: number | null;
+        /**
+         * The same keyword over the period right before the window; null unless compare=true.
+         */
+        previous: {
+            /**
+             * Matches of this keyword then.
+             */
+            matched: number;
+        } | null;
+    }>;
+};
+type Channel = {
+    /**
+     * Channel id (dest_...).
+     */
+    id: string;
+    label: string;
+    /**
+     * Computed over this workspace's deliveries.
+     */
+    stats: {
+        /**
+         * Alerts sending to this channel.
+         */
+        alerts: number;
+        /**
+         * Of those, enabled ones; 0 means the channel receives nothing right now.
+         */
+        activeAlerts: number;
+        /**
+         * Newest delivery attempt, successful or not.
+         */
+        lastDeliveryAt: string | null;
+        /**
+         * Deliveries in the last 7 days.
+         */
+        last7d: {
+            total: number;
+            failed: number;
+        };
+    };
+    /**
+     * ISO 8601 timestamp, UTC.
+     */
+    createdAt: string;
+    kind: 'slack';
+    config: {
+        channelId: string;
+        channelName: string;
+    };
+} | {
+    /**
+     * Channel id (dest_...).
+     */
+    id: string;
+    label: string;
+    /**
+     * Computed over this workspace's deliveries.
+     */
+    stats: {
+        /**
+         * Alerts sending to this channel.
+         */
+        alerts: number;
+        /**
+         * Of those, enabled ones; 0 means the channel receives nothing right now.
+         */
+        activeAlerts: number;
+        /**
+         * Newest delivery attempt, successful or not.
+         */
+        lastDeliveryAt: string | null;
+        /**
+         * Deliveries in the last 7 days.
+         */
+        last7d: {
+            total: number;
+            failed: number;
+        };
+    };
+    /**
+     * ISO 8601 timestamp, UTC.
+     */
+    createdAt: string;
+    kind: 'email';
+    config: {
+        recipients: Array<{
+            email: string;
+            /**
+             * Null until the address confirmed through its link; unconfirmed addresses receive nothing.
+             */
+            confirmedAt: string | null;
+        }>;
+    };
+} | {
+    /**
+     * Channel id (dest_...).
+     */
+    id: string;
+    label: string;
+    /**
+     * Computed over this workspace's deliveries.
+     */
+    stats: {
+        /**
+         * Alerts sending to this channel.
+         */
+        alerts: number;
+        /**
+         * Of those, enabled ones; 0 means the channel receives nothing right now.
+         */
+        activeAlerts: number;
+        /**
+         * Newest delivery attempt, successful or not.
+         */
+        lastDeliveryAt: string | null;
+        /**
+         * Deliveries in the last 7 days.
+         */
+        last7d: {
+            total: number;
+            failed: number;
+        };
+    };
+    /**
+     * ISO 8601 timestamp, UTC.
+     */
+    createdAt: string;
+    kind: 'webhook';
+    config: {
+        url: string;
+        /**
+         * Extra request headers you configured.
+         */
+        headers: {
+            [key: string]: string;
+        };
+        /**
+         * Only on creation and rotation. Signs every body: X-Mentions-Signature is the hex HMAC-SHA256 of the raw bytes.
+         */
+        secret?: string;
+    };
+} | {
+    /**
+     * Channel id (dest_...).
+     */
+    id: string;
+    label: string;
+    /**
+     * Computed over this workspace's deliveries.
+     */
+    stats: {
+        /**
+         * Alerts sending to this channel.
+         */
+        alerts: number;
+        /**
+         * Of those, enabled ones; 0 means the channel receives nothing right now.
+         */
+        activeAlerts: number;
+        /**
+         * Newest delivery attempt, successful or not.
+         */
+        lastDeliveryAt: string | null;
+        /**
+         * Deliveries in the last 7 days.
+         */
+        last7d: {
+            total: number;
+            failed: number;
+        };
+    };
+    /**
+     * ISO 8601 timestamp, UTC.
+     */
+    createdAt: string;
+    kind: 'telegram';
+    config: {
+        chatId: string;
+        chatType: 'private' | 'group' | 'supergroup' | 'channel';
+    };
+};
+type GetHealthData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/health';
+};
+type GetHealthResponses = {
+    /**
+     * API is up
+     */
+    200: {
+        ok: boolean;
+    };
+};
+type GetHealthResponse = GetHealthResponses[keyof GetHealthResponses];
+type ListKeywordsData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/keywords';
+};
+type ListKeywordsErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+type ListKeywordsError = ListKeywordsErrors[keyof ListKeywordsErrors];
+type ListKeywordsResponses = {
+    /**
+     * All keywords
+     */
+    200: {
+        data: Array<{
+            /**
+             * Keyword id (kw_...).
+             */
+            id: string;
+            term: string;
+            kind: 'brand' | 'competitor' | 'topic';
+            muted: boolean;
+            /**
+             * Platforms this keyword is tracked on; null means every platform.
+             */
+            platforms: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin'> | null;
+            /**
+             * Computed over this workspace's matches.
+             */
+            stats: {
+                /**
+                 * Every match ever, relevant or not: the number billing counts.
+                 */
+                mentions: number;
+                /**
+                 * Matches scored at or above the relevance threshold.
+                 */
+                relevant: number;
+                /**
+                 * Matches published in the last 7 days.
+                 */
+                last7d: number;
+                /**
+                 * Newest matched post; null until the first one.
+                 */
+                lastMentionAt: string | null;
+            };
+            /**
+             * Poll health per platform polled on a schedule. Live feeds (Bluesky) have no entry.
+             */
+            polling: Array<{
+                /**
+                 * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin.
+                 */
+                platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin';
+                /**
+                 * Newest poll of this platform for the term; null until the first one.
+                 */
+                lastPolledAt: string | null;
+                /**
+                 * Consecutive polls that found nothing new; the scheduler slows down as it grows.
+                 */
+                emptyPolls: number;
+            }>;
+            /**
+             * ISO 8601 timestamp, UTC.
+             */
+            createdAt: string;
+        }>;
+    };
+};
+type ListKeywordsResponse = ListKeywordsResponses[keyof ListKeywordsResponses];
+type CreateKeywordData = {
+    body: {
+        /**
+         * The word or phrase to track, matched case-insensitively as a phrase.
+         */
+        term: string;
+        /**
+         * brand: your own names. competitor: theirs. topic: the space. Drives share of voice and segments.
+         */
+        kind?: 'brand' | 'competitor' | 'topic';
+        /**
+         * Platforms to track it on; omit or null for every platform.
+         */
+        platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin'> | null;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/keywords';
+};
+type CreateKeywordErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Keyword limit reached for the current plan
+     */
+    402: ErrorResponse;
+    /**
+     * A keyword with the same normalized term already exists
+     */
+    409: ErrorResponse;
+};
+type CreateKeywordError = CreateKeywordErrors[keyof CreateKeywordErrors];
+type CreateKeywordResponses = {
+    /**
+     * The created keyword
+     */
+    201: Keyword;
+};
+type CreateKeywordResponse = CreateKeywordResponses[keyof CreateKeywordResponses];
+type DeleteKeywordData = {
+    body?: never;
+    path: {
+        /**
+         * Keyword id (kw_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/keywords/{id}';
+};
+type DeleteKeywordErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Keyword not found
+     */
+    404: ErrorResponse;
+};
+type DeleteKeywordError = DeleteKeywordErrors[keyof DeleteKeywordErrors];
+type DeleteKeywordResponses = {
+    /**
+     * Deleted
+     */
+    204: void;
+};
+type DeleteKeywordResponse = DeleteKeywordResponses[keyof DeleteKeywordResponses];
+type GetKeywordData = {
+    body?: never;
+    path: {
+        /**
+         * Keyword id (kw_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/keywords/{id}';
+};
+type GetKeywordErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Keyword not found
+     */
+    404: ErrorResponse;
+};
+type GetKeywordError = GetKeywordErrors[keyof GetKeywordErrors];
+type GetKeywordResponses = {
+    /**
+     * The keyword
+     */
+    200: Keyword;
+};
+type GetKeywordResponse = GetKeywordResponses[keyof GetKeywordResponses];
+type UpdateKeywordData = {
+    /**
+     * Omitted fields are untouched.
+     */
+    body: {
+        /**
+         * A muted keyword stops polling and matching; its mentions stay.
+         */
+        muted?: boolean;
+        /**
+         * Replaces the platform list; null means every platform.
+         */
+        platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin'> | null;
+    };
+    path: {
+        /**
+         * Keyword id (kw_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/keywords/{id}';
+};
+type UpdateKeywordErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Unmuting would exceed the keyword limit for the current plan
+     */
+    402: ErrorResponse;
+    /**
+     * Keyword not found
+     */
+    404: ErrorResponse;
+};
+type UpdateKeywordError = UpdateKeywordErrors[keyof UpdateKeywordErrors];
+type UpdateKeywordResponses = {
+    /**
+     * The updated keyword
+     */
+    200: Keyword;
+};
+type UpdateKeywordResponse = UpdateKeywordResponses[keyof UpdateKeywordResponses];
+type GetMentionData = {
+    body?: never;
+    path: {
+        /**
+         * Mention id (mm_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/mentions/{id}';
+};
+type GetMentionErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Mention not found
+     */
+    404: ErrorResponse;
+};
+type GetMentionError = GetMentionErrors[keyof GetMentionErrors];
+type GetMentionResponses = {
+    /**
+     * The mention
+     */
+    200: Mention;
+};
+type GetMentionResponse = GetMentionResponses[keyof GetMentionResponses];
+type UpdateMentionData = {
+    /**
+     * Every field is optional; omitted fields are untouched.
+     */
+    body: {
+        /**
+         * ignored or done to handle it; open to put it back.
+         */
+        status?: 'open' | 'ignored' | 'done';
+        /**
+         * A workspace member (user id), or null to unassign.
+         */
+        assigneeId?: string | null;
+        /**
+         * ISO 8601 (or epoch ms) until which the mention leaves the feed; null wakes it.
+         */
+        snoozedUntil?: number | null;
+        /**
+         * Internal note; null or empty clears it.
+         */
+        note?: string | null;
+    };
+    path: {
+        /**
+         * Mention id (mm_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/mentions/{id}';
+};
+type UpdateMentionErrors = {
+    /**
+     * Assignee is not a member of this organization
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Mention not found
+     */
+    404: ErrorResponse;
+};
+type UpdateMentionError = UpdateMentionErrors[keyof UpdateMentionErrors];
+type UpdateMentionResponses = {
+    /**
+     * The updated mention
+     */
+    200: Mention;
+};
+type UpdateMentionResponse = UpdateMentionResponses[keyof UpdateMentionResponses];
+type SearchMentionsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Only matches of this keyword.
+         */
+        keywordId?: string;
+        /**
+         * Only posts from this platform.
+         */
+        platform?: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin';
+        /**
+         * Only mentions in this status. Omit for every status.
+         */
+        status?: 'open' | 'ignored' | 'done';
+        /**
+         * true: only mentions the classifier scored relevant; false: only the rest (unclassified included).
+         */
+        relevant?: boolean;
+        /**
+         * Only this sentiment.
+         */
+        sentiment?: 'positive' | 'neutral' | 'negative';
+        /**
+         * Only mentions carrying this intent (buy_intent, question, complaint, praise, comparison).
+         */
+        intent?: string;
+        /**
+         * Only this person (an id from /v1/people), merged accounts included. Implies includeMuted.
+         */
+        personId?: string;
+        /**
+         * true: include mentions by people you muted, hidden by default.
+         */
+        includeMuted?: boolean;
+        /**
+         * Only mentions assigned to this workspace member (user id).
+         */
+        assigneeId?: string;
+        /**
+         * true: only mentions currently snoozed. Otherwise snoozed mentions stay out until they wake.
+         */
+        snoozed?: boolean;
+        /**
+         * Hide these authors: display names, handles or profile URLs. Repeatable, or one comma-separated value.
+         */
+        excludeAuthors?: Array<string> | null;
+        /**
+         * Only mentions scored at least this; unclassified ones are excluded.
+         */
+        minRelevance?: number | null;
+        /**
+         * Only authors with at least this many followers. Unknown reach never passes.
+         */
+        minFollowers?: number | null;
+        /**
+         * Only authors your workspace tagged with any of these (exact, case-sensitive). Repeatable, or comma-separated.
+         */
+        tags?: Array<string> | null;
+        /**
+         * Substring search in the post text.
+         */
+        q?: string;
+        /**
+         * Only posts published at or after this instant (ISO 8601, or epoch ms).
+         */
+        since?: number;
+        /**
+         * Only posts published at or before this instant (ISO 8601, or epoch ms).
+         */
+        until?: number;
+        /**
+         * newest: by match time, newest first. priority: by attention score, highest first. Cursors are specific to a sort.
+         */
+        sort?: 'newest' | 'priority';
+        /**
+         * nextCursor from the previous page; pass the same filters and sort.
+         */
+        cursor?: string;
+        /**
+         * Page size, 1 to 100.
+         */
+        limit?: number;
+    };
+    url: '/v1/mentions';
+};
+type SearchMentionsErrors = {
+    /**
+     * Invalid query or pagination cursor
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+type SearchMentionsError = SearchMentionsErrors[keyof SearchMentionsErrors];
+type SearchMentionsResponses = {
+    /**
+     * One page of mentions in the requested order
+     */
+    200: {
+        data: Array<Mention>;
+        /**
+         * Pass as cursor for the next page; null on the last page.
+         */
+        nextCursor: string | null;
+    };
+};
+type SearchMentionsResponse = SearchMentionsResponses[keyof SearchMentionsResponses];
+type ExportMentionsCsvData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Only matches of this keyword.
+         */
+        keywordId?: string;
+        /**
+         * Only posts from this platform.
+         */
+        platform?: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin';
+        /**
+         * Only mentions in this status. Omit for every status.
+         */
+        status?: 'open' | 'ignored' | 'done';
+        /**
+         * true: only mentions the classifier scored relevant; false: only the rest (unclassified included).
+         */
+        relevant?: boolean;
+        /**
+         * Only this sentiment.
+         */
+        sentiment?: 'positive' | 'neutral' | 'negative';
+        /**
+         * Only mentions carrying this intent (buy_intent, question, complaint, praise, comparison).
+         */
+        intent?: string;
+        /**
+         * Only this person (an id from /v1/people), merged accounts included. Implies includeMuted.
+         */
+        personId?: string;
+        /**
+         * true: include mentions by people you muted, hidden by default.
+         */
+        includeMuted?: boolean;
+        /**
+         * Only mentions assigned to this workspace member (user id).
+         */
+        assigneeId?: string;
+        /**
+         * true: only mentions currently snoozed. Otherwise snoozed mentions stay out until they wake.
+         */
+        snoozed?: boolean;
+        /**
+         * Hide these authors: display names, handles or profile URLs. Repeatable, or one comma-separated value.
+         */
+        excludeAuthors?: Array<string> | null;
+        /**
+         * Only mentions scored at least this; unclassified ones are excluded.
+         */
+        minRelevance?: number | null;
+        /**
+         * Only authors with at least this many followers. Unknown reach never passes.
+         */
+        minFollowers?: number | null;
+        /**
+         * Only authors your workspace tagged with any of these (exact, case-sensitive). Repeatable, or comma-separated.
+         */
+        tags?: Array<string> | null;
+        /**
+         * Substring search in the post text.
+         */
+        q?: string;
+        /**
+         * Only posts published at or after this instant (ISO 8601, or epoch ms).
+         */
+        since?: number;
+        /**
+         * Only posts published at or before this instant (ISO 8601, or epoch ms).
+         */
+        until?: number;
+    };
+    url: '/v1/mentions/export.csv';
+};
+type ExportMentionsCsvErrors = {
+    /**
+     * Invalid query
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+type ExportMentionsCsvError = ExportMentionsCsvErrors[keyof ExportMentionsCsvErrors];
+type ExportMentionsCsvResponses = {
+    /**
+     * CSV, UTF-8
+     */
+    200: string;
+};
+type ExportMentionsCsvResponse = ExportMentionsCsvResponses[keyof ExportMentionsCsvResponses];
+type ExportPeopleCsvData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * People with an account on this platform.
+         */
+        platform?: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin';
+        /**
+         * Matches the display name or the profile handle or URL, case-insensitively.
+         */
+        q?: string;
+        /**
+         * Only people carrying this tag (exact, case-sensitive).
+         */
+        tag?: string;
+        /**
+         * true: only muted people; false: only unmuted; omitted: everyone.
+         */
+        muted?: boolean;
+        /**
+         * Only people whose first matched mention is at or after this instant (ISO 8601, or epoch ms).
+         */
+        since?: number;
+        /**
+         * A saved segment applied on top of every other filter here. Unknown id: 404.
+         */
+        segmentId?: string;
+        /**
+         * People with an account on any of these platforms. Repeatable, or comma-separated.
+         */
+        platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin'>;
+        /**
+         * People carrying any of these tags. Repeatable, or comma-separated.
+         */
+        tags?: Array<string> | null;
+        /**
+         * At least this many followers. Unknown reach never matches.
+         */
+        minFollowers?: number | null;
+        /**
+         * At most this many followers.
+         */
+        maxFollowers?: number | null;
+        /**
+         * At least this many matched mentions.
+         */
+        minMentions?: number;
+        /**
+         * At least this many negative mentions.
+         */
+        minNegative?: number;
+        /**
+         * At least one mention carrying any of these intents.
+         */
+        intents?: Array<string> | null;
+        /**
+         * Mentioned a keyword of any of these kinds.
+         */
+        keywordKinds?: Array<'brand' | 'competitor' | 'topic'>;
+        /**
+         * Never mentioned a keyword of these kinds.
+         */
+        neverKeywordKinds?: Array<'brand' | 'competitor' | 'topic'>;
+        /**
+         * First seen within this many days.
+         */
+        newSinceDays?: number;
+        /**
+         * mentions: most matches first. recent: last seen first. reach: most followers first, unknown last. new: first seen most recently first.
+         */
+        sort?: 'mentions' | 'recent' | 'reach' | 'new';
+    };
+    url: '/v1/people/export.csv';
+};
+type ExportPeopleCsvErrors = {
+    /**
+     * Invalid query
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * No such segment for your workspace
+     */
+    404: ErrorResponse;
+};
+type ExportPeopleCsvError = ExportPeopleCsvErrors[keyof ExportPeopleCsvErrors];
+type ExportPeopleCsvResponses = {
+    /**
+     * CSV, UTF-8
+     */
+    200: string;
+};
+type ExportPeopleCsvResponse = ExportPeopleCsvResponses[keyof ExportPeopleCsvResponses];
+type ListPeopleData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * People with an account on this platform.
+         */
+        platform?: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin';
+        /**
+         * Matches the display name or the profile handle or URL, case-insensitively.
+         */
+        q?: string;
+        /**
+         * Only people carrying this tag (exact, case-sensitive).
+         */
+        tag?: string;
+        /**
+         * true: only muted people; false: only unmuted; omitted: everyone.
+         */
+        muted?: boolean;
+        /**
+         * Only people whose first matched mention is at or after this instant (ISO 8601, or epoch ms).
+         */
+        since?: number;
+        /**
+         * A saved segment applied on top of every other filter here. Unknown id: 404.
+         */
+        segmentId?: string;
+        /**
+         * People with an account on any of these platforms. Repeatable, or comma-separated.
+         */
+        platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin'>;
+        /**
+         * People carrying any of these tags. Repeatable, or comma-separated.
+         */
+        tags?: Array<string> | null;
+        /**
+         * At least this many followers. Unknown reach never matches.
+         */
+        minFollowers?: number | null;
+        /**
+         * At most this many followers.
+         */
+        maxFollowers?: number | null;
+        /**
+         * At least this many matched mentions.
+         */
+        minMentions?: number;
+        /**
+         * At least this many negative mentions.
+         */
+        minNegative?: number;
+        /**
+         * At least one mention carrying any of these intents.
+         */
+        intents?: Array<string> | null;
+        /**
+         * Mentioned a keyword of any of these kinds.
+         */
+        keywordKinds?: Array<'brand' | 'competitor' | 'topic'>;
+        /**
+         * Never mentioned a keyword of these kinds.
+         */
+        neverKeywordKinds?: Array<'brand' | 'competitor' | 'topic'>;
+        /**
+         * First seen within this many days.
+         */
+        newSinceDays?: number;
+        /**
+         * mentions: most matches first. recent: last seen first. reach: most followers first, unknown last. new: first seen most recently first.
+         */
+        sort?: 'mentions' | 'recent' | 'reach' | 'new';
+        /**
+         * Page size, 1 to 100.
+         */
+        limit?: number;
+        /**
+         * Skip this many people. Offset paging: a grouped read over hundreds of people, not a stream.
+         */
+        offset?: number | null;
+    };
+    url: '/v1/people';
+};
+type ListPeopleErrors = {
+    /**
+     * Invalid query
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * No such segment for your workspace
+     */
+    404: ErrorResponse;
+};
+type ListPeopleError = ListPeopleErrors[keyof ListPeopleErrors];
+type ListPeopleResponses = {
+    /**
+     * One page of people
+     */
+    200: {
+        data: Array<{
+            /**
+             * Person id (aut_...): the canonical account. An account merged into someone resolves to that person.
+             */
+            id: string;
+            /**
+             * Platform of the canonical account; `accounts` lists every account.
+             */
+            platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin';
+            /**
+             * Display name as of their newest post; null when the platform has none.
+             */
+            name: string | null;
+            /**
+             * Platform handle of the canonical account, formatted as the platform shows it.
+             */
+            handle: string | null;
+            /**
+             * Profile URL of the canonical account.
+             */
+            url: string | null;
+            avatarUrl: string | null;
+            /**
+             * Every account this workspace treats as this person, the canonical one first.
+             */
+            accounts: Array<{
+                /**
+                 * The account id (aut_...); the canonical one equals the person id.
+                 */
+                id: string;
+                /**
+                 * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin.
+                 */
+                platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin';
+                /**
+                 * Display name as the platform reports it.
+                 */
+                name: string | null;
+                /**
+                 * Platform handle derived from the profile URL, formatted as the platform shows it.
+                 */
+                handle: string | null;
+                /**
+                 * Profile URL.
+                 */
+                url: string | null;
+            }>;
+            /**
+             * Platform counts as of their newest post; null where the platform has no such number.
+             */
+            reach: {
+                followers: number | null;
+                following: number | null;
+                posts: number | null;
+            };
+            /**
+             * Public profile facts; null until looked up.
+             */
+            profile: {
+                bio: string | null;
+                company: string | null;
+                location: string | null;
+                website: string | null;
+                /**
+                 * Only when the person made it public on the platform.
+                 */
+                email: string | null;
+                /**
+                 * Other accounts the person lists on their profile.
+                 */
+                links: Array<{
+                    provider: string;
+                    url: string;
+                }>;
+                /**
+                 * When the profile was read.
+                 */
+                fetchedAt: string;
+            } | null;
+            /**
+             * Computed over this workspace's matches.
+             */
+            stats: {
+                /**
+                 * Every match of theirs for this workspace, relevant or not.
+                 */
+                mentions: number;
+                /**
+                 * Of those, scored relevant.
+                 */
+                relevant: number;
+                sentiment: {
+                    positive: number;
+                    neutral: number;
+                    negative: number;
+                };
+                /**
+                 * Their oldest matched post.
+                 */
+                firstSeenAt: string;
+                /**
+                 * Their newest matched post.
+                 */
+                lastSeenAt: string;
+            };
+            /**
+             * What this workspace wrote about the person.
+             */
+            annotations: {
+                tags: Array<string>;
+                notes: string;
+                /**
+                 * Their posts stay out of the feed and every channel; ingest and billing are untouched.
+                 */
+                muted: boolean;
+            };
+        }>;
+        /**
+         * People matching the filters, across all pages.
+         */
+        total: number;
+    };
+};
+type ListPeopleResponse = ListPeopleResponses[keyof ListPeopleResponses];
+type GetPersonData = {
+    body?: never;
+    path: {
+        /**
+         * Person id (aut_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/people/{id}';
+};
+type GetPersonErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * No mention by this person for your workspace
+     */
+    404: ErrorResponse;
+};
+type GetPersonError = GetPersonErrors[keyof GetPersonErrors];
+type GetPersonResponses = {
+    /**
+     * The person
+     */
+    200: Person;
+};
+type GetPersonResponse = GetPersonResponses[keyof GetPersonResponses];
+type UpdatePersonData = {
+    /**
+     * Omitted fields are untouched.
+     */
+    body: {
+        /**
+         * Replaces the whole list.
+         */
+        tags?: Array<string>;
+        notes?: string;
+        muted?: boolean;
+    };
+    path: {
+        /**
+         * Person id (aut_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/people/{id}';
+};
+type UpdatePersonErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * No mention by this person for your workspace
+     */
+    404: ErrorResponse;
+};
+type UpdatePersonError = UpdatePersonErrors[keyof UpdatePersonErrors];
+type UpdatePersonResponses = {
+    /**
+     * The updated person
+     */
+    200: Person;
+};
+type UpdatePersonResponse = UpdatePersonResponses[keyof UpdatePersonResponses];
+type MergePeopleData = {
+    body: {
+        /**
+         * The person to fold this account into (their id).
+         */
+        into: string;
+    };
+    path: {
+        /**
+         * Person id (aut_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/people/{id}/merge';
+};
+type MergePeopleErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Either side is unknown to your workspace
+     */
+    404: ErrorResponse;
+};
+type MergePeopleError = MergePeopleErrors[keyof MergePeopleErrors];
+type MergePeopleResponses = {
+    /**
+     * The person this account now belongs to
+     */
+    200: Person;
+};
+type MergePeopleResponse = MergePeopleResponses[keyof MergePeopleResponses];
+type SplitPersonData = {
+    body?: never;
+    path: {
+        /**
+         * Person id (aut_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/people/{id}/split';
+};
+type SplitPersonErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * This account was not merged into anyone
+     */
+    404: ErrorResponse;
+};
+type SplitPersonError = SplitPersonErrors[keyof SplitPersonErrors];
+type SplitPersonResponses = {
+    /**
+     * The account, as its own person
+     */
+    200: Person;
+};
+type SplitPersonResponse = SplitPersonResponses[keyof SplitPersonResponses];
+type ListSegmentsData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/segments';
+};
+type ListSegmentsErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+type ListSegmentsError = ListSegmentsErrors[keyof ListSegmentsErrors];
+type ListSegmentsResponses = {
+    /**
+     * Every segment, with presets
+     */
+    200: {
+        data: Array<{
+            /**
+             * Segment id (seg_...).
+             */
+            id: string;
+            name: string;
+            description: string;
+            filter: {
+                /**
+                 * People with an account on any of these platforms.
+                 */
+                platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin'>;
+                /**
+                 * People carrying any of these tags.
+                 */
+                tags?: Array<string>;
+                /**
+                 * At least this many followers. Unknown reach never matches.
+                 */
+                minFollowers?: number;
+                /**
+                 * At most this many followers. Unknown reach never matches.
+                 */
+                maxFollowers?: number;
+                /**
+                 * At least this many matched mentions.
+                 */
+                minMentions?: number;
+                /**
+                 * At least this many negative mentions.
+                 */
+                minNegative?: number;
+                /**
+                 * At least one mention carrying any of these intents.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Mentioned a keyword of any of these kinds.
+                 */
+                keywordKinds?: Array<'brand' | 'competitor' | 'topic'>;
+                /**
+                 * Never mentioned a keyword of these kinds.
+                 */
+                neverKeywordKinds?: Array<'brand' | 'competitor' | 'topic'>;
+                /**
+                 * First seen within this many days.
+                 */
+                newSinceDays?: number;
+                /**
+                 * true: only muted people; false: only unmuted.
+                 */
+                muted?: boolean;
+            };
+            /**
+             * People in the segment right now; it is evaluated on every read.
+             */
+            count: number;
+            /**
+             * ISO 8601 timestamp, UTC.
+             */
+            createdAt: string;
+            /**
+             * ISO 8601 timestamp, UTC.
+             */
+            updatedAt: string;
+        }>;
+        /**
+         * Starting points you can save with POST /v1/segments.
+         */
+        presets: Array<{
+            key: string;
+            name: string;
+            description: string;
+            filter: {
+                /**
+                 * People with an account on any of these platforms.
+                 */
+                platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin'>;
+                /**
+                 * People carrying any of these tags.
+                 */
+                tags?: Array<string>;
+                /**
+                 * At least this many followers. Unknown reach never matches.
+                 */
+                minFollowers?: number;
+                /**
+                 * At most this many followers. Unknown reach never matches.
+                 */
+                maxFollowers?: number;
+                /**
+                 * At least this many matched mentions.
+                 */
+                minMentions?: number;
+                /**
+                 * At least this many negative mentions.
+                 */
+                minNegative?: number;
+                /**
+                 * At least one mention carrying any of these intents.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Mentioned a keyword of any of these kinds.
+                 */
+                keywordKinds?: Array<'brand' | 'competitor' | 'topic'>;
+                /**
+                 * Never mentioned a keyword of these kinds.
+                 */
+                neverKeywordKinds?: Array<'brand' | 'competitor' | 'topic'>;
+                /**
+                 * First seen within this many days.
+                 */
+                newSinceDays?: number;
+                /**
+                 * true: only muted people; false: only unmuted.
+                 */
+                muted?: boolean;
+            };
+        }>;
+    };
+};
+type ListSegmentsResponse = ListSegmentsResponses[keyof ListSegmentsResponses];
+type CreateSegmentData = {
+    body: {
+        name: string;
+        description?: string;
+        filter?: {
+            /**
+             * People with an account on any of these platforms.
+             */
+            platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin'>;
+            /**
+             * People carrying any of these tags.
+             */
+            tags?: Array<string>;
+            /**
+             * At least this many followers. Unknown reach never matches.
+             */
+            minFollowers?: number;
+            /**
+             * At most this many followers. Unknown reach never matches.
+             */
+            maxFollowers?: number;
+            /**
+             * At least this many matched mentions.
+             */
+            minMentions?: number;
+            /**
+             * At least this many negative mentions.
+             */
+            minNegative?: number;
+            /**
+             * At least one mention carrying any of these intents.
+             */
+            intents?: Array<string>;
+            /**
+             * Mentioned a keyword of any of these kinds.
+             */
+            keywordKinds?: Array<'brand' | 'competitor' | 'topic'>;
+            /**
+             * Never mentioned a keyword of these kinds.
+             */
+            neverKeywordKinds?: Array<'brand' | 'competitor' | 'topic'>;
+            /**
+             * First seen within this many days.
+             */
+            newSinceDays?: number;
+            /**
+             * true: only muted people; false: only unmuted.
+             */
+            muted?: boolean;
+        };
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/segments';
+};
+type CreateSegmentErrors = {
+    /**
+     * Invalid body
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * A segment with this name already exists
+     */
+    409: ErrorResponse;
+};
+type CreateSegmentError = CreateSegmentErrors[keyof CreateSegmentErrors];
+type CreateSegmentResponses = {
+    /**
+     * The saved segment, with its current size
+     */
+    201: Segment;
+};
+type CreateSegmentResponse = CreateSegmentResponses[keyof CreateSegmentResponses];
+type DeleteSegmentData = {
+    body?: never;
+    path: {
+        /**
+         * Segment id (seg_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/segments/{id}';
+};
+type DeleteSegmentErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * No such segment for your workspace
+     */
+    404: ErrorResponse;
+};
+type DeleteSegmentError = DeleteSegmentErrors[keyof DeleteSegmentErrors];
+type DeleteSegmentResponses = {
+    /**
+     * Deleted
+     */
+    204: void;
+};
+type DeleteSegmentResponse = DeleteSegmentResponses[keyof DeleteSegmentResponses];
+type GetSegmentData = {
+    body?: never;
+    path: {
+        /**
+         * Segment id (seg_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/segments/{id}';
+};
+type GetSegmentErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * No such segment for your workspace
+     */
+    404: ErrorResponse;
+};
+type GetSegmentError = GetSegmentErrors[keyof GetSegmentErrors];
+type GetSegmentResponses = {
+    /**
+     * One segment, with its current size
+     */
+    200: Segment;
+};
+type GetSegmentResponse = GetSegmentResponses[keyof GetSegmentResponses];
+type UpdateSegmentData = {
+    /**
+     * Omitted fields are untouched.
+     */
+    body: {
+        name?: string;
+        description?: string;
+        /**
+         * Replaces the whole filter.
+         */
+        filter?: {
+            /**
+             * People with an account on any of these platforms.
+             */
+            platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin'>;
+            /**
+             * People carrying any of these tags.
+             */
+            tags?: Array<string>;
+            /**
+             * At least this many followers. Unknown reach never matches.
+             */
+            minFollowers?: number;
+            /**
+             * At most this many followers. Unknown reach never matches.
+             */
+            maxFollowers?: number;
+            /**
+             * At least this many matched mentions.
+             */
+            minMentions?: number;
+            /**
+             * At least this many negative mentions.
+             */
+            minNegative?: number;
+            /**
+             * At least one mention carrying any of these intents.
+             */
+            intents?: Array<string>;
+            /**
+             * Mentioned a keyword of any of these kinds.
+             */
+            keywordKinds?: Array<'brand' | 'competitor' | 'topic'>;
+            /**
+             * Never mentioned a keyword of these kinds.
+             */
+            neverKeywordKinds?: Array<'brand' | 'competitor' | 'topic'>;
+            /**
+             * First seen within this many days.
+             */
+            newSinceDays?: number;
+            /**
+             * true: only muted people; false: only unmuted.
+             */
+            muted?: boolean;
+        };
+    };
+    path: {
+        /**
+         * Segment id (seg_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/segments/{id}';
+};
+type UpdateSegmentErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * No such segment for your workspace
+     */
+    404: ErrorResponse;
+    /**
+     * A segment with this name already exists
+     */
+    409: ErrorResponse;
+};
+type UpdateSegmentError = UpdateSegmentErrors[keyof UpdateSegmentErrors];
+type UpdateSegmentResponses = {
+    /**
+     * The updated segment
+     */
+    200: Segment;
+};
+type UpdateSegmentResponse = UpdateSegmentResponses[keyof UpdateSegmentResponses];
+type GetCompanyData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/company';
+};
+type GetCompanyErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Workspace not found
+     */
+    404: ErrorResponse;
+};
+type GetCompanyError = GetCompanyErrors[keyof GetCompanyErrors];
+type GetCompanyResponses = {
+    /**
+     * The company profile
+     */
+    200: Company;
+};
+type GetCompanyResponse = GetCompanyResponses[keyof GetCompanyResponses];
+type UpdateCompanyData = {
+    /**
+     * Omitted fields are untouched.
+     */
+    body: {
+        name?: string;
+        description?: string;
+        /**
+         * Replaces the whole list.
+         */
+        useCases?: Array<string>;
+        accounts?: {
+            x?: string | null;
+            linkedin?: string | null;
+        };
+        /**
+         * Overrides the composed context until the next profile edit.
+         */
+        context?: string;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/company';
+};
+type UpdateCompanyErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Workspace not found
+     */
+    404: ErrorResponse;
+};
+type UpdateCompanyError = UpdateCompanyErrors[keyof UpdateCompanyErrors];
+type UpdateCompanyResponses = {
+    /**
+     * The updated profile
+     */
+    200: Company;
+};
+type UpdateCompanyResponse = UpdateCompanyResponses[keyof UpdateCompanyResponses];
+type ListApiKeysData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/api-keys';
+};
+type ListApiKeysErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+type ListApiKeysError = ListApiKeysErrors[keyof ListApiKeysErrors];
+type ListApiKeysResponses = {
+    /**
+     * Every key, newest first, without the secret part
+     */
+    200: {
+        data: Array<{
+            /**
+             * Key id (key_...).
+             */
+            id: string;
+            name: string;
+            /**
+             * The first characters of the key, to tell keys apart.
+             */
+            prefix: string;
+            /**
+             * read: GET only. write: everything.
+             */
+            scope: 'read' | 'write';
+            /**
+             * ISO 8601 timestamp, UTC.
+             */
+            createdAt: string;
+            /**
+             * ISO 8601 timestamp, UTC.
+             */
+            lastUsedAt: string | null;
+        }>;
+    };
+};
+type ListApiKeysResponse = ListApiKeysResponses[keyof ListApiKeysResponses];
+type CreateApiKeyData = {
+    body: {
+        /**
+         * A label for the key; "default" when omitted.
+         */
+        name?: string;
+        /**
+         * read: GET only. write: everything.
+         */
+        scope?: 'read' | 'write';
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/api-keys';
+};
+type CreateApiKeyErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+type CreateApiKeyError = CreateApiKeyErrors[keyof CreateApiKeyErrors];
+type CreateApiKeyResponses = {
+    /**
+     * The new key, shown once
+     */
+    201: {
+        /**
+         * Key id (key_...).
+         */
+        id: string;
+        name: string;
+        /**
+         * The first characters of the key, to tell keys apart.
+         */
+        prefix: string;
+        /**
+         * read: GET only. write: everything.
+         */
+        scope: 'read' | 'write';
+        /**
+         * ISO 8601 timestamp, UTC.
+         */
+        createdAt: string;
+        /**
+         * ISO 8601 timestamp, UTC.
+         */
+        lastUsedAt: string | null;
+        /**
+         * The full key. Shown once; store it now.
+         */
+        key: string;
+    };
+};
+type CreateApiKeyResponse = CreateApiKeyResponses[keyof CreateApiKeyResponses];
+type RevokeApiKeyData = {
+    body?: never;
+    path: {
+        /**
+         * API key id (key_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/api-keys/{id}';
+};
+type RevokeApiKeyErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * API key not found
+     */
+    404: ErrorResponse;
+};
+type RevokeApiKeyError = RevokeApiKeyErrors[keyof RevokeApiKeyErrors];
+type RevokeApiKeyResponses = {
+    /**
+     * Revoked
+     */
+    204: void;
+};
+type RevokeApiKeyResponse = RevokeApiKeyResponses[keyof RevokeApiKeyResponses];
+type DeleteAlertData = {
+    body?: never;
+    path: {
+        /**
+         * Alert id (feed_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/alerts/{id}';
+};
+type DeleteAlertErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Rule not found
+     */
+    404: ErrorResponse;
+};
+type DeleteAlertError = DeleteAlertErrors[keyof DeleteAlertErrors];
+type DeleteAlertResponses = {
+    /**
+     * Deleted
+     */
+    204: void;
+};
+type DeleteAlertResponse = DeleteAlertResponses[keyof DeleteAlertResponses];
+type GetAlertData = {
+    body?: never;
+    path: {
+        /**
+         * Alert id (feed_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/alerts/{id}';
+};
+type GetAlertErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Alert not found
+     */
+    404: ErrorResponse;
+};
+type GetAlertError = GetAlertErrors[keyof GetAlertErrors];
+type GetAlertResponses = {
+    /**
+     * The alert
+     */
+    200: Alert;
+};
+type GetAlertResponse = GetAlertResponses[keyof GetAlertResponses];
+type UpdateAlertData = {
+    /**
+     * Omitted fields are untouched.
+     */
+    body: {
+        name?: string;
+        enabled?: boolean;
+        mode?: 'instant' | 'daily';
+        /**
+         * Replaces the whole filter.
+         */
+        filter?: {
+            /**
+             * Only these keywords.
+             */
+            keywordIds?: Array<string>;
+            /**
+             * Only posts from these platforms.
+             */
+            platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin'>;
+            /**
+             * Only mentions scored at least this; unclassified ones never pass.
+             */
+            minRelevance?: number;
+            /**
+             * Only these sentiments.
+             */
+            sentiments?: Array<'positive' | 'neutral' | 'negative'>;
+            /**
+             * At least one of these intents.
+             */
+            intents?: Array<string>;
+            /**
+             * Never these authors: display names, handles or profile URLs.
+             */
+            excludeAuthors?: Array<string>;
+            /**
+             * Only authors with at least this many followers. Unknown reach never passes.
+             */
+            minFollowers?: number;
+            /**
+             * Only authors your workspace tagged with any of these.
+             */
+            tags?: Array<string>;
+        };
+        schedule?: {
+            hour: number;
+            minute?: number;
+            timezone: string;
+            skipEmpty?: boolean;
+        } | null;
+        event?: string | null;
+        /**
+         * Replaces the whole list.
+         */
+        channelIds?: Array<string>;
+    };
+    path: {
+        /**
+         * Alert id (feed_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/alerts/{id}';
+};
+type UpdateAlertErrors = {
+    /**
+     * A daily rule without a schedule, or an unknown channel
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Rule not found
+     */
+    404: ErrorResponse;
+};
+type UpdateAlertError = UpdateAlertErrors[keyof UpdateAlertErrors];
+type UpdateAlertResponses = {
+    /**
+     * The updated rule
+     */
+    200: Alert;
+};
+type UpdateAlertResponse = UpdateAlertResponses[keyof UpdateAlertResponses];
+type ListAlertsData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/alerts';
+};
+type ListAlertsErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+type ListAlertsError = ListAlertsErrors[keyof ListAlertsErrors];
+type ListAlertsResponses = {
+    /**
+     * Every alert rule of the org, newest first
+     */
+    200: {
+        data: Array<{
+            /**
+             * Alert id (feed_...).
+             */
+            id: string;
+            name: string;
+            enabled: boolean;
+            /**
+             * instant: each matching mention as it happens. daily: one digest at the scheduled local time.
+             */
+            mode: 'instant' | 'daily';
+            filter: {
+                /**
+                 * Only these keywords.
+                 */
+                keywordIds?: Array<string>;
+                /**
+                 * Only posts from these platforms.
+                 */
+                platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin'>;
+                /**
+                 * Only mentions scored at least this; unclassified ones never pass.
+                 */
+                minRelevance?: number;
+                /**
+                 * Only these sentiments.
+                 */
+                sentiments?: Array<'positive' | 'neutral' | 'negative'>;
+                /**
+                 * At least one of these intents.
+                 */
+                intents?: Array<string>;
+                /**
+                 * Never these authors: display names, handles or profile URLs.
+                 */
+                excludeAuthors?: Array<string>;
+                /**
+                 * Only authors with at least this many followers. Unknown reach never passes.
+                 */
+                minFollowers?: number;
+                /**
+                 * Only authors your workspace tagged with any of these.
+                 */
+                tags?: Array<string>;
+            };
+            /**
+             * Daily alerts only.
+             */
+            schedule: {
+                hour: number;
+                minute?: number;
+                timezone: string;
+                skipEmpty?: boolean;
+            } | null;
+            /**
+             * Event name carried in webhook payloads; the mode default unless you set one.
+             */
+            event: string;
+            /**
+             * Where it sends.
+             */
+            channels: Array<{
+                id: string;
+                kind: 'slack' | 'email' | 'webhook' | 'telegram';
+                label: string;
+            }>;
+            /**
+             * Computed over this workspace's deliveries.
+             */
+            stats: {
+                /**
+                 * Deliveries in the last 7 days, across channels.
+                 */
+                sentLast7d: number;
+                /**
+                 * ISO 8601 timestamp, UTC.
+                 */
+                lastSentAt: string | null;
+                /**
+                 * Daily alerts: the next digest; null when disabled or instant.
+                 */
+                nextRunAt: string | null;
+            };
+            /**
+             * ISO 8601 timestamp, UTC.
+             */
+            createdAt: string;
+        }>;
+    };
+};
+type ListAlertsResponse = ListAlertsResponses[keyof ListAlertsResponses];
+type CreateAlertData = {
+    body: {
+        name: string;
+        enabled?: boolean;
+        mode?: 'instant' | 'daily';
+        filter?: {
+            /**
+             * Only these keywords.
+             */
+            keywordIds?: Array<string>;
+            /**
+             * Only posts from these platforms.
+             */
+            platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin'>;
+            /**
+             * Only mentions scored at least this; unclassified ones never pass.
+             */
+            minRelevance?: number;
+            /**
+             * Only these sentiments.
+             */
+            sentiments?: Array<'positive' | 'neutral' | 'negative'>;
+            /**
+             * At least one of these intents.
+             */
+            intents?: Array<string>;
+            /**
+             * Never these authors: display names, handles or profile URLs.
+             */
+            excludeAuthors?: Array<string>;
+            /**
+             * Only authors with at least this many followers. Unknown reach never passes.
+             */
+            minFollowers?: number;
+            /**
+             * Only authors your workspace tagged with any of these.
+             */
+            tags?: Array<string>;
+        };
+        /**
+         * Required for daily alerts.
+         */
+        schedule?: {
+            hour: number;
+            minute?: number;
+            timezone: string;
+            skipEmpty?: boolean;
+        };
+        /**
+         * Custom event name for webhook payloads; null for the mode default.
+         */
+        event?: string | null;
+        /**
+         * Channel ids from GET /v1/channels.
+         */
+        channelIds?: Array<string>;
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/alerts';
+};
+type CreateAlertErrors = {
+    /**
+     * A daily rule without a schedule, or an unknown channel
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+type CreateAlertError = CreateAlertErrors[keyof CreateAlertErrors];
+type CreateAlertResponses = {
+    /**
+     * The created rule
+     */
+    201: Alert;
+};
+type CreateAlertResponse = CreateAlertResponses[keyof CreateAlertResponses];
+type TestAlertData = {
+    body?: never;
+    path: {
+        /**
+         * Alert id (feed_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/alerts/{id}/test';
+};
+type TestAlertErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Rule not found
+     */
+    404: ErrorResponse;
+};
+type TestAlertError = TestAlertErrors[keyof TestAlertErrors];
+type TestAlertResponses = {
+    /**
+     * A test message was attempted on every channel of the rule
+     */
+    200: {
+        outcomes: Array<{
+            channelId: string;
+            ok: boolean;
+            error: string | null;
+        }>;
+    };
+};
+type TestAlertResponse = TestAlertResponses[keyof TestAlertResponses];
+type RunAlertDigestData = {
+    body?: never;
+    path: {
+        /**
+         * Alert id (feed_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/alerts/{id}/run';
+};
+type RunAlertDigestErrors = {
+    /**
+     * Only daily rules have a digest
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Rule not found
+     */
+    404: ErrorResponse;
+};
+type RunAlertDigestError = RunAlertDigestErrors[keyof RunAlertDigestErrors];
+type RunAlertDigestResponses = {
+    /**
+     * The digest for the last 24 hours was sent now (the scheduled one still runs)
+     */
+    200: {
+        /**
+         * Why nothing was sent, if nothing was.
+         */
+        skipped: 'already_sent' | 'empty';
+        matched: number;
+        relevant: number;
+        outcomes: Array<{
+            channelId: string;
+            ok: boolean;
+            error: string | null;
+        }>;
+    };
+};
+type RunAlertDigestResponse = RunAlertDigestResponses[keyof RunAlertDigestResponses];
+type GetAnalyticsSummaryData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Preset window ending today. Ignored when from or to is given. Default 30d.
+         */
+        range?: '7d' | '30d' | '90d' | '365d';
+        /**
+         * First day, YYYY-MM-DD, inclusive, in `timezone`.
+         */
+        from?: string;
+        /**
+         * Last day, YYYY-MM-DD, inclusive, in `timezone`. Default today.
+         */
+        to?: string;
+        /**
+         * Comma-separated keyword ids; omit for every keyword.
+         */
+        keywordIds?: string;
+        /**
+         * Comma-separated platforms (bluesky, hackernews, github, ...); omit for every platform.
+         */
+        platforms?: string;
+        /**
+         * true adds the period of the same length right before the window as `previous`.
+         */
+        compare?: 'true' | 'false';
+        /**
+         * IANA zone the days are cut in (Europe/Madrid). Default UTC. One offset, the zone's at the end of the window, applies to the whole window.
+         */
+        timezone?: string;
+    };
+    url: '/v1/analytics/summary';
+};
+type GetAnalyticsSummaryErrors = {
+    /**
+     * Invalid query
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+type GetAnalyticsSummaryError = GetAnalyticsSummaryErrors[keyof GetAnalyticsSummaryErrors];
+type GetAnalyticsSummaryResponses = {
+    /**
+     * The counts, with `previous` when comparing
+     */
+    200: AnalyticsSummary;
+};
+type GetAnalyticsSummaryResponse = GetAnalyticsSummaryResponses[keyof GetAnalyticsSummaryResponses];
+type GetAnalyticsSeriesData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Preset window ending today. Ignored when from or to is given. Default 30d.
+         */
+        range?: '7d' | '30d' | '90d' | '365d';
+        /**
+         * First day, YYYY-MM-DD, inclusive, in `timezone`.
+         */
+        from?: string;
+        /**
+         * Last day, YYYY-MM-DD, inclusive, in `timezone`. Default today.
+         */
+        to?: string;
+        /**
+         * Comma-separated keyword ids; omit for every keyword.
+         */
+        keywordIds?: string;
+        /**
+         * Comma-separated platforms (bluesky, hackernews, github, ...); omit for every platform.
+         */
+        platforms?: string;
+        /**
+         * true adds the period of the same length right before the window as `previous`.
+         */
+        compare?: 'true' | 'false';
+        /**
+         * IANA zone the days are cut in (Europe/Madrid). Default UTC. One offset, the zone's at the end of the window, applies to the whole window.
+         */
+        timezone?: string;
+        /**
+         * Point granularity. Default: day up to 90 days, week beyond. Weeks start on Monday.
+         */
+        bucket?: 'day' | 'week';
+        /**
+         * Split into one series per platform or per keyword (the top 20 by matched, the rest folded into "other"). Omit for one total series.
+         */
+        by?: 'platform' | 'keyword';
+    };
+    url: '/v1/analytics/series';
+};
+type GetAnalyticsSeriesErrors = {
+    /**
+     * Invalid query
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+type GetAnalyticsSeriesError = GetAnalyticsSeriesErrors[keyof GetAnalyticsSeriesErrors];
+type GetAnalyticsSeriesResponses = {
+    /**
+     * Zero-filled series, oldest point first
+     */
+    200: AnalyticsSeries;
+};
+type GetAnalyticsSeriesResponse = GetAnalyticsSeriesResponses[keyof GetAnalyticsSeriesResponses];
+type GetAnalyticsBreakdownData = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Preset window ending today. Ignored when from or to is given. Default 30d.
+         */
+        range?: '7d' | '30d' | '90d' | '365d';
+        /**
+         * First day, YYYY-MM-DD, inclusive, in `timezone`.
+         */
+        from?: string;
+        /**
+         * Last day, YYYY-MM-DD, inclusive, in `timezone`. Default today.
+         */
+        to?: string;
+        /**
+         * Comma-separated keyword ids; omit for every keyword.
+         */
+        keywordIds?: string;
+        /**
+         * Comma-separated platforms (bluesky, hackernews, github, ...); omit for every platform.
+         */
+        platforms?: string;
+        /**
+         * true adds the period of the same length right before the window as `previous`.
+         */
+        compare?: 'true' | 'false';
+        /**
+         * IANA zone the days are cut in (Europe/Madrid). Default UTC. One offset, the zone's at the end of the window, applies to the whole window.
+         */
+        timezone?: string;
+        /**
+         * The dimension to group by: platform, keyword, sentiment (unclassified included), intent (a mention can carry several), status (open, ignored, done), hour (weekday and hour of day in `timezone`), person (who posted; anonymous posts are left out).
+         */
+        by: 'platform' | 'keyword' | 'sentiment' | 'intent' | 'status' | 'hour' | 'person';
+    };
+    url: '/v1/analytics/breakdown';
+};
+type GetAnalyticsBreakdownErrors = {
+    /**
+     * Invalid query
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+type GetAnalyticsBreakdownError = GetAnalyticsBreakdownErrors[keyof GetAnalyticsBreakdownErrors];
+type GetAnalyticsBreakdownResponses = {
+    /**
+     * Groups, most matched first
+     */
+    200: AnalyticsBreakdown;
+};
+type GetAnalyticsBreakdownResponse = GetAnalyticsBreakdownResponses[keyof GetAnalyticsBreakdownResponses];
+type GetShareOfVoiceData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Preset window ending today. Ignored when from or to is given. Default 30d.
+         */
+        range?: '7d' | '30d' | '90d' | '365d';
+        /**
+         * First day, YYYY-MM-DD, inclusive, in `timezone`.
+         */
+        from?: string;
+        /**
+         * Last day, YYYY-MM-DD, inclusive, in `timezone`. Default today.
+         */
+        to?: string;
+        /**
+         * Comma-separated keyword ids; omit for every keyword.
+         */
+        keywordIds?: string;
+        /**
+         * Comma-separated platforms (bluesky, hackernews, github, ...); omit for every platform.
+         */
+        platforms?: string;
+        /**
+         * true adds the period of the same length right before the window as `previous`.
+         */
+        compare?: 'true' | 'false';
+        /**
+         * IANA zone the days are cut in (Europe/Madrid). Default UTC. One offset, the zone's at the end of the window, applies to the whole window.
+         */
+        timezone?: string;
+    };
+    url: '/v1/analytics/share-of-voice';
+};
+type GetShareOfVoiceErrors = {
+    /**
+     * Invalid query
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+type GetShareOfVoiceError = GetShareOfVoiceErrors[keyof GetShareOfVoiceErrors];
+type GetShareOfVoiceResponses = {
+    /**
+     * Keywords, most matched first
+     */
+    200: ShareOfVoice;
+};
+type GetShareOfVoiceResponse = GetShareOfVoiceResponses[keyof GetShareOfVoiceResponses];
+type DeleteChannelData = {
+    body?: never;
+    path: {
+        /**
+         * Channel id (dest_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/channels/{id}';
+};
+type DeleteChannelErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Channel not found
+     */
+    404: ErrorResponse;
+};
+type DeleteChannelError = DeleteChannelErrors[keyof DeleteChannelErrors];
+type DeleteChannelResponses = {
+    /**
+     * Deleted
+     */
+    204: void;
+};
+type DeleteChannelResponse = DeleteChannelResponses[keyof DeleteChannelResponses];
+type GetChannelData = {
+    body?: never;
+    path: {
+        /**
+         * Channel id (dest_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/channels/{id}';
+};
+type GetChannelErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Channel not found
+     */
+    404: ErrorResponse;
+};
+type GetChannelError = GetChannelErrors[keyof GetChannelErrors];
+type GetChannelResponses = {
+    /**
+     * The channel
+     */
+    200: Channel;
+};
+type GetChannelResponse = GetChannelResponses[keyof GetChannelResponses];
+type UpdateChannelData = {
+    /**
+     * Omitted fields are untouched.
+     */
+    body: {
+        label?: string;
+        /**
+         * Webhooks only.
+         */
+        url?: string;
+        /**
+         * Webhooks only; replaces the whole set.
+         */
+        headers?: {
+            [key: string]: string;
+        };
+    };
+    path: {
+        /**
+         * Channel id (dest_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/channels/{id}';
+};
+type UpdateChannelErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Channel not found
+     */
+    404: ErrorResponse;
+};
+type UpdateChannelError = UpdateChannelErrors[keyof UpdateChannelErrors];
+type UpdateChannelResponses = {
+    /**
+     * The updated channel
+     */
+    200: Channel;
+};
+type UpdateChannelResponse = UpdateChannelResponses[keyof UpdateChannelResponses];
+type TestChannelData = {
+    body?: never;
+    path: {
+        /**
+         * Channel id (dest_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/channels/{id}/test';
+};
+type TestChannelErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Channel not found
+     */
+    404: ErrorResponse;
+};
+type TestChannelError = TestChannelErrors[keyof TestChannelErrors];
+type TestChannelResponses = {
+    /**
+     * A test message was attempted on the channel (webhooks receive event "test")
+     */
+    200: {
+        outcomes: Array<{
+            channelId: string;
+            ok: boolean;
+            error: string | null;
+        }>;
+    };
+};
+type TestChannelResponse = TestChannelResponses[keyof TestChannelResponses];
+type RotateWebhookSecretData = {
+    body?: never;
+    path: {
+        /**
+         * Channel id (dest_...).
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/channels/{id}/rotate-secret';
+};
+type RotateWebhookSecretErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Webhook channel not found
+     */
+    404: ErrorResponse;
+};
+type RotateWebhookSecretError = RotateWebhookSecretErrors[keyof RotateWebhookSecretErrors];
+type RotateWebhookSecretResponses = {
+    /**
+     * A new signing secret, shown once. The previous one stops verifying immediately.
+     */
+    200: Channel;
+};
+type RotateWebhookSecretResponse = RotateWebhookSecretResponses[keyof RotateWebhookSecretResponses];
+type ListChannelDeliveriesData = {
+    body?: never;
+    path: {
+        /**
+         * Channel id (dest_...).
+         */
+        id: string;
+    };
+    query?: {
+        limit?: number;
+    };
+    url: '/v1/channels/{id}/deliveries';
+};
+type ListChannelDeliveriesErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Channel not found
+     */
+    404: ErrorResponse;
+};
+type ListChannelDeliveriesError = ListChannelDeliveriesErrors[keyof ListChannelDeliveriesErrors];
+type ListChannelDeliveriesResponses = {
+    /**
+     * What the channel received, newest first: instant mentions and digest runs, with status and last error
+     */
+    200: {
+        data: Array<{
+            /**
+             * Delivery id (dlv_...), also the webhook payload id.
+             */
+            id: string;
+            kind: 'mention' | 'digest';
+            status: 'pending' | 'delivered' | 'failed';
+            attempts: number;
+            /**
+             * The last failure, when there was one.
+             */
+            error: string | null;
+            /**
+             * ISO 8601 timestamp, UTC.
+             */
+            sentAt: string | null;
+            /**
+             * ISO 8601 timestamp, UTC.
+             */
+            createdAt: string;
+            /**
+             * The alert that produced it; name only, since alerts can be deleted.
+             */
+            alert: {
+                name: string | null;
+            };
+            /**
+             * For mention deliveries: the post, text cut to 160 characters.
+             */
+            mention: {
+                id: string;
+                url: string;
+                text: string;
+            } | null;
+        }>;
+    };
+};
+type ListChannelDeliveriesResponse = ListChannelDeliveriesResponses[keyof ListChannelDeliveriesResponses];
+type ListChannelsData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/channels';
+};
+type ListChannelsErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+type ListChannelsError = ListChannelsErrors[keyof ListChannelsErrors];
+type ListChannelsResponses = {
+    /**
+     * Every channel of the org
+     */
+    200: {
+        data: Array<{
+            /**
+             * Channel id (dest_...).
+             */
+            id: string;
+            label: string;
+            /**
+             * Computed over this workspace's deliveries.
+             */
+            stats: {
+                /**
+                 * Alerts sending to this channel.
+                 */
+                alerts: number;
+                /**
+                 * Of those, enabled ones; 0 means the channel receives nothing right now.
+                 */
+                activeAlerts: number;
+                /**
+                 * Newest delivery attempt, successful or not.
+                 */
+                lastDeliveryAt: string | null;
+                /**
+                 * Deliveries in the last 7 days.
+                 */
+                last7d: {
+                    total: number;
+                    failed: number;
+                };
+            };
+            /**
+             * ISO 8601 timestamp, UTC.
+             */
+            createdAt: string;
+            kind: 'slack';
+            config: {
+                channelId: string;
+                channelName: string;
+            };
+        } | {
+            /**
+             * Channel id (dest_...).
+             */
+            id: string;
+            label: string;
+            /**
+             * Computed over this workspace's deliveries.
+             */
+            stats: {
+                /**
+                 * Alerts sending to this channel.
+                 */
+                alerts: number;
+                /**
+                 * Of those, enabled ones; 0 means the channel receives nothing right now.
+                 */
+                activeAlerts: number;
+                /**
+                 * Newest delivery attempt, successful or not.
+                 */
+                lastDeliveryAt: string | null;
+                /**
+                 * Deliveries in the last 7 days.
+                 */
+                last7d: {
+                    total: number;
+                    failed: number;
+                };
+            };
+            /**
+             * ISO 8601 timestamp, UTC.
+             */
+            createdAt: string;
+            kind: 'email';
+            config: {
+                recipients: Array<{
+                    email: string;
+                    /**
+                     * Null until the address confirmed through its link; unconfirmed addresses receive nothing.
+                     */
+                    confirmedAt: string | null;
+                }>;
+            };
+        } | {
+            /**
+             * Channel id (dest_...).
+             */
+            id: string;
+            label: string;
+            /**
+             * Computed over this workspace's deliveries.
+             */
+            stats: {
+                /**
+                 * Alerts sending to this channel.
+                 */
+                alerts: number;
+                /**
+                 * Of those, enabled ones; 0 means the channel receives nothing right now.
+                 */
+                activeAlerts: number;
+                /**
+                 * Newest delivery attempt, successful or not.
+                 */
+                lastDeliveryAt: string | null;
+                /**
+                 * Deliveries in the last 7 days.
+                 */
+                last7d: {
+                    total: number;
+                    failed: number;
+                };
+            };
+            /**
+             * ISO 8601 timestamp, UTC.
+             */
+            createdAt: string;
+            kind: 'webhook';
+            config: {
+                url: string;
+                /**
+                 * Extra request headers you configured.
+                 */
+                headers: {
+                    [key: string]: string;
+                };
+                /**
+                 * Only on creation and rotation. Signs every body: X-Mentions-Signature is the hex HMAC-SHA256 of the raw bytes.
+                 */
+                secret?: string;
+            };
+        } | {
+            /**
+             * Channel id (dest_...).
+             */
+            id: string;
+            label: string;
+            /**
+             * Computed over this workspace's deliveries.
+             */
+            stats: {
+                /**
+                 * Alerts sending to this channel.
+                 */
+                alerts: number;
+                /**
+                 * Of those, enabled ones; 0 means the channel receives nothing right now.
+                 */
+                activeAlerts: number;
+                /**
+                 * Newest delivery attempt, successful or not.
+                 */
+                lastDeliveryAt: string | null;
+                /**
+                 * Deliveries in the last 7 days.
+                 */
+                last7d: {
+                    total: number;
+                    failed: number;
+                };
+            };
+            /**
+             * ISO 8601 timestamp, UTC.
+             */
+            createdAt: string;
+            kind: 'telegram';
+            config: {
+                chatId: string;
+                chatType: 'private' | 'group' | 'supergroup' | 'channel';
+            };
+        }>;
+    };
+};
+type ListChannelsResponse = ListChannelsResponses[keyof ListChannelsResponses];
+type CreateChannelData = {
+    body: {
+        kind: 'slack';
+        /**
+         * A Slack channel id from the connected workspace.
+         */
+        channelId: string;
+        channelName: string;
+    } | {
+        kind: 'email';
+        /**
+         * Each address gets a confirmation link; workspace members are confirmed on sight.
+         */
+        emails: Array<string>;
+    } | {
+        kind: 'webhook';
+        url: string;
+        label?: string;
+        headers?: {
+            [key: string]: string;
+        };
+    };
+    path?: never;
+    query?: never;
+    url: '/v1/channels';
+};
+type CreateChannelErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Slack is not connected for this org
+     */
+    409: ErrorResponse;
+};
+type CreateChannelError = CreateChannelErrors[keyof CreateChannelErrors];
+type CreateChannelResponses = {
+    /**
+     * The created channel. A webhook includes its signing secret, shown only here.
+     */
+    201: Channel;
+};
+type CreateChannelResponse = CreateChannelResponses[keyof CreateChannelResponses];
+
+type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options$1<TData, ThrowOnError, TResponse> & {
+    /**
+     * You can provide a client instance returned by `createClient()` instead of
+     * individual options. This might be also useful if you want to implement a
+     * custom client.
+     */
+    client?: Client;
+    /**
+     * You can pass arbitrary values through the `meta` object. This can be
+     * used to access values that aren't defined as part of the SDK function.
+     */
+    meta?: keyof ClientMeta extends never ? Record<string, unknown> : ClientMeta;
+};
+declare const getHealth: <ThrowOnError extends boolean = false>(options?: Options<GetHealthData, ThrowOnError>) => RequestResult<GetHealthResponses, unknown, ThrowOnError>;
+/**
+ * List keywords
+ *
+ * Every keyword of the workspace, newest first, with its match stats and poll health.
+ */
+declare const listKeywords: <ThrowOnError extends boolean = false>(options?: Options<ListKeywordsData, ThrowOnError>) => RequestResult<ListKeywordsResponses, ListKeywordsErrors, ThrowOnError>;
+/**
+ * Track a keyword
+ *
+ * Start tracking a word or phrase. Matching, classification and delivery begin on the next poll. Free workspaces track 2 keywords; a subscription raises that to 500.
+ */
+declare const createKeyword: <ThrowOnError extends boolean = false>(options: Options<CreateKeywordData, ThrowOnError>) => RequestResult<CreateKeywordResponses, CreateKeywordErrors, ThrowOnError>;
+/**
+ * Delete a keyword
+ *
+ * Removes the keyword and its matches. Posts also matched by another keyword stay.
+ */
+declare const deleteKeyword: <ThrowOnError extends boolean = false>(options: Options<DeleteKeywordData, ThrowOnError>) => RequestResult<DeleteKeywordResponses, DeleteKeywordErrors, ThrowOnError>;
+/**
+ * Get a keyword
+ */
+declare const getKeyword: <ThrowOnError extends boolean = false>(options: Options<GetKeywordData, ThrowOnError>) => RequestResult<GetKeywordResponses, GetKeywordErrors, ThrowOnError>;
+/**
+ * Update a keyword
+ *
+ * Mute or unmute it, or change the platforms it is tracked on.
+ */
+declare const updateKeyword: <ThrowOnError extends boolean = false>(options: Options<UpdateKeywordData, ThrowOnError>) => RequestResult<UpdateKeywordResponses, UpdateKeywordErrors, ThrowOnError>;
+/**
+ * Get a mention
+ *
+ * One mention by id, as it appears in the list: the post, its author with reach and your tags, the classification, the priority score and the triage fields. Ids belong to your organization; any other id is a 404.
+ */
+declare const getMention: <ThrowOnError extends boolean = false>(options: Options<GetMentionData, ThrowOnError>) => RequestResult<GetMentionResponses, GetMentionErrors, ThrowOnError>;
+/**
+ * Update a mention
+ *
+ * The one write on a mention. Set status to ignored or done to handle it (open puts it back), assign it to a workspace member, snooze it out of the feed, or leave an internal note. Null clears a field; omitted fields are untouched. Delivery and billing never change.
+ */
+declare const updateMention: <ThrowOnError extends boolean = false>(options: Options<UpdateMentionData, ThrowOnError>) => RequestResult<UpdateMentionResponses, UpdateMentionErrors, ThrowOnError>;
+/**
+ * List mentions
+ *
+ * Mentions matched to your keywords, filtered and paginated. Default order is newest match first; sort=priority ranks by attention score. Page with nextCursor, passing the same filters and sort. A mention is one post matched to one keyword.
+ */
+declare const searchMentions: <ThrowOnError extends boolean = false>(options?: Options<SearchMentionsData, ThrowOnError>) => RequestResult<SearchMentionsResponses, SearchMentionsErrors, ThrowOnError>;
+/**
+ * Export mentions as CSV
+ *
+ * The same mentions GET /v1/mentions would list for these filters, as CSV, newest published first: id, published_at, platform, keyword, author, author_url, author_followers, relevance, sentiment, intents (pipe-separated), status, relevant, delivered, url, text (first 1,000 characters). Capped at 10,000 rows; the X-Mentions-Truncated header says when the cap cut the list.
+ */
+declare const exportMentionsCsv: <ThrowOnError extends boolean = false>(options?: Options<ExportMentionsCsvData, ThrowOnError>) => RequestResult<ExportMentionsCsvResponses, ExportMentionsCsvErrors, ThrowOnError>;
+/**
+ * Export people as CSV
+ *
+ * The same list as GET /v1/people (segmentId included) as CSV, one row per person with their contact columns: handle, followers, email, website, company, location, tags. Capped at 5,000 people.
+ */
+declare const exportPeopleCsv: <ThrowOnError extends boolean = false>(options?: Options<ExportPeopleCsvData, ThrowOnError>) => RequestResult<ExportPeopleCsvResponses, ExportPeopleCsvErrors, ThrowOnError>;
+/**
+ * List people
+ *
+ * The people behind your mentions: one row per person, with their accounts, reach, public profile, per-workspace stats and your annotations. Filter by platform, tag, follower range, mention counts, intents seen, keyword kinds mentioned or never mentioned, or a saved segment. Offset-paginated with a total.
+ */
+declare const listPeople: <ThrowOnError extends boolean = false>(options?: Options<ListPeopleData, ThrowOnError>) => RequestResult<ListPeopleResponses, ListPeopleErrors, ThrowOnError>;
+/**
+ * Get a person
+ *
+ * One person as your workspace sees them. An account merged into someone resolves to that person.
+ */
+declare const getPerson: <ThrowOnError extends boolean = false>(options: Options<GetPersonData, ThrowOnError>) => RequestResult<GetPersonResponses, GetPersonErrors, ThrowOnError>;
+/**
+ * Update your annotations on a person
+ *
+ * Tags, notes and mute, for your workspace only. Mute hides their posts from your feed and every channel; ingest and billing never change.
+ */
+declare const updatePerson: <ThrowOnError extends boolean = false>(options: Options<UpdatePersonData, ThrowOnError>) => RequestResult<UpdatePersonResponses, UpdatePersonErrors, ThrowOnError>;
+/**
+ * Merge an account into a person
+ *
+ * Declare that this account and another person are the same human, for your workspace only. Their mentions, tags and notes combine under the person named by `into`.
+ */
+declare const mergePeople: <ThrowOnError extends boolean = false>(options: Options<MergePeopleData, ThrowOnError>) => RequestResult<MergePeopleResponses, MergePeopleErrors, ThrowOnError>;
+/**
+ * Undo a merge
+ *
+ * The account becomes its own person again.
+ */
+declare const splitPerson: <ThrowOnError extends boolean = false>(options: Options<SplitPersonData, ThrowOnError>) => RequestResult<SplitPersonResponses, SplitPersonErrors, ThrowOnError>;
+/**
+ * List segments
+ *
+ * Your saved segments, each with the number of people in it right now (segments are evaluated on every read, never materialized), plus presets you can save as a starting point. Pass a segment id to GET /v1/people to list its members.
+ */
+declare const listSegments: <ThrowOnError extends boolean = false>(options?: Options<ListSegmentsData, ThrowOnError>) => RequestResult<ListSegmentsResponses, ListSegmentsErrors, ThrowOnError>;
+/**
+ * Create a segment
+ */
+declare const createSegment: <ThrowOnError extends boolean = false>(options: Options<CreateSegmentData, ThrowOnError>) => RequestResult<CreateSegmentResponses, CreateSegmentErrors, ThrowOnError>;
+/**
+ * Delete a segment
+ *
+ * Nobody in it is affected.
+ */
+declare const deleteSegment: <ThrowOnError extends boolean = false>(options: Options<DeleteSegmentData, ThrowOnError>) => RequestResult<DeleteSegmentResponses, DeleteSegmentErrors, ThrowOnError>;
+/**
+ * Get a segment
+ */
+declare const getSegment: <ThrowOnError extends boolean = false>(options: Options<GetSegmentData, ThrowOnError>) => RequestResult<GetSegmentResponses, GetSegmentErrors, ThrowOnError>;
+/**
+ * Update a segment
+ */
+declare const updateSegment: <ThrowOnError extends boolean = false>(options: Options<UpdateSegmentData, ThrowOnError>) => RequestResult<UpdateSegmentResponses, UpdateSegmentErrors, ThrowOnError>;
+/**
+ * Get the company profile
+ *
+ * What the classifier knows about you: name, description, use cases, your own accounts, and the composed context it reads.
+ */
+declare const getCompany: <ThrowOnError extends boolean = false>(options?: Options<GetCompanyData, ThrowOnError>) => RequestResult<GetCompanyResponses, GetCompanyErrors, ThrowOnError>;
+/**
+ * Update the company profile
+ *
+ * Changing profile fields recomposes the classifier context; setting `context` directly overrides it until the next profile edit. Relevance scores for new mentions follow at once.
+ */
+declare const updateCompany: <ThrowOnError extends boolean = false>(options: Options<UpdateCompanyData, ThrowOnError>) => RequestResult<UpdateCompanyResponses, UpdateCompanyErrors, ThrowOnError>;
+/**
+ * List API keys
+ */
+declare const listApiKeys: <ThrowOnError extends boolean = false>(options?: Options<ListApiKeysData, ThrowOnError>) => RequestResult<ListApiKeysResponses, ListApiKeysErrors, ThrowOnError>;
+/**
+ * Create an API key
+ *
+ * Mint a key for this workspace. The key itself is returned once; only its hash is stored.
+ */
+declare const createApiKey: <ThrowOnError extends boolean = false>(options: Options<CreateApiKeyData, ThrowOnError>) => RequestResult<CreateApiKeyResponses, CreateApiKeyErrors, ThrowOnError>;
+/**
+ * Revoke an API key
+ *
+ * Takes effect at once on the API and within a few minutes on cached verifications.
+ */
+declare const revokeApiKey: <ThrowOnError extends boolean = false>(options: Options<RevokeApiKeyData, ThrowOnError>) => RequestResult<RevokeApiKeyResponses, RevokeApiKeyErrors, ThrowOnError>;
+/**
+ * Delete an alert
+ */
+declare const deleteAlert: <ThrowOnError extends boolean = false>(options: Options<DeleteAlertData, ThrowOnError>) => RequestResult<DeleteAlertResponses, DeleteAlertErrors, ThrowOnError>;
+/**
+ * Get an alert
+ */
+declare const getAlert: <ThrowOnError extends boolean = false>(options: Options<GetAlertData, ThrowOnError>) => RequestResult<GetAlertResponses, GetAlertErrors, ThrowOnError>;
+/**
+ * Update an alert
+ */
+declare const updateAlert: <ThrowOnError extends boolean = false>(options: Options<UpdateAlertData, ThrowOnError>) => RequestResult<UpdateAlertResponses, UpdateAlertErrors, ThrowOnError>;
+/**
+ * List alerts
+ */
+declare const listAlerts: <ThrowOnError extends boolean = false>(options?: Options<ListAlertsData, ThrowOnError>) => RequestResult<ListAlertsResponses, ListAlertsErrors, ThrowOnError>;
+/**
+ * Create an alert
+ */
+declare const createAlert: <ThrowOnError extends boolean = false>(options: Options<CreateAlertData, ThrowOnError>) => RequestResult<CreateAlertResponses, CreateAlertErrors, ThrowOnError>;
+/**
+ * Send a test through an alert's channels
+ */
+declare const testAlert: <ThrowOnError extends boolean = false>(options: Options<TestAlertData, ThrowOnError>) => RequestResult<TestAlertResponses, TestAlertErrors, ThrowOnError>;
+/**
+ * Send a digest now
+ */
+declare const runAlertDigest: <ThrowOnError extends boolean = false>(options: Options<RunAlertDigestData, ThrowOnError>) => RequestResult<RunAlertDigestResponses, RunAlertDigestErrors, ThrowOnError>;
+/**
+ * Headline counts for a window
+ *
+ * Matched and relevant mentions, distinct posts and people, sentiment, buying intent and questions, estimated reach, and where the matches stand in triage. The window is `range` (7d, 30d, 90d, 365d, ending today) or `from` and `to`, cut into days in `timezone` (UTC by default); `keywordIds` and `platforms` narrow it; `compare=true` adds the period of the same length right before it. Time axis is the publish date.
+ */
+declare const getAnalyticsSummary: <ThrowOnError extends boolean = false>(options?: Options<GetAnalyticsSummaryData, ThrowOnError>) => RequestResult<GetAnalyticsSummaryResponses, GetAnalyticsSummaryErrors, ThrowOnError>;
+/**
+ * Mentions over time
+ *
+ * Matched, relevant and sentiment counts per day or week across the window, as one total series or split per platform or per keyword with `by`. The window is `range` (7d, 30d, 90d, 365d, ending today) or `from` and `to`, cut into days in `timezone` (UTC by default); `keywordIds` and `platforms` narrow it; `compare=true` adds the period of the same length right before it. Time axis is the publish date.
+ */
+declare const getAnalyticsSeries: <ThrowOnError extends boolean = false>(options?: Options<GetAnalyticsSeriesData, ThrowOnError>) => RequestResult<GetAnalyticsSeriesResponses, GetAnalyticsSeriesErrors, ThrowOnError>;
+/**
+ * Mentions grouped by one dimension
+ *
+ * One table of matched, relevant and sentiment counts grouped by `by`: platform, keyword, sentiment, intent, status, hour (weekday and hour of day) or person. The window is `range` (7d, 30d, 90d, 365d, ending today) or `from` and `to`, cut into days in `timezone` (UTC by default); `keywordIds` and `platforms` narrow it; `compare=true` adds the period of the same length right before it. Time axis is the publish date.
+ */
+declare const getAnalyticsBreakdown: <ThrowOnError extends boolean = false>(options: Options<GetAnalyticsBreakdownData, ThrowOnError>) => RequestResult<GetAnalyticsBreakdownResponses, GetAnalyticsBreakdownErrors, ThrowOnError>;
+/**
+ * Brand against competitors
+ *
+ * Every keyword matched in the window with its counts and its share of brand plus competitor matches; topic keywords are counted but stay out of the split. The window is `range` (7d, 30d, 90d, 365d, ending today) or `from` and `to`, cut into days in `timezone` (UTC by default); `keywordIds` and `platforms` narrow it; `compare=true` adds the period of the same length right before it. Time axis is the publish date.
+ */
+declare const getShareOfVoice: <ThrowOnError extends boolean = false>(options?: Options<GetShareOfVoiceData, ThrowOnError>) => RequestResult<GetShareOfVoiceResponses, GetShareOfVoiceErrors, ThrowOnError>;
+/**
+ * Delete a channel
+ */
+declare const deleteChannel: <ThrowOnError extends boolean = false>(options: Options<DeleteChannelData, ThrowOnError>) => RequestResult<DeleteChannelResponses, DeleteChannelErrors, ThrowOnError>;
+/**
+ * Get a channel
+ */
+declare const getChannel: <ThrowOnError extends boolean = false>(options: Options<GetChannelData, ThrowOnError>) => RequestResult<GetChannelResponses, GetChannelErrors, ThrowOnError>;
+/**
+ * Update a channel
+ */
+declare const updateChannel: <ThrowOnError extends boolean = false>(options: Options<UpdateChannelData, ThrowOnError>) => RequestResult<UpdateChannelResponses, UpdateChannelErrors, ThrowOnError>;
+/**
+ * Send a test to a channel
+ */
+declare const testChannel: <ThrowOnError extends boolean = false>(options: Options<TestChannelData, ThrowOnError>) => RequestResult<TestChannelResponses, TestChannelErrors, ThrowOnError>;
+/**
+ * Rotate a webhook secret
+ */
+declare const rotateWebhookSecret: <ThrowOnError extends boolean = false>(options: Options<RotateWebhookSecretData, ThrowOnError>) => RequestResult<RotateWebhookSecretResponses, RotateWebhookSecretErrors, ThrowOnError>;
+/**
+ * List deliveries to a channel
+ */
+declare const listChannelDeliveries: <ThrowOnError extends boolean = false>(options: Options<ListChannelDeliveriesData, ThrowOnError>) => RequestResult<ListChannelDeliveriesResponses, ListChannelDeliveriesErrors, ThrowOnError>;
+/**
+ * List channels
+ */
+declare const listChannels: <ThrowOnError extends boolean = false>(options?: Options<ListChannelsData, ThrowOnError>) => RequestResult<ListChannelsResponses, ListChannelsErrors, ThrowOnError>;
+/**
+ * Create a channel
+ */
+declare const createChannel: <ThrowOnError extends boolean = false>(options: Options<CreateChannelData, ThrowOnError>) => RequestResult<CreateChannelResponses, CreateChannelErrors, ThrowOnError>;
+
+type sdk_Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options<TData, ThrowOnError, TResponse>;
+declare const sdk_createAlert: typeof createAlert;
+declare const sdk_createApiKey: typeof createApiKey;
+declare const sdk_createChannel: typeof createChannel;
+declare const sdk_createKeyword: typeof createKeyword;
+declare const sdk_createSegment: typeof createSegment;
+declare const sdk_deleteAlert: typeof deleteAlert;
+declare const sdk_deleteChannel: typeof deleteChannel;
+declare const sdk_deleteKeyword: typeof deleteKeyword;
+declare const sdk_deleteSegment: typeof deleteSegment;
+declare const sdk_exportMentionsCsv: typeof exportMentionsCsv;
+declare const sdk_exportPeopleCsv: typeof exportPeopleCsv;
+declare const sdk_getAlert: typeof getAlert;
+declare const sdk_getAnalyticsBreakdown: typeof getAnalyticsBreakdown;
+declare const sdk_getAnalyticsSeries: typeof getAnalyticsSeries;
+declare const sdk_getAnalyticsSummary: typeof getAnalyticsSummary;
+declare const sdk_getChannel: typeof getChannel;
+declare const sdk_getCompany: typeof getCompany;
+declare const sdk_getHealth: typeof getHealth;
+declare const sdk_getKeyword: typeof getKeyword;
+declare const sdk_getMention: typeof getMention;
+declare const sdk_getPerson: typeof getPerson;
+declare const sdk_getSegment: typeof getSegment;
+declare const sdk_getShareOfVoice: typeof getShareOfVoice;
+declare const sdk_listAlerts: typeof listAlerts;
+declare const sdk_listApiKeys: typeof listApiKeys;
+declare const sdk_listChannelDeliveries: typeof listChannelDeliveries;
+declare const sdk_listChannels: typeof listChannels;
+declare const sdk_listKeywords: typeof listKeywords;
+declare const sdk_listPeople: typeof listPeople;
+declare const sdk_listSegments: typeof listSegments;
+declare const sdk_mergePeople: typeof mergePeople;
+declare const sdk_revokeApiKey: typeof revokeApiKey;
+declare const sdk_rotateWebhookSecret: typeof rotateWebhookSecret;
+declare const sdk_runAlertDigest: typeof runAlertDigest;
+declare const sdk_searchMentions: typeof searchMentions;
+declare const sdk_splitPerson: typeof splitPerson;
+declare const sdk_testAlert: typeof testAlert;
+declare const sdk_testChannel: typeof testChannel;
+declare const sdk_updateAlert: typeof updateAlert;
+declare const sdk_updateChannel: typeof updateChannel;
+declare const sdk_updateCompany: typeof updateCompany;
+declare const sdk_updateKeyword: typeof updateKeyword;
+declare const sdk_updateMention: typeof updateMention;
+declare const sdk_updatePerson: typeof updatePerson;
+declare const sdk_updateSegment: typeof updateSegment;
+declare namespace sdk {
+  export { type sdk_Options as Options, sdk_createAlert as createAlert, sdk_createApiKey as createApiKey, sdk_createChannel as createChannel, sdk_createKeyword as createKeyword, sdk_createSegment as createSegment, sdk_deleteAlert as deleteAlert, sdk_deleteChannel as deleteChannel, sdk_deleteKeyword as deleteKeyword, sdk_deleteSegment as deleteSegment, sdk_exportMentionsCsv as exportMentionsCsv, sdk_exportPeopleCsv as exportPeopleCsv, sdk_getAlert as getAlert, sdk_getAnalyticsBreakdown as getAnalyticsBreakdown, sdk_getAnalyticsSeries as getAnalyticsSeries, sdk_getAnalyticsSummary as getAnalyticsSummary, sdk_getChannel as getChannel, sdk_getCompany as getCompany, sdk_getHealth as getHealth, sdk_getKeyword as getKeyword, sdk_getMention as getMention, sdk_getPerson as getPerson, sdk_getSegment as getSegment, sdk_getShareOfVoice as getShareOfVoice, sdk_listAlerts as listAlerts, sdk_listApiKeys as listApiKeys, sdk_listChannelDeliveries as listChannelDeliveries, sdk_listChannels as listChannels, sdk_listKeywords as listKeywords, sdk_listPeople as listPeople, sdk_listSegments as listSegments, sdk_mergePeople as mergePeople, sdk_revokeApiKey as revokeApiKey, sdk_rotateWebhookSecret as rotateWebhookSecret, sdk_runAlertDigest as runAlertDigest, sdk_searchMentions as searchMentions, sdk_splitPerson as splitPerson, sdk_testAlert as testAlert, sdk_testChannel as testChannel, sdk_updateAlert as updateAlert, sdk_updateChannel as updateChannel, sdk_updateCompany as updateCompany, sdk_updateKeyword as updateKeyword, sdk_updateMention as updateMention, sdk_updatePerson as updatePerson, sdk_updateSegment as updateSegment };
+}
+
+/**
+ * @mentio-dev/sdk: a typed client for the Mentio API. Everything under
+ * ./generated comes from the API's OpenAPI document (`pnpm generate`), one
+ * function per operation; this file adds the constructor that binds a key
+ * and a host once so calls read `mentio.searchMentions({ query })`.
+ */
+
+declare const DEFAULT_BASE_URL = "https://api.mentio.dev";
+interface MentioOptions {
+    /** API key from the dashboard or POST /v1/api-keys (mk_live_...). */
+    apiKey: string;
+    /** Another deployment's host; the hosted API by default. */
+    baseUrl?: string;
+    /** Custom fetch, for tests or runtimes without a global one. */
+    fetch?: typeof fetch;
+    /** Extra headers sent on every request. */
+    headers?: Record<string, string>;
+}
+/** Every SDK function, pre-bound to one client, plus the client itself for
+ *  interceptors and raw requests. Passing `client` in a call still wins. */
+type Mentio = typeof sdk & {
+    client: Client;
+};
+declare function createMentio(options: MentioOptions): Mentio;
+
+export { type Alert, type AnalyticsBreakdown, type AnalyticsSeries, type AnalyticsSummary, type Channel, type Client, type ClientOptions, type Company, type Config, type CreateAlertData, type CreateAlertError, type CreateAlertErrors, type CreateAlertResponse, type CreateAlertResponses, type CreateApiKeyData, type CreateApiKeyError, type CreateApiKeyErrors, type CreateApiKeyResponse, type CreateApiKeyResponses, type CreateChannelData, type CreateChannelError, type CreateChannelErrors, type CreateChannelResponse, type CreateChannelResponses, type CreateKeywordData, type CreateKeywordError, type CreateKeywordErrors, type CreateKeywordResponse, type CreateKeywordResponses, type CreateSegmentData, type CreateSegmentError, type CreateSegmentErrors, type CreateSegmentResponse, type CreateSegmentResponses, DEFAULT_BASE_URL, type DeleteAlertData, type DeleteAlertError, type DeleteAlertErrors, type DeleteAlertResponse, type DeleteAlertResponses, type DeleteChannelData, type DeleteChannelError, type DeleteChannelErrors, type DeleteChannelResponse, type DeleteChannelResponses, type DeleteKeywordData, type DeleteKeywordError, type DeleteKeywordErrors, type DeleteKeywordResponse, type DeleteKeywordResponses, type DeleteSegmentData, type DeleteSegmentError, type DeleteSegmentErrors, type DeleteSegmentResponse, type DeleteSegmentResponses, type ErrorResponse, type ExportMentionsCsvData, type ExportMentionsCsvError, type ExportMentionsCsvErrors, type ExportMentionsCsvResponse, type ExportMentionsCsvResponses, type ExportPeopleCsvData, type ExportPeopleCsvError, type ExportPeopleCsvErrors, type ExportPeopleCsvResponse, type ExportPeopleCsvResponses, type GetAlertData, type GetAlertError, type GetAlertErrors, type GetAlertResponse, type GetAlertResponses, type GetAnalyticsBreakdownData, type GetAnalyticsBreakdownError, type GetAnalyticsBreakdownErrors, type GetAnalyticsBreakdownResponse, type GetAnalyticsBreakdownResponses, type GetAnalyticsSeriesData, type GetAnalyticsSeriesError, type GetAnalyticsSeriesErrors, type GetAnalyticsSeriesResponse, type GetAnalyticsSeriesResponses, type GetAnalyticsSummaryData, type GetAnalyticsSummaryError, type GetAnalyticsSummaryErrors, type GetAnalyticsSummaryResponse, type GetAnalyticsSummaryResponses, type GetChannelData, type GetChannelError, type GetChannelErrors, type GetChannelResponse, type GetChannelResponses, type GetCompanyData, type GetCompanyError, type GetCompanyErrors, type GetCompanyResponse, type GetCompanyResponses, type GetHealthData, type GetHealthResponse, type GetHealthResponses, type GetKeywordData, type GetKeywordError, type GetKeywordErrors, type GetKeywordResponse, type GetKeywordResponses, type GetMentionData, type GetMentionError, type GetMentionErrors, type GetMentionResponse, type GetMentionResponses, type GetPersonData, type GetPersonError, type GetPersonErrors, type GetPersonResponse, type GetPersonResponses, type GetSegmentData, type GetSegmentError, type GetSegmentErrors, type GetSegmentResponse, type GetSegmentResponses, type GetShareOfVoiceData, type GetShareOfVoiceError, type GetShareOfVoiceErrors, type GetShareOfVoiceResponse, type GetShareOfVoiceResponses, type Keyword, type ListAlertsData, type ListAlertsError, type ListAlertsErrors, type ListAlertsResponse, type ListAlertsResponses, type ListApiKeysData, type ListApiKeysError, type ListApiKeysErrors, type ListApiKeysResponse, type ListApiKeysResponses, type ListChannelDeliveriesData, type ListChannelDeliveriesError, type ListChannelDeliveriesErrors, type ListChannelDeliveriesResponse, type ListChannelDeliveriesResponses, type ListChannelsData, type ListChannelsError, type ListChannelsErrors, type ListChannelsResponse, type ListChannelsResponses, type ListKeywordsData, type ListKeywordsError, type ListKeywordsErrors, type ListKeywordsResponse, type ListKeywordsResponses, type ListPeopleData, type ListPeopleError, type ListPeopleErrors, type ListPeopleResponse, type ListPeopleResponses, type ListSegmentsData, type ListSegmentsError, type ListSegmentsErrors, type ListSegmentsResponse, type ListSegmentsResponses, type Mentio, type MentioOptions, type Mention, type MergePeopleData, type MergePeopleError, type MergePeopleErrors, type MergePeopleResponse, type MergePeopleResponses, type Options, type Person, type RequestResult, type RevokeApiKeyData, type RevokeApiKeyError, type RevokeApiKeyErrors, type RevokeApiKeyResponse, type RevokeApiKeyResponses, type RotateWebhookSecretData, type RotateWebhookSecretError, type RotateWebhookSecretErrors, type RotateWebhookSecretResponse, type RotateWebhookSecretResponses, type RunAlertDigestData, type RunAlertDigestError, type RunAlertDigestErrors, type RunAlertDigestResponse, type RunAlertDigestResponses, type SearchMentionsData, type SearchMentionsError, type SearchMentionsErrors, type SearchMentionsResponse, type SearchMentionsResponses, type Segment, type ShareOfVoice, type SplitPersonData, type SplitPersonError, type SplitPersonErrors, type SplitPersonResponse, type SplitPersonResponses, type TestAlertData, type TestAlertError, type TestAlertErrors, type TestAlertResponse, type TestAlertResponses, type TestChannelData, type TestChannelError, type TestChannelErrors, type TestChannelResponse, type TestChannelResponses, type UpdateAlertData, type UpdateAlertError, type UpdateAlertErrors, type UpdateAlertResponse, type UpdateAlertResponses, type UpdateChannelData, type UpdateChannelError, type UpdateChannelErrors, type UpdateChannelResponse, type UpdateChannelResponses, type UpdateCompanyData, type UpdateCompanyError, type UpdateCompanyErrors, type UpdateCompanyResponse, type UpdateCompanyResponses, type UpdateKeywordData, type UpdateKeywordError, type UpdateKeywordErrors, type UpdateKeywordResponse, type UpdateKeywordResponses, type UpdateMentionData, type UpdateMentionError, type UpdateMentionErrors, type UpdateMentionResponse, type UpdateMentionResponses, type UpdatePersonData, type UpdatePersonError, type UpdatePersonErrors, type UpdatePersonResponse, type UpdatePersonResponses, type UpdateSegmentData, type UpdateSegmentError, type UpdateSegmentErrors, type UpdateSegmentResponse, type UpdateSegmentResponses, createAlert, createApiKey, createChannel, createClient, createConfig, createKeyword, createMentio, createSegment, deleteAlert, deleteChannel, deleteKeyword, deleteSegment, exportMentionsCsv, exportPeopleCsv, getAlert, getAnalyticsBreakdown, getAnalyticsSeries, getAnalyticsSummary, getChannel, getCompany, getHealth, getKeyword, getMention, getPerson, getSegment, getShareOfVoice, listAlerts, listApiKeys, listChannelDeliveries, listChannels, listKeywords, listPeople, listSegments, mergePeople, revokeApiKey, rotateWebhookSecret, runAlertDigest, searchMentions, splitPerson, testAlert, testChannel, updateAlert, updateChannel, updateCompany, updateKeyword, updateMention, updatePerson, updateSegment };