@waldofyi/sdk 0.1.0

package/dist/types.gen.d.ts

@@ -0,0 +1,2701 @@
+export type ClientOptions = {
+    baseUrl: "https://data.waldo.fyi" | (string & {});
+};
+export type TeamFlagRow = {
+    name: string;
+    enabled: boolean;
+    updatedAt: string;
+};
+export type AdminTeamRow = {
+    teamId: number;
+    name: string;
+    slug: string;
+    billable: boolean;
+    createdAt: string;
+    updatedAt: string;
+    teamMemberCount: number;
+    agentCount: number;
+    creditsUsed: number | null;
+    creditsLimit: number | null;
+    creditsAvailable: number | null;
+    subscriptionName: string | null;
+    subscriptionStatus: string | null;
+    availableTokens: number;
+    redeemedTokens: number;
+    totalTokens: number;
+};
+export type AccountUsage = {
+    period: {
+        start: string;
+        end: string;
+    };
+    total_calls: number;
+    by_domain: Array<{
+        domain: string;
+        calls: number;
+    }>;
+};
+export type AccountBalance = {
+    /**
+     * Credits remaining in the current period.
+     */
+    balance: number;
+    used: number;
+    limit: number;
+    plan: string | null;
+    status: string | null;
+    period: {
+        start: string | null;
+        end: string | null;
+        days_remaining: number | null;
+    };
+};
+export type AccountProfile = {
+    account_id: string;
+    email: string | null;
+    entities: {
+        brands: number;
+        categories: number;
+        audiences: number;
+    };
+    requests_this_month: number;
+};
+export type SearchResult = {
+    id: string;
+    brand_id: string | null;
+    brand_name: string | null;
+    platform: string;
+    ownership: string;
+    text: string | null;
+    url: string | null;
+    posted_at: string | null;
+    fetched_at: string;
+    source_type: string | null;
+    sentiment_polarity: string | null;
+    rank: number;
+};
+export type RedditSubredditDetails = {
+    id: string;
+    name: string;
+    prefixedName: string;
+    title?: string;
+    description?: string;
+    publicDescriptionText?: string;
+    subscribersCount?: number;
+    activeCount?: number;
+    createdAt?: string;
+    type?: string;
+    path?: string;
+    isNsfw?: boolean;
+    wikiPageStatus?: string;
+    wikiEditMode?: string;
+    icon?: string | null;
+    banner?: string | null;
+    taxonomyTopics?: Array<{
+        id: string;
+        displayName: string;
+        displayCopy: string;
+    }>;
+};
+export type RedditComment = {
+    id: string;
+    name: string;
+    createdAt: string;
+    contentPreview: string;
+    upvote: number;
+    postInfo: {
+        id: string;
+        title: string;
+        type: string;
+        prefixedName: string;
+    };
+};
+export type NormalizedPost = {
+    type: "post";
+    /**
+     * Opaque post token — pass to /v1/posts/{post_id} to enrich.
+     */
+    post_id: string;
+    platform: {
+        source: string;
+        name: string;
+        id: string;
+        url?: string;
+    };
+    publishedAt?: string;
+    content: {
+        title?: string;
+        text?: string;
+        author: {
+            id: string;
+            username: string;
+            name?: string;
+            profileUrl?: string;
+            profilePicture?: string;
+        };
+        media?: Array<{
+            type: "image" | "video";
+            url: string;
+            thumbnail?: string;
+        }>;
+        metrics?: {
+            likes?: number;
+            comments?: number;
+            shares?: number;
+            views?: number;
+            saves?: number;
+        };
+    };
+};
+export type MentionsSummary = {
+    brand_id: string;
+    total_mentions: number;
+    mentions_per_day: number;
+    by_source: Array<{
+        source_type: "SOCIAL" | "NEWS";
+        count: number;
+    }>;
+    /**
+     * Polarity buckets over the window. `count` is the row count per bucket; `percentage` is the share of labeled mentions in that bucket (0–100, one decimal). Rows with NULL sentiment (not yet analyzed) are excluded — bucket counts sum to the labeled total, not total_mentions. When no rows are labeled in the window, all percentages are 0.
+     */
+    sentiment_distribution: {
+        positive: {
+            count: number;
+            percentage: number;
+        };
+        neutral: {
+            count: number;
+            percentage: number;
+        };
+        negative: {
+            count: number;
+            percentage: number;
+        };
+        mixed: {
+            count: number;
+            percentage: number;
+        };
+    };
+    period: {
+        start: string;
+        end: string;
+    };
+};
+export type Mention = {
+    id: string;
+    brand_id: string;
+    /**
+     * Source category derived from the platform: SOCIAL for social platforms, NEWS for web articles.
+     */
+    source_type: "SOCIAL" | "NEWS" | null;
+    source_platform: string | null;
+    /**
+     * Same shape as owned-media post authors
+     */
+    author: {
+        handle: string | null;
+        name: string | null;
+    };
+    text: string | null;
+    url: string | null;
+    /**
+     * Polarity label written by the brand-post analyzer. Null on rows not yet analyzed (existing mentions collected before sentiment classification was wired stay null until re-analyzed).
+     */
+    sentiment_polarity: "POSITIVE" | "NEGATIVE" | "NEUTRAL" | "MIXED" | null;
+    /**
+     * Intensity bucket paired with sentiment_polarity; null until analyzed.
+     */
+    sentiment_intensity: "LOW" | "MEDIUM" | "HIGH" | null;
+    posted_at: string | null;
+    fetched_at: string;
+    /**
+     * First-seen-in-Waldo timestamp (alias of fetched_at — the column the post was inserted with).
+     */
+    discovered_at: string;
+};
+export type PaidMediaSummary = {
+    brand_id: string;
+    total_ads: number;
+    active_ads: number;
+    /**
+     * Ads whose start_date falls inside the summary window.
+     */
+    new_ads_in_period: number;
+    /**
+     * new_ads_in_period divided by days in the window.
+     */
+    avg_new_ads_per_day: number;
+    /**
+     * Mean run length (end_date − start_date) in days over ads with both dates. Null when no ad in the window has both dates.
+     */
+    avg_days_running: number | null;
+    /**
+     * Sum of estimated ad spend over the window. Null when no spend source is available (the absence of data, as distinct from a confirmed $0).
+     */
+    estimated_total_spend: number | null;
+    by_platform: Array<{
+        platform: string;
+        ads: number;
+        /**
+         * Alias of `ads` — prefer this name; `ads` is retained for backward compatibility.
+         */
+        ad_count: number;
+        active: number;
+        /**
+         * Estimated spend for this platform. Null when no spend source is available.
+         */
+        estimated_spend: number | null;
+    }>;
+    period: {
+        start: string;
+        end: string;
+    };
+};
+export type AdLandingPage = {
+    ad_id: string;
+    /**
+     * Normalized destination URL the ad clicks through to (click-tracking params stripped). Null only when the ad carried no landing-page URL.
+     */
+    url: string | null;
+    /**
+     * Public Waldo file URL for the full-page screenshot. Null when no capture was taken (see skip_reason).
+     */
+    screenshot_url: string | null;
+    /**
+     * When the screenshot was captured (ISO 8601). Null on skip.
+     */
+    captured_at: string | null;
+    /**
+     * Why no screenshot was taken — NO_URL (ad had no destination), UNRESOLVED_MACRO (URL carried literal {{...}} macros), APP_STORE (app-install link), or HOMEPAGE (bare advertiser homepage, not a campaign LP). Null on a real capture.
+     */
+    skip_reason: "NO_URL" | "UNRESOLVED_MACRO" | "APP_STORE" | "HOMEPAGE" | null;
+};
+export type Ad = {
+    ad_id: string;
+    brand_id: string;
+    platform: string;
+    title: string | null;
+    body: string | null;
+    media_urls: Array<string> | null;
+    targeting: {
+        [key: string]: unknown;
+    };
+    /**
+     * CTA captured verbatim from the ad platform at ingest (the platform's own button text/type/URL), as opposed to the analyzer-derived `cta`/`cta_text`. Null when the platform provides none (Google ads, LinkedIn text/InMail ads).
+     */
+    source_cta: {
+        text?: string;
+        type?: string;
+        url?: string;
+    } | null;
+    /**
+     * Analyzer-derived CTA type. Null on rows not yet analyzed or with no CTA.
+     */
+    cta: "shop_now" | "learn_more" | "sign_up" | "download" | "watch_more" | "contact" | "subscribe" | "book" | "install" | "other" | null;
+    /**
+     * Analyzer-derived literal CTA button/link label.
+     */
+    cta_text: string | null;
+    /**
+     * Text burned into the creative itself (overlays, end-cards, price/button labels), transcribed verbatim in reading order — distinct from `title`/`body` (the platform caption/headline). Null for text-only ads with no media pass, and on rows not yet analyzed.
+     */
+    on_screen_text: string | null;
+    promotion: AdPromotion;
+    currency: string;
+    status: string;
+    start_date: string | null;
+    end_date: string | null;
+    /**
+     * Ad destination URL. Sourced from the platform CTA URL (source_cta.url) — populated for Meta ads that carry one; null for Google/LinkedIn until the collector captures a dedicated landing-page URL.
+     */
+    landing_page_url: string | null;
+    /**
+     * Days the ad has been running: today − start_date while live, frozen at end_date once it has passed. Null until start_date is populated.
+     */
+    days_running: number | null;
+    region: string | null;
+    /**
+     * Video duration in seconds for video creatives, read at collection time via a container-level media probe. Null for image-only ads, when the probe failed, or on rows collected before the probe was wired.
+     */
+    length_seconds: number | null;
+    analysis: AdAnalysis;
+    fetched_at: string;
+};
+/**
+ * Analyzer enrichment (tone, target aspect, entities, audiences, etc.). Null on rows that have not yet been analyzed.
+ */
+export type AdAnalysis = {
+    tone: "aspirational" | "defensive" | "comedic" | "urgent" | "educational" | "celebratory" | "promotional" | "informational" | "emotional" | null;
+    target_aspect: string | null;
+    hook: string | null;
+    angle: string | null;
+    offers: Array<AdAnalysisOffer>;
+    topic_tags: Array<string>;
+    entities: Array<AdAnalysisEntity>;
+    brands: Array<string>;
+    audiences: Array<string>;
+    industries: Array<string>;
+    analyzed_at: string | null;
+} | null;
+export type AdAnalysisEntity = {
+    type: string;
+    value: string;
+};
+export type AdAnalysisOffer = {
+    type: string;
+    value?: string;
+};
+/**
+ * Structured offer extracted by the analyzer. Null when the ad carries no promotion or has not been analyzed yet.
+ */
+export type AdPromotion = {
+    is_promotional: boolean;
+    /**
+     * Open string (not an enum). Common values: percentage_off, dollar_off, free_trial, free_shipping, free_gift, bogo, bundle, clearance, sitewide_sale. May be null even when is_promotional is true.
+     */
+    discount_type: string | null;
+    discount_value: string | null;
+    discount_unit: string | null;
+    discount_text: string | null;
+    promo_code: string | null;
+    conditions: string | null;
+    expires_at: string | null;
+    confidence: number | null;
+} | null;
+export type OwnedMediaSummary = {
+    brand_id: string;
+    total_posts: number;
+    avg_posts_per_day: number;
+    by_platform: Array<{
+        platform: string;
+        posts: number;
+        avg_posts_per_day: number;
+    }>;
+    top_themes: Array<{
+        theme: string;
+        frequency: number;
+    }>;
+    sentiment_distribution: {
+        positive: number;
+        neutral: number;
+        negative: number;
+        mixed: number;
+    };
+    period: {
+        start: string;
+        end: string;
+    };
+};
+export type PostDetail = Post & {
+    metadata: PostMetadata;
+};
+export type PostMetadata = {
+    /**
+     * Bucket derived from media_urls extensions: image, video, mixed, or null when there are no URLs or none can be classified.
+     */
+    media_type: "image" | "video" | "mixed" | null;
+    /**
+     * ISO 639-1 code detected from `text` via a deterministic library. Null for empty, too-short, or undetermined input.
+     */
+    language: string | null;
+    /**
+     * ASR/caption transcript of the post's video or audio. Null when the post has no transcribable media or transcription hasn't run.
+     */
+    transcript: string | null;
+    /**
+     * Co-authors the brand co-published this post with (the `author` stays the brand); sourced from Instagram `coauthor_producers`. Present only on collaborative posts — its absence is the not-a-collab signal (no boolean is stored). An `invited_collaborators` sibling may be added later.
+     */
+    collaborators?: Array<{
+        handle: string | null;
+        name: string | null;
+    }>;
+};
+export type Post = {
+    id: string;
+    brand_id: string | null;
+    platform: string;
+    posted_at: string | null;
+    text: string | null;
+    media_urls: Array<string> | null;
+    media_count: number;
+    /**
+     * Derived from post text when the collected column is empty; values are tag names without the # prefix
+     */
+    hashtags: Array<string>;
+    url: string | null;
+    /**
+     * Market region of the source profile that published the post (e.g. "us"). Null on rows collected before region stamping. Filter the list endpoint with ?region=.
+     */
+    region: string | null;
+    author: {
+        handle: string | null;
+        name: string | null;
+    };
+    /**
+     * Like/reaction count. Populated on every platform except YouTube; null where unavailable.
+     */
+    likes: number | null;
+    /**
+     * Comment/reply count. Same platform coverage as likes.
+     */
+    comments: number | null;
+    /**
+     * Share/repost count. Populated on TikTok/Facebook/LinkedIn/Twitter; null on Instagram and YouTube.
+     */
+    shares: number | null;
+    /**
+     * Video/post view count. Populated on TikTok/YouTube/Twitter and most Instagram; null on Facebook and LinkedIn.
+     */
+    views: number | null;
+    analysis: PostAnalysis;
+    fetched_at: string;
+};
+/**
+ * Analyzer enrichment (tone, topic tags, entities, audiences, etc.). Null on rows that have not yet been analyzed.
+ */
+export type PostAnalysis = {
+    tone: "aspirational" | "authoritative" | "celebratory" | "comedic" | "defensive" | "educational" | "informational" | "promotional" | "urgent" | null;
+    hook: string | null;
+    angle: string | null;
+    topic_tags: Array<string>;
+    entities: Array<PostAnalysisEntity>;
+    brands: Array<string>;
+    audiences: Array<string>;
+    industries: Array<string>;
+    analyzed_at: string | null;
+} | null;
+export type PostAnalysisEntity = {
+    type: string;
+    value: string;
+};
+export type Platform = {
+    platform: string;
+    handle: string | null;
+    url: string | null;
+    followers: number | null;
+    follower_growth_30d: number | null;
+    avg_engagement_rate: number | null;
+    last_synced: string | null;
+    /**
+     * Whether the daily collectors pull ads/posts from this identity. Disabled identities stay registered for reference but are skipped during collection.
+     */
+    collection_enabled: boolean;
+};
+export type Timeseries = {
+    brand_id: string;
+    metric: string;
+    grain: string;
+    series: Array<{
+        period_start: string;
+        value: number;
+    }>;
+    deltas_vs_prior_window: {
+        total: number | null;
+        avg_per_period: number;
+    };
+};
+export type BrandDetail = BrandSummary & {
+    founded: number | null;
+    headquarters: string | null;
+    logo_url: string | null;
+};
+export type BrandSummary = {
+    id: string;
+    name: string;
+    /**
+     * Flat list of taxonomy nodes this brand is associated with. Subcategories carry parent_id/parent_name; top-level categories have null parent refs.
+     */
+    categories: Array<BrandCategory>;
+    description: string | null;
+    audience_ids: Array<string>;
+    platform_count: number;
+    primary_region: string;
+    regions_tracked: Array<string>;
+};
+export type BrandCategory = {
+    id: string;
+    name: string;
+    parent_id: string | null;
+    parent_name: string | null;
+};
+export type BrandComparison = {
+    brand_id: string;
+    name: string;
+    owned_posts_30d: number;
+    mention_volume_30d: number;
+    avg_sentiment_30d: number | null;
+    ad_count_30d: number;
+};
+export type Meta = {
+    request_id: string;
+    /**
+     * Total number of items matching the request, across all pages. Omitted when no total is available for the endpoint — absence means unknown, not zero.
+     */
+    total?: number;
+    /**
+     * ceil(total / limit). Present exactly when total is; paginate via next_cursor regardless.
+     */
+    total_pages?: number;
+    next_cursor?: string | null;
+};
+export type UsageResponse = {
+    team: {
+        id: number;
+        name: string | null;
+    };
+    /**
+     * Per-bucket consumption state, keyed by bucket name (`VENDOR`, `DEFAULT`).
+     */
+    buckets: {
+        [key: string]: RateLimitBucketState;
+    };
+    /**
+     * Which operations consume from each bucket. Derived live from the registry.
+     */
+    operationsByBucket: {
+        [key: string]: Array<string>;
+    };
+};
+export type RateLimitBucketState = {
+    /**
+     * Bucket state. `UNTHROTTLED`: bucket disabled, no cap applies. `UNAVAILABLE`: Redis-backed state could not be read (fail-open in effect — back off as if rate-limited). `AVAILABLE`: live state, `remaining` and `resetMs` are numbers.
+     */
+    status: "UNTHROTTLED" | "UNAVAILABLE" | "AVAILABLE";
+    requestsPerSecond: number;
+    burstAllowance: number;
+    enabled: boolean;
+    /**
+     * Tokens remaining in the bucket. `null` only when `status` is `UNTHROTTLED` or `UNAVAILABLE`.
+     */
+    remaining: number | null;
+    /**
+     * Milliseconds until the bucket fully refills. `null` only when `status` is `UNTHROTTLED` or `UNAVAILABLE`.
+     */
+    resetMs: number | null;
+};
+export type ApiKeyCreated = {
+    /**
+     * The raw key. Returned in plaintext exactly once — store it securely; it cannot be retrieved later.
+     */
+    apiKey: string;
+    keyId: string;
+    expiresAt: string | null;
+};
+export type ApiKeyMetadata = {
+    apiKeyId: string;
+    /**
+     * User who minted the key (keys are team-scoped; this is provenance)
+     */
+    userId: number;
+    name: string;
+    /**
+     * Minting provenance (MCP, REST, or OAUTH) — all key types authenticate identically.
+     */
+    type: string;
+    createdAt: string;
+    expiresAt: string | null;
+    lastUsedAt: string | null;
+    revokedAt: string | null;
+    status: "ACTIVE" | "REVOKED" | "EXPIRED";
+};
+/**
+ * Execution detail. Summary form (default) carries status, final output, and key metadata; pass full=true for the complete row including the messages array.
+ */
+export type ExecutionDetail = {
+    [key: string]: unknown;
+};
+export type ExecutionSummary = {
+    agentExecutionId: string;
+    agentId: string | null;
+    status: string;
+    spaceId: string | null;
+    totalTokens: number | null;
+    creditsUsed: number | null;
+    createdAt: string;
+    updatedAt: string;
+};
+/**
+ * Full run row, including variables and linkage IDs (spaceId, scheduledSequenceId, conversationId, etc.).
+ */
+export type RunDetail = {
+    [key: string]: unknown;
+};
+export type RunSummary = {
+    runId: string;
+    type: string;
+    status: string;
+    agentId: string | null;
+    sequenceId: string | null;
+    startedAt: string;
+    completedAt: string | null;
+    failureReason: string | null;
+};
+export type Error = {
+    error: string;
+};
+export type CollectionWindow = {
+    windowKey: string;
+    period: "DAILY" | "WEEKLY";
+    /**
+     * Random per-window fraction in [0, 1) added to every schedule's golden-ratio offset, decorrelating windows from each other. Fixed at creation.
+     */
+    phase: number;
+    /**
+     * High-water mark for fresh index allocations
+     */
+    nextIndex: number;
+    /**
+     * Released indices awaiting reuse
+     */
+    freeIndices: Array<number>;
+    createdAt: string;
+    updatedAt: string;
+};
+export type GetV1CollectionWindowsData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: "/v1/collection-windows";
+};
+export type GetV1CollectionWindowsErrors = {
+    /**
+     * Admin required
+     */
+    403: Error;
+};
+export type GetV1CollectionWindowsError = GetV1CollectionWindowsErrors[keyof GetV1CollectionWindowsErrors];
+export type GetV1CollectionWindowsResponses = {
+    /**
+     * All collection windows
+     */
+    200: {
+        data: Array<CollectionWindow>;
+    };
+};
+export type GetV1CollectionWindowsResponse = GetV1CollectionWindowsResponses[keyof GetV1CollectionWindowsResponses];
+export type PostV1CollectionWindowsData = {
+    body?: {
+        /**
+         * Opaque UPPERCASE_SNAKE namespace, max 64 chars. Never parsed for cadence.
+         */
+        windowKey: string;
+        /**
+         * Span the window's golden-ratio offsets spread over.
+         */
+        period: "DAILY" | "WEEKLY";
+    };
+    path?: never;
+    query?: never;
+    url: "/v1/collection-windows";
+};
+export type PostV1CollectionWindowsErrors = {
+    /**
+     * Invalid key or period
+     */
+    400: Error;
+    /**
+     * Admin required
+     */
+    403: Error;
+};
+export type PostV1CollectionWindowsError = PostV1CollectionWindowsErrors[keyof PostV1CollectionWindowsErrors];
+export type PostV1CollectionWindowsResponses = {
+    /**
+     * Window created (or already existed)
+     */
+    201: {
+        data: CollectionWindow;
+        created: boolean;
+    };
+};
+export type PostV1CollectionWindowsResponse = PostV1CollectionWindowsResponses[keyof PostV1CollectionWindowsResponses];
+export type RunListData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Filter by run status
+         */
+        status?: "RUNNING" | "COMPLETED" | "FAILED";
+        /**
+         * Filter by agent ID
+         */
+        agentId?: string;
+        /**
+         * Filter by sequence ID
+         */
+        sequenceId?: string;
+        /**
+         * Max results (default 50)
+         */
+        limit?: number;
+        /**
+         * Offset for pagination
+         */
+        offset?: number | null;
+    };
+    url: "/v1/runs";
+};
+export type RunListResponses = {
+    /**
+     * Runs, most recent first
+     */
+    200: {
+        data: Array<RunSummary>;
+    };
+};
+export type RunListResponse = RunListResponses[keyof RunListResponses];
+export type RunGetData = {
+    body?: never;
+    path: {
+        runId: string;
+    };
+    query?: never;
+    url: "/v1/runs/{runId}";
+};
+export type RunGetErrors = {
+    /**
+     * Run not found
+     */
+    404: Error;
+};
+export type RunGetError = RunGetErrors[keyof RunGetErrors];
+export type RunGetResponses = {
+    /**
+     * Run details
+     */
+    200: {
+        data: RunDetail;
+    };
+};
+export type RunGetResponse = RunGetResponses[keyof RunGetResponses];
+export type ExecutionListData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Filter by run ID
+         */
+        runId?: string;
+        /**
+         * Filter by agent ID
+         */
+        agentId?: string;
+        /**
+         * Filter by space ID
+         */
+        spaceId?: string;
+        /**
+         * Filter by execution status
+         */
+        status?: string;
+        /**
+         * Include child executions (default false)
+         */
+        includeChildren?: "0" | "1" | "true" | "false";
+        /**
+         * Max results (default 20)
+         */
+        limit?: number;
+        /**
+         * Pagination token from a previous response
+         */
+        cursor?: string;
+    };
+    url: "/v1/executions";
+};
+export type ExecutionListResponses = {
+    /**
+     * Executions
+     */
+    200: {
+        data: Array<ExecutionSummary>;
+        /**
+         * Pass as `cursor` query param to fetch the next page. Null when no more results.
+         */
+        nextCursor: string | null;
+        /**
+         * Whether additional pages of results exist beyond this response.
+         */
+        hasMore: boolean;
+    };
+};
+export type ExecutionListResponse = ExecutionListResponses[keyof ExecutionListResponses];
+export type ExecutionGetData = {
+    body?: never;
+    path: {
+        executionId: string;
+    };
+    query?: {
+        /**
+         * Return the complete record including messages (default false)
+         */
+        full?: "0" | "1" | "true" | "false";
+    };
+    url: "/v1/executions/{executionId}";
+};
+export type ExecutionGetErrors = {
+    /**
+     * Execution not found
+     */
+    404: Error;
+};
+export type ExecutionGetError = ExecutionGetErrors[keyof ExecutionGetErrors];
+export type ExecutionGetResponses = {
+    /**
+     * Execution details
+     */
+    200: {
+        data: ExecutionDetail;
+    };
+};
+export type ExecutionGetResponse = ExecutionGetResponses[keyof ExecutionGetResponses];
+export type ApiKeyListData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Filter by minting provenance
+         */
+        type?: "MCP" | "REST" | "OAUTH";
+    };
+    url: "/v1/api-keys";
+};
+export type ApiKeyListErrors = {
+    /**
+     * No workspace selected
+     */
+    400: Error;
+};
+export type ApiKeyListError = ApiKeyListErrors[keyof ApiKeyListErrors];
+export type ApiKeyListResponses = {
+    /**
+     * API keys for the current workspace
+     */
+    200: {
+        data: Array<ApiKeyMetadata>;
+    };
+};
+export type ApiKeyListResponse = ApiKeyListResponses[keyof ApiKeyListResponses];
+export type ApiKeyCreateData = {
+    body?: {
+        /**
+         * Human-readable label for the key
+         */
+        name: string;
+        /**
+         * Optional TTL in days (max 36500); omit for a non-expiring key
+         */
+        expiresInDays?: number;
+    };
+    path?: never;
+    query?: never;
+    url: "/v1/api-keys";
+};
+export type ApiKeyCreateErrors = {
+    /**
+     * No workspace selected or invalid input
+     */
+    400: Error;
+};
+export type ApiKeyCreateError = ApiKeyCreateErrors[keyof ApiKeyCreateErrors];
+export type ApiKeyCreateResponses = {
+    /**
+     * Key created — the raw key appears only in this response
+     */
+    200: {
+        data: ApiKeyCreated;
+    };
+};
+export type ApiKeyCreateResponse = ApiKeyCreateResponses[keyof ApiKeyCreateResponses];
+export type ApiKeyRevokeData = {
+    body?: never;
+    path: {
+        /**
+         * The apiKeyId to revoke (from the list endpoint)
+         */
+        keyId: string;
+    };
+    query?: never;
+    url: "/v1/api-keys/{keyId}";
+};
+export type ApiKeyRevokeErrors = {
+    /**
+     * No workspace selected
+     */
+    400: Error;
+    /**
+     * Key not found in the current workspace
+     */
+    404: Error;
+};
+export type ApiKeyRevokeError = ApiKeyRevokeErrors[keyof ApiKeyRevokeErrors];
+export type ApiKeyRevokeResponses = {
+    /**
+     * Key revoked
+     */
+    200: {
+        data: ApiKeyMetadata;
+    };
+};
+export type ApiKeyRevokeResponse = ApiKeyRevokeResponses[keyof ApiKeyRevokeResponses];
+export type GetUsageData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: "/v1/usage";
+};
+export type GetUsageResponses = {
+    /**
+     * Per-bucket consumption + operations-by-bucket
+     */
+    200: UsageResponse;
+};
+export type GetUsageResponse = GetUsageResponses[keyof GetUsageResponses];
+export type BrandSearchData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Search query — matches against brand name
+         */
+        q?: string;
+        /**
+         * Filter to brands in this category or subcategory (brand_taxonomy id). Matches the category and its direct subcategories.
+         */
+        category_id?: string;
+        /**
+         * Maximum number of results to return (1–100)
+         */
+        limit?: number;
+        /**
+         * Cursor for pagination — pass meta.next_cursor from the previous response
+         */
+        cursor?: string;
+    };
+    url: "/v1/brands/search";
+};
+export type BrandSearchResponses = {
+    /**
+     * Paginated list of brands
+     */
+    200: {
+        data: Array<BrandSummary>;
+        meta: Meta;
+    };
+};
+export type BrandSearchResponse = BrandSearchResponses[keyof BrandSearchResponses];
+export type BrandCompareData = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Comma-separated brand UUIDs (max 5)
+         */
+        brand_ids: string;
+        /**
+         * Time window for comparison. Defaults to 30d.
+         */
+        window?: "7d" | "30d" | "90d";
+    };
+    url: "/v1/brands/compare";
+};
+export type BrandCompareErrors = {
+    /**
+     * Invalid request
+     */
+    400: Error;
+};
+export type BrandCompareError = BrandCompareErrors[keyof BrandCompareErrors];
+export type BrandCompareResponses = {
+    /**
+     * Brand comparison results
+     */
+    200: {
+        data: {
+            comparison: Array<BrandComparison>;
+            period: {
+                start: string;
+                end: string;
+            };
+        };
+        meta: Meta;
+    };
+};
+export type BrandCompareResponse = BrandCompareResponses[keyof BrandCompareResponses];
+export type BrandGetData = {
+    body?: never;
+    path: {
+        /**
+         * Brand ID (UUID)
+         */
+        brand_id: string;
+    };
+    query?: never;
+    url: "/v1/brands/{brand_id}";
+};
+export type BrandGetErrors = {
+    /**
+     * Brand not found
+     */
+    404: Error;
+};
+export type BrandGetError = BrandGetErrors[keyof BrandGetErrors];
+export type BrandGetResponses = {
+    /**
+     * Brand details
+     */
+    200: {
+        data: BrandDetail;
+        meta: Meta;
+    };
+};
+export type BrandGetResponse = BrandGetResponses[keyof BrandGetResponses];
+export type BrandTimeseriesData = {
+    body?: never;
+    path: {
+        /**
+         * Brand ID (UUID)
+         */
+        brand_id: string;
+        /**
+         * Dataset to query: owned-media, paid-media, mentions, or all
+         */
+        dataset: "owned-media" | "paid-media" | "mentions" | "all";
+    };
+    query: {
+        /**
+         * Metric to chart
+         */
+        metric: "post_count" | "mention_volume" | "ad_count" | "avg_sentiment" | "net_sentiment" | "followers" | "follower_growth";
+        /**
+         * Time grain for bucketing
+         */
+        grain: "day" | "week" | "month";
+        /**
+         * Lookback window: 30d, 90d, 26w, or 12m
+         */
+        window: "30d" | "90d" | "26w" | "12m";
+        /**
+         * Filter/breakout by platform
+         */
+        platform?: string;
+        /**
+         * Filter/breakout by region
+         */
+        region?: string;
+    };
+    url: "/v1/brands/{brand_id}/{dataset}/timeseries";
+};
+export type BrandTimeseriesErrors = {
+    /**
+     * Brand not found
+     */
+    404: Error;
+};
+export type BrandTimeseriesError = BrandTimeseriesErrors[keyof BrandTimeseriesErrors];
+export type BrandTimeseriesResponses = {
+    /**
+     * Timeseries data with deltas vs. prior window
+     */
+    200: {
+        data: Timeseries;
+        meta: Meta;
+    };
+};
+export type BrandTimeseriesResponse = BrandTimeseriesResponses[keyof BrandTimeseriesResponses];
+export type BrandPlatformsListData = {
+    body?: never;
+    path: {
+        /**
+         * Brand ID (UUID)
+         */
+        brand_id: string;
+    };
+    query?: {
+        /**
+         * Include ad-library identity rows (meta_ads, google_ads, linkedin_ads). Off by default — these drive ad collection and aren't social presence.
+         */
+        include_ad_library?: "0" | "1" | "true" | "false";
+    };
+    url: "/v1/brands/{brand_id}/platforms";
+};
+export type BrandPlatformsListErrors = {
+    /**
+     * Brand not found
+     */
+    404: Error;
+};
+export type BrandPlatformsListError = BrandPlatformsListErrors[keyof BrandPlatformsListErrors];
+export type BrandPlatformsListResponses = {
+    /**
+     * List of platform accounts
+     */
+    200: {
+        data: Array<Platform>;
+        meta: Meta;
+    };
+};
+export type BrandPlatformsListResponse = BrandPlatformsListResponses[keyof BrandPlatformsListResponses];
+export type BrandPlatformsGetData = {
+    body?: never;
+    path: {
+        /**
+         * Brand ID (UUID)
+         */
+        brand_id: string;
+        /**
+         * Platform name (e.g. instagram, tiktok, twitter)
+         */
+        platform: string;
+    };
+    query?: {
+        /**
+         * Allow resolving ad-library identity rows (meta_ads, google_ads, linkedin_ads). Off by default — these 404 unless opted in.
+         */
+        include_ad_library?: "0" | "1" | "true" | "false";
+    };
+    url: "/v1/brands/{brand_id}/platforms/{platform}";
+};
+export type BrandPlatformsGetErrors = {
+    /**
+     * Brand or platform not found
+     */
+    404: Error;
+};
+export type BrandPlatformsGetError = BrandPlatformsGetErrors[keyof BrandPlatformsGetErrors];
+export type BrandPlatformsGetResponses = {
+    /**
+     * Platform account details
+     */
+    200: {
+        data: Platform;
+        meta: Meta;
+    };
+};
+export type BrandPlatformsGetResponse = BrandPlatformsGetResponses[keyof BrandPlatformsGetResponses];
+export type BrandOwnedMediaPostsListData = {
+    body?: never;
+    path: {
+        /**
+         * Brand ID (UUID)
+         */
+        brand_id: string;
+    };
+    query?: {
+        /**
+         * Filter to a single platform (e.g. instagram, tiktok, twitter). Mutually exclusive with exclude_platform.
+         */
+        platform?: string;
+        /**
+         * Exclude a single platform from the results (e.g. facebook). Mutually exclusive with platform.
+         */
+        exclude_platform?: string;
+        /**
+         * Filter posts on or after this date (ISO 8601)
+         */
+        start_date?: string;
+        /**
+         * Filter posts on or before this date (ISO 8601)
+         */
+        end_date?: string;
+        /**
+         * Filter by region
+         */
+        region?: string;
+        /**
+         * Order results by posted_at (default, recency) or a raw engagement metric: likes, comments, shares, or views. Posts missing the chosen metric sort last.
+         */
+        sort?: "posted_at" | "likes" | "comments" | "shares" | "views";
+        /**
+         * Sort direction: desc (default) or asc.
+         */
+        order?: "asc" | "desc";
+        /**
+         * Maximum number of results to return (1–100)
+         */
+        limit?: number;
+        /**
+         * Cursor for pagination — pass meta.next_cursor from the previous response
+         */
+        cursor?: string;
+    };
+    url: "/v1/brands/{brand_id}/owned-media/posts";
+};
+export type BrandOwnedMediaPostsListErrors = {
+    /**
+     * Brand not found
+     */
+    404: Error;
+};
+export type BrandOwnedMediaPostsListError = BrandOwnedMediaPostsListErrors[keyof BrandOwnedMediaPostsListErrors];
+export type BrandOwnedMediaPostsListResponses = {
+    /**
+     * Paginated list of owned posts
+     */
+    200: {
+        data: Array<Post>;
+        meta: Meta;
+    };
+};
+export type BrandOwnedMediaPostsListResponse = BrandOwnedMediaPostsListResponses[keyof BrandOwnedMediaPostsListResponses];
+export type BrandOwnedMediaPostsGetData = {
+    body?: never;
+    path: {
+        /**
+         * Brand ID (UUID)
+         */
+        brand_id: string;
+        /**
+         * Post ID (UUID)
+         */
+        post_id: string;
+    };
+    query?: never;
+    url: "/v1/brands/{brand_id}/owned-media/posts/{post_id}";
+};
+export type BrandOwnedMediaPostsGetErrors = {
+    /**
+     * Brand or post not found
+     */
+    404: Error;
+};
+export type BrandOwnedMediaPostsGetError = BrandOwnedMediaPostsGetErrors[keyof BrandOwnedMediaPostsGetErrors];
+export type BrandOwnedMediaPostsGetResponses = {
+    /**
+     * Post details
+     */
+    200: {
+        data: PostDetail;
+        meta: Meta;
+    };
+};
+export type BrandOwnedMediaPostsGetResponse = BrandOwnedMediaPostsGetResponses[keyof BrandOwnedMediaPostsGetResponses];
+export type BrandOwnedMediaSummaryData = {
+    body?: never;
+    path: {
+        /**
+         * Brand ID (UUID)
+         */
+        brand_id: string;
+    };
+    query?: {
+        /**
+         * Start of date range (ISO 8601). Defaults to 30 days ago.
+         */
+        start_date?: string;
+        /**
+         * End of date range (ISO 8601). Defaults to now.
+         */
+        end_date?: string;
+        /**
+         * Filter by region (e.g. "us"). Matches the list endpoint's region filter so the summary totals stay consistent with a region-scoped list.
+         */
+        region?: string;
+    };
+    url: "/v1/brands/{brand_id}/owned-media/summary";
+};
+export type BrandOwnedMediaSummaryErrors = {
+    /**
+     * Brand not found
+     */
+    404: Error;
+};
+export type BrandOwnedMediaSummaryError = BrandOwnedMediaSummaryErrors[keyof BrandOwnedMediaSummaryErrors];
+export type BrandOwnedMediaSummaryResponses = {
+    /**
+     * Owned media summary
+     */
+    200: {
+        data: OwnedMediaSummary;
+        meta: Meta;
+    };
+};
+export type BrandOwnedMediaSummaryResponse = BrandOwnedMediaSummaryResponses[keyof BrandOwnedMediaSummaryResponses];
+export type BrandPaidMediaAdsListData = {
+    body?: never;
+    path: {
+        /**
+         * Brand ID (UUID)
+         */
+        brand_id: string;
+    };
+    query?: {
+        /**
+         * Filter by ad platform (e.g. meta, google, tiktok)
+         */
+        platform?: string;
+        /**
+         * Filter by ad status (ACTIVE or ENDED)
+         */
+        status?: "ACTIVE" | "ENDED";
+        /**
+         * Maximum number of results to return (1–100)
+         */
+        limit?: number;
+        /**
+         * Cursor for pagination — pass meta.next_cursor from the previous response
+         */
+        cursor?: string;
+    };
+    url: "/v1/brands/{brand_id}/paid-media/ads";
+};
+export type BrandPaidMediaAdsListErrors = {
+    /**
+     * Brand not found
+     */
+    404: Error;
+};
+export type BrandPaidMediaAdsListError = BrandPaidMediaAdsListErrors[keyof BrandPaidMediaAdsListErrors];
+export type BrandPaidMediaAdsListResponses = {
+    /**
+     * Paginated list of ads
+     */
+    200: {
+        data: Array<Ad>;
+        meta: Meta;
+    };
+};
+export type BrandPaidMediaAdsListResponse = BrandPaidMediaAdsListResponses[keyof BrandPaidMediaAdsListResponses];
+export type BrandPaidMediaAdsGetData = {
+    body?: never;
+    path: {
+        /**
+         * Brand ID (UUID)
+         */
+        brand_id: string;
+        /**
+         * Ad ID (UUID)
+         */
+        ad_id: string;
+    };
+    query?: never;
+    url: "/v1/brands/{brand_id}/paid-media/ads/{ad_id}";
+};
+export type BrandPaidMediaAdsGetErrors = {
+    /**
+     * Brand or ad not found
+     */
+    404: Error;
+};
+export type BrandPaidMediaAdsGetError = BrandPaidMediaAdsGetErrors[keyof BrandPaidMediaAdsGetErrors];
+export type BrandPaidMediaAdsGetResponses = {
+    /**
+     * Ad details
+     */
+    200: {
+        data: Ad;
+        meta: Meta;
+    };
+};
+export type BrandPaidMediaAdsGetResponse = BrandPaidMediaAdsGetResponses[keyof BrandPaidMediaAdsGetResponses];
+export type BrandPaidMediaAdsLandingPageGetData = {
+    body?: never;
+    path: {
+        /**
+         * Brand ID (UUID)
+         */
+        brand_id: string;
+        /**
+         * Ad ID (UUID)
+         */
+        ad_id: string;
+    };
+    query?: never;
+    url: "/v1/brands/{brand_id}/paid-media/ads/{ad_id}/landing-page";
+};
+export type BrandPaidMediaAdsLandingPageGetErrors = {
+    /**
+     * Brand or ad not found
+     */
+    404: Error;
+};
+export type BrandPaidMediaAdsLandingPageGetError = BrandPaidMediaAdsLandingPageGetErrors[keyof BrandPaidMediaAdsLandingPageGetErrors];
+export type BrandPaidMediaAdsLandingPageGetResponses = {
+    /**
+     * Landing-page snapshot (captured or skipped)
+     */
+    200: {
+        data: AdLandingPage;
+        meta: Meta;
+    };
+};
+export type BrandPaidMediaAdsLandingPageGetResponse = BrandPaidMediaAdsLandingPageGetResponses[keyof BrandPaidMediaAdsLandingPageGetResponses];
+export type BrandPaidMediaSummaryData = {
+    body?: never;
+    path: {
+        /**
+         * Brand ID (UUID)
+         */
+        brand_id: string;
+    };
+    query?: {
+        /**
+         * Start of date range (ISO 8601). Defaults to 30 days ago.
+         */
+        start_date?: string;
+        /**
+         * End of date range (ISO 8601). Defaults to now.
+         */
+        end_date?: string;
+    };
+    url: "/v1/brands/{brand_id}/paid-media/summary";
+};
+export type BrandPaidMediaSummaryErrors = {
+    /**
+     * Brand not found
+     */
+    404: Error;
+};
+export type BrandPaidMediaSummaryError = BrandPaidMediaSummaryErrors[keyof BrandPaidMediaSummaryErrors];
+export type BrandPaidMediaSummaryResponses = {
+    /**
+     * Paid media summary
+     */
+    200: {
+        data: PaidMediaSummary;
+        meta: Meta;
+    };
+};
+export type BrandPaidMediaSummaryResponse = BrandPaidMediaSummaryResponses[keyof BrandPaidMediaSummaryResponses];
+export type BrandMentionsListData = {
+    body?: never;
+    path: {
+        /**
+         * Brand ID (UUID)
+         */
+        brand_id: string;
+    };
+    query?: {
+        /**
+         * Filter by source category: SOCIAL (social platforms) or NEWS (web articles)
+         */
+        source_type?: "SOCIAL" | "NEWS";
+        /**
+         * Filter by platform (e.g. instagram, twitter, reddit)
+         */
+        platform?: string;
+        /**
+         * Filter mentions on or after this date (ISO 8601)
+         */
+        start_date?: string;
+        /**
+         * Filter mentions on or before this date (ISO 8601)
+         */
+        end_date?: string;
+        /**
+         * Filter by region
+         */
+        region?: string;
+        /**
+         * Maximum number of results to return (1–100)
+         */
+        limit?: number;
+        /**
+         * Cursor for pagination — pass meta.next_cursor from the previous response
+         */
+        cursor?: string;
+    };
+    url: "/v1/brands/{brand_id}/mentions";
+};
+export type BrandMentionsListErrors = {
+    /**
+     * Brand not found
+     */
+    404: Error;
+};
+export type BrandMentionsListError = BrandMentionsListErrors[keyof BrandMentionsListErrors];
+export type BrandMentionsListResponses = {
+    /**
+     * Paginated list of mentions
+     */
+    200: {
+        data: Array<Mention>;
+        meta: Meta;
+    };
+};
+export type BrandMentionsListResponse = BrandMentionsListResponses[keyof BrandMentionsListResponses];
+export type BrandMentionsSummaryData = {
+    body?: never;
+    path: {
+        /**
+         * Brand ID (UUID)
+         */
+        brand_id: string;
+    };
+    query?: {
+        /**
+         * Start of date range (ISO 8601). Defaults to 30 days ago.
+         */
+        start_date?: string;
+        /**
+         * End of date range (ISO 8601). Defaults to now.
+         */
+        end_date?: string;
+    };
+    url: "/v1/brands/{brand_id}/mentions/summary";
+};
+export type BrandMentionsSummaryErrors = {
+    /**
+     * Brand not found
+     */
+    404: Error;
+};
+export type BrandMentionsSummaryError = BrandMentionsSummaryErrors[keyof BrandMentionsSummaryErrors];
+export type BrandMentionsSummaryResponses = {
+    /**
+     * Mentions summary
+     */
+    200: {
+        data: MentionsSummary;
+        meta: Meta;
+    };
+};
+export type BrandMentionsSummaryResponse = BrandMentionsSummaryResponses[keyof BrandMentionsSummaryResponses];
+export type BrandMentionsGetData = {
+    body?: never;
+    path: {
+        /**
+         * Brand ID (UUID)
+         */
+        brand_id: string;
+        /**
+         * Mention ID (UUID — corresponds to the underlying post_id)
+         */
+        mention_id: string;
+    };
+    query?: never;
+    url: "/v1/brands/{brand_id}/mentions/{mention_id}";
+};
+export type BrandMentionsGetErrors = {
+    /**
+     * Brand or mention not found
+     */
+    404: Error;
+};
+export type BrandMentionsGetError = BrandMentionsGetErrors[keyof BrandMentionsGetErrors];
+export type BrandMentionsGetResponses = {
+    /**
+     * Mention details
+     */
+    200: {
+        data: Mention;
+        meta: Meta;
+    };
+};
+export type BrandMentionsGetResponse = BrandMentionsGetResponses[keyof BrandMentionsGetResponses];
+export type DiscoverPostsData = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Social platform to search
+         */
+        platform: "x" | "instagram" | "tiktok" | "linkedin" | "facebook" | "youtube" | "reddit";
+        /**
+         * Search query
+         */
+        q: string;
+        /**
+         * Pagination cursor for next page
+         */
+        cursor?: string;
+    };
+    url: "/v1/discover/posts";
+};
+export type DiscoverPostsResponses = {
+    /**
+     * Search results
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type DiscoverPostsResponse = DiscoverPostsResponses[keyof DiscoverPostsResponses];
+export type DiscoverPosts2Data = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Search query
+         */
+        q: string;
+        /**
+         * Pagination cursor for next page
+         */
+        cursor?: string;
+        /**
+         * Sort order: `top` (most relevant) or `latest` (most recent).
+         */
+        sort?: "top" | "latest";
+    };
+    url: "/v1/discover/x/posts";
+};
+export type DiscoverPosts2Responses = {
+    /**
+     * Search results
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type DiscoverPosts2Response = DiscoverPosts2Responses[keyof DiscoverPosts2Responses];
+export type DiscoverPosts3Data = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Search query
+         */
+        q: string;
+        /**
+         * Pagination cursor for next page
+         */
+        cursor?: string;
+        /**
+         * Sort order: `relevance`, `likes` (most liked), or `date` (most recent).
+         */
+        sort?: "relevance" | "likes" | "date";
+        /**
+         * Time window — posts from the last day, week, month, or year.
+         */
+        since?: "day" | "week" | "month" | "year";
+        /**
+         * ISO-2 country code to adjust results by region (e.g. `US`).
+         */
+        country?: string;
+    };
+    url: "/v1/discover/tiktok/posts";
+};
+export type DiscoverPosts3Responses = {
+    /**
+     * Search results
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type DiscoverPosts3Response = DiscoverPosts3Responses[keyof DiscoverPosts3Responses];
+export type DiscoverPosts4Data = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Search query
+         */
+        q: string;
+        /**
+         * Pagination cursor for next page
+         */
+        cursor?: string;
+        /**
+         * Sort order: relevance, hot, top, new, or comments.
+         */
+        sort?: "relevance" | "hot" | "top" | "new" | "comments";
+        /**
+         * Time window: hour, today, week, month, year, or all. Reddit requires it when `sort` is top, comments, or relevance.
+         */
+        since?: "hour" | "today" | "week" | "month" | "year" | "all";
+    };
+    url: "/v1/discover/reddit/posts";
+};
+export type DiscoverPosts4Responses = {
+    /**
+     * Search results
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type DiscoverPosts4Response = DiscoverPosts4Responses[keyof DiscoverPosts4Responses];
+export type DiscoverPosts5Data = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Search query
+         */
+        q: string;
+        /**
+         * Pagination cursor for next page
+         */
+        cursor?: string;
+        /**
+         * Sort order: `top` (most relevant, default) or `latest` (most recent).
+         */
+        sort?: "top" | "latest";
+        /**
+         * Time window: day, week, or month.
+         */
+        since?: "day" | "week" | "month";
+    };
+    url: "/v1/discover/linkedin/posts";
+};
+export type DiscoverPosts5Responses = {
+    /**
+     * Search results
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type DiscoverPosts5Response = DiscoverPosts5Responses[keyof DiscoverPosts5Responses];
+export type DiscoverPosts6Data = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Search query
+         */
+        q: string;
+        /**
+         * Pagination cursor for next page
+         */
+        cursor?: string;
+        /**
+         * Sort order: `relevance` or `popularity` (by view count).
+         */
+        sort?: "relevance" | "popularity";
+        /**
+         * Time window — videos from the last day, week, month, or year. Omit for all-time.
+         */
+        since?: "day" | "week" | "month" | "year";
+    };
+    url: "/v1/discover/youtube/posts";
+};
+export type DiscoverPosts6Responses = {
+    /**
+     * Search results
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type DiscoverPosts6Response = DiscoverPosts6Responses[keyof DiscoverPosts6Responses];
+export type DiscoverPosts7Data = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Search query
+         */
+        q: string;
+        /**
+         * Pagination cursor for next page
+         */
+        cursor?: string;
+    };
+    url: "/v1/discover/instagram/posts";
+};
+export type DiscoverPosts7Responses = {
+    /**
+     * Search results
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type DiscoverPosts7Response = DiscoverPosts7Responses[keyof DiscoverPosts7Responses];
+export type DiscoverPosts8Data = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Search query
+         */
+        q: string;
+        /**
+         * Pagination cursor for next page
+         */
+        cursor?: string;
+    };
+    url: "/v1/discover/facebook/posts";
+};
+export type DiscoverPosts8Responses = {
+    /**
+     * Search results
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type DiscoverPosts8Response = DiscoverPosts8Responses[keyof DiscoverPosts8Responses];
+export type DiscoverAdsData = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Ad platform to search (meta, google, or linkedin)
+         */
+        platform: "meta" | "google" | "linkedin";
+        /**
+         * Search query or advertiser name. For platform=google this is an advertiser domain (e.g. 'shopify.com') — the Google Ads Transparency Center has no free-text search.
+         */
+        q: string;
+        /**
+         * Pagination cursor for next page
+         */
+        cursor?: string;
+    };
+    url: "/v1/discover/ads";
+};
+export type DiscoverAdsResponses = {
+    /**
+     * Ad search results
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type DiscoverAdsResponse = DiscoverAdsResponses[keyof DiscoverAdsResponses];
+export type DiscoverTrendsData = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Trends platform (x or google_trends)
+         */
+        platform: "x" | "google_trends" | "tiktok";
+        /**
+         * Search query (required for google_trends; ignored for x, which lists trends rather than searches them)
+         */
+        q?: string;
+        /**
+         * Country filter (ISO 2-letter code)
+         */
+        country?: string;
+    };
+    url: "/v1/discover/trends";
+};
+export type DiscoverTrendsResponses = {
+    /**
+     * Trending topics
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type DiscoverTrendsResponse = DiscoverTrendsResponses[keyof DiscoverTrendsResponses];
+export type DiscoverUsersData = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Social platform to search
+         */
+        platform: "x" | "instagram" | "tiktok" | "linkedin" | "facebook" | "youtube";
+        /**
+         * Search query
+         */
+        q: string;
+        /**
+         * Pagination cursor for next page
+         */
+        cursor?: string;
+    };
+    url: "/v1/discover/users";
+};
+export type DiscoverUsersResponses = {
+    /**
+     * Creator search results
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type DiscoverUsersResponse = DiscoverUsersResponses[keyof DiscoverUsersResponses];
+export type DiscoverCompaniesData = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Company name or keyword
+         */
+        q: string;
+        /**
+         * Pagination cursor for next page
+         */
+        cursor?: string;
+    };
+    url: "/v1/discover/companies";
+};
+export type DiscoverCompaniesResponses = {
+    /**
+     * Company search results
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type DiscoverCompaniesResponse = DiscoverCompaniesResponses[keyof DiscoverCompaniesResponses];
+export type DiscoverJobsData = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Job title or keyword
+         */
+        q: string;
+        /**
+         * Pagination cursor for next page
+         */
+        cursor?: string;
+    };
+    url: "/v1/discover/jobs";
+};
+export type DiscoverJobsResponses = {
+    /**
+     * Job search results
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type DiscoverJobsResponse = DiscoverJobsResponses[keyof DiscoverJobsResponses];
+export type DiscoverCommunitiesData = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Community name or topic
+         */
+        q: string;
+    };
+    url: "/v1/discover/communities";
+};
+export type DiscoverCommunitiesResponses = {
+    /**
+     * Community search results
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type DiscoverCommunitiesResponse = DiscoverCommunitiesResponses[keyof DiscoverCommunitiesResponses];
+export type EnrichmentPostLookupData = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Full post URL (LinkedIn, Twitter/X, Instagram, TikTok, Facebook, YouTube, Reddit)
+         */
+        url: string;
+        /**
+         * Optional override when the URL host doesn't disambiguate the platform.
+         */
+        platform?: "x" | "instagram" | "tiktok" | "linkedin" | "facebook" | "youtube" | "reddit";
+    };
+    url: "/v1/posts/lookup";
+};
+export type EnrichmentPostLookupResponses = {
+    /**
+     * Enriched post data with minted post_id
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type EnrichmentPostLookupResponse = EnrichmentPostLookupResponses[keyof EnrichmentPostLookupResponses];
+export type EnrichmentPostGetData = {
+    body?: never;
+    path: {
+        /**
+         * Opaque pid_… token (returned in discover/search/profile-posts items and /v1/posts/lookup responses) OR a bare platform ID paired with the `platform` query — both forms are first-class. Do NOT pass a raw post URL: encoded slashes die at the API gateway and return a bare 404 before the handler runs. Use /v1/posts/lookup?url=… when you only have a URL.
+         */
+        post_id: string;
+    };
+    query?: {
+        /**
+         * Required only when `post_id` is a bare platform ID; ignored when a synthetic pid_ token is supplied.
+         */
+        platform?: "x" | "instagram" | "tiktok" | "linkedin" | "facebook" | "youtube" | "reddit";
+    };
+    url: "/v1/posts/{post_id}";
+};
+export type EnrichmentPostGetResponses = {
+    /**
+     * Enriched post data
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type EnrichmentPostGetResponse = EnrichmentPostGetResponses[keyof EnrichmentPostGetResponses];
+export type EnrichmentPostCommentsData = {
+    body?: never;
+    path: {
+        /**
+         * Opaque pid_… token (returned in discover/search/profile-posts items and /v1/posts/lookup responses) OR a bare platform ID paired with the `platform` query — both forms are first-class. Do NOT pass a raw post URL: encoded slashes die at the API gateway and return a bare 404 before the handler runs. Use /v1/posts/lookup?url=… when you only have a URL.
+         */
+        post_id: string;
+    };
+    query?: {
+        /**
+         * Required only when `post_id` is a bare platform ID; ignored when a synthetic pid_ token is supplied.
+         */
+        platform?: "x" | "instagram" | "tiktok" | "linkedin" | "facebook" | "youtube" | "reddit";
+        /**
+         * Pagination cursor for next page
+         */
+        cursor?: string;
+    };
+    url: "/v1/posts/{post_id}/comments";
+};
+export type EnrichmentPostCommentsResponses = {
+    /**
+     * Post comments
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type EnrichmentPostCommentsResponse = EnrichmentPostCommentsResponses[keyof EnrichmentPostCommentsResponses];
+export type EnrichmentProfileGetData = {
+    body?: never;
+    path: {
+        /**
+         * Social platform
+         */
+        platform: "x" | "instagram" | "tiktok" | "linkedin" | "facebook" | "youtube" | "reddit";
+        /**
+         * Username or handle (without @)
+         */
+        username: string;
+    };
+    query?: never;
+    url: "/v1/profiles/{platform}/{username}";
+};
+export type EnrichmentProfileGetResponses = {
+    /**
+     * Profile data
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type EnrichmentProfileGetResponse = EnrichmentProfileGetResponses[keyof EnrichmentProfileGetResponses];
+export type EnrichmentProfilePostsData = {
+    body?: never;
+    path: {
+        /**
+         * Social platform
+         */
+        platform: "x" | "instagram" | "tiktok" | "linkedin" | "facebook" | "youtube" | "reddit";
+        /**
+         * Username or handle (without @)
+         */
+        username: string;
+    };
+    query?: {
+        /**
+         * YouTube only — selects which upload stream to fetch. Required when `platform=youtube`.
+         */
+        type?: "videos" | "shorts";
+        /**
+         * Pagination cursor for next page. One request returns one page; follow `meta.next_cursor` for deeper history.
+         */
+        cursor?: string;
+    };
+    url: "/v1/profiles/{platform}/{username}/posts";
+};
+export type EnrichmentProfilePostsResponses = {
+    /**
+     * User's posts (single page)
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type EnrichmentProfilePostsResponse = EnrichmentProfilePostsResponses[keyof EnrichmentProfilePostsResponses];
+export type EnrichmentProfileFollowingData = {
+    body?: never;
+    path: {
+        /**
+         * Social platform (x, instagram, tiktok, facebook)
+         */
+        platform: "x" | "instagram" | "tiktok" | "facebook";
+        /**
+         * Username or handle (without @)
+         */
+        username: string;
+    };
+    query?: {
+        /**
+         * Pagination cursor for the next page. One request returns one page; pass back the `meta.next_cursor` returned in the response for more.
+         */
+        cursor?: string;
+    };
+    url: "/v1/profiles/{platform}/{username}/following";
+};
+export type EnrichmentProfileFollowingResponses = {
+    /**
+     * Accounts the user follows (single page)
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type EnrichmentProfileFollowingResponse = EnrichmentProfileFollowingResponses[keyof EnrichmentProfileFollowingResponses];
+export type EnrichmentVideoTranscriptData = {
+    body?: never;
+    path: {
+        /**
+         * YouTube video ID
+         */
+        video_id: string;
+    };
+    query?: never;
+    url: "/v1/videos/{video_id}/transcript";
+};
+export type EnrichmentVideoTranscriptResponses = {
+    /**
+     * Video transcript
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type EnrichmentVideoTranscriptResponse = EnrichmentVideoTranscriptResponses[keyof EnrichmentVideoTranscriptResponses];
+export type EnrichmentCompanySearchData = {
+    body?: never;
+    path: {
+        /**
+         * Platform (linkedin and facebook supported today)
+         */
+        platform: "x" | "instagram" | "tiktok" | "linkedin" | "facebook" | "youtube" | "reddit";
+    };
+    query: {
+        /**
+         * Search query (typically a brand name)
+         */
+        q: string;
+        /**
+         * Pagination cursor for next page. One request returns one page; follow `meta.next_cursor` for more.
+         */
+        cursor?: string;
+        /**
+         * ISO 2-letter country code (Facebook / Meta Ad Library only)
+         */
+        country?: string;
+    };
+    url: "/v1/companies/{platform}/search";
+};
+export type EnrichmentCompanySearchResponses = {
+    /**
+     * Company search results (single page)
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type EnrichmentCompanySearchResponse = EnrichmentCompanySearchResponses[keyof EnrichmentCompanySearchResponses];
+export type EnrichmentCompanyGetData = {
+    body?: never;
+    path: {
+        /**
+         * Platform (linkedin supported today)
+         */
+        platform: "x" | "instagram" | "tiktok" | "linkedin" | "facebook" | "youtube" | "reddit";
+        /**
+         * Company URL, slug, or numeric identifier
+         */
+        identifier: string;
+    };
+    query?: never;
+    url: "/v1/companies/{platform}/{identifier}";
+};
+export type EnrichmentCompanyGetResponses = {
+    /**
+     * Company profile
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type EnrichmentCompanyGetResponse = EnrichmentCompanyGetResponses[keyof EnrichmentCompanyGetResponses];
+export type EnrichmentCompanyJobsData = {
+    body?: never;
+    path: {
+        /**
+         * Platform (linkedin supported today)
+         */
+        platform: "x" | "instagram" | "tiktok" | "linkedin" | "facebook" | "youtube" | "reddit";
+        /**
+         * Company URL, slug, or numeric identifier
+         */
+        identifier: string;
+    };
+    query?: {
+        /**
+         * Pagination cursor for the next page. One request returns one page; pass back the `meta.next_cursor` returned in the response for more.
+         */
+        cursor?: string;
+    };
+    url: "/v1/companies/{platform}/{identifier}/jobs";
+};
+export type EnrichmentCompanyJobsResponses = {
+    /**
+     * Company job listings
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type EnrichmentCompanyJobsResponse = EnrichmentCompanyJobsResponses[keyof EnrichmentCompanyJobsResponses];
+export type EnrichmentCompanyPeopleData = {
+    body?: never;
+    path: {
+        /**
+         * Platform (linkedin supported today)
+         */
+        platform: "x" | "instagram" | "tiktok" | "linkedin" | "facebook" | "youtube" | "reddit";
+        /**
+         * Company URL, slug, or numeric identifier
+         */
+        identifier: string;
+    };
+    query?: {
+        /**
+         * Pagination cursor for the next page. One request returns one page; pass back the `meta.next_cursor` returned in the response for more.
+         */
+        cursor?: string;
+    };
+    url: "/v1/companies/{platform}/{identifier}/people";
+};
+export type EnrichmentCompanyPeopleResponses = {
+    /**
+     * Company people
+     */
+    200: {
+        data?: unknown;
+        meta: Meta;
+    };
+};
+export type EnrichmentCompanyPeopleResponse = EnrichmentCompanyPeopleResponses[keyof EnrichmentCompanyPeopleResponses];
+export type CommunityUserPostsData = {
+    body?: never;
+    path: {
+        /**
+         * Reddit username, without the u/ prefix
+         */
+        name: string;
+    };
+    query?: {
+        /**
+         * Sort order. `range` is required when sort is TOP or CONTROVERSIAL.
+         */
+        sort?: "CONTROVERSIAL" | "HOT" | "TOP" | "NEW";
+        /**
+         * Time window. Required when sort is TOP or CONTROVERSIAL.
+         */
+        range?: "PAST_HOUR" | "TODAY" | "PAST_WEEK" | "PAST_MONTH" | "PAST_YEAR" | "ALL_TIME";
+        /**
+         * Pagination cursor. One request returns one page; follow `meta.next_cursor` for more.
+         */
+        cursor?: string;
+    };
+    url: "/v1/communities/reddit/users/{name}/posts";
+};
+export type CommunityUserPostsResponses = {
+    /**
+     * A page of the user's posts
+     */
+    200: {
+        data: {
+            items: Array<NormalizedPost>;
+        };
+        meta: Meta;
+    };
+};
+export type CommunityUserPostsResponse = CommunityUserPostsResponses[keyof CommunityUserPostsResponses];
+export type CommunityUserCommentsData = {
+    body?: never;
+    path: {
+        /**
+         * Reddit username, without the u/ prefix
+         */
+        name: string;
+    };
+    query?: {
+        /**
+         * Pagination cursor. One request returns one page; follow `meta.next_cursor` for more.
+         */
+        cursor?: string;
+    };
+    url: "/v1/communities/reddit/users/{name}/comments";
+};
+export type CommunityUserCommentsResponses = {
+    /**
+     * A page of the user's comments
+     */
+    200: {
+        data: {
+            items: Array<RedditComment>;
+        };
+        meta: Meta;
+    };
+};
+export type CommunityUserCommentsResponse = CommunityUserCommentsResponses[keyof CommunityUserCommentsResponses];
+export type CommunityPostsData = {
+    body?: never;
+    path: {
+        /**
+         * Subreddit name, without the r/ prefix
+         */
+        name: string;
+    };
+    query?: {
+        /**
+         * Feed sort order. `range` is required when sort is TOP or CONTROVERSIAL.
+         */
+        sort?: "BEST" | "HOT" | "NEW" | "TOP" | "CONTROVERSIAL" | "RISING";
+        /**
+         * Time window. Required when sort is TOP or CONTROVERSIAL.
+         */
+        range?: "PAST_HOUR" | "TODAY" | "PAST_WEEK" | "PAST_MONTH" | "PAST_YEAR" | "ALL_TIME";
+        /**
+         * Pagination cursor. One request returns one page; follow `meta.next_cursor` for more.
+         */
+        cursor?: string;
+    };
+    url: "/v1/communities/reddit/{name}/posts";
+};
+export type CommunityPostsResponses = {
+    /**
+     * A page of subreddit posts
+     */
+    200: {
+        data: {
+            items: Array<NormalizedPost>;
+        };
+        meta: Meta;
+    };
+};
+export type CommunityPostsResponse = CommunityPostsResponses[keyof CommunityPostsResponses];
+export type CommunityGetData = {
+    body?: never;
+    path: {
+        /**
+         * Subreddit name, without the r/ prefix
+         */
+        name: string;
+    };
+    query?: never;
+    url: "/v1/communities/reddit/{name}";
+};
+export type CommunityGetResponses = {
+    /**
+     * Subreddit metadata
+     */
+    200: {
+        data: RedditSubredditDetails;
+        meta: Meta;
+    };
+};
+export type CommunityGetResponse = CommunityGetResponses[keyof CommunityGetResponses];
+export type GetV1BrandSearchData = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Search query (required)
+         */
+        q: string;
+        /**
+         * Filter to a specific brand
+         */
+        brand_id?: string;
+        /**
+         * Filter to brands in a category
+         */
+        category_id?: string;
+        /**
+         * Filter by platform (e.g. instagram, tiktok, twitter)
+         */
+        platform?: string;
+        /**
+         * Filter by dataset: owned_media (brand-published) or mentions (earned/mention)
+         */
+        dataset?: "owned_media" | "mentions";
+        /**
+         * Filter posts on or after this date (ISO 8601)
+         */
+        start_date?: string;
+        /**
+         * Filter posts on or before this date (ISO 8601)
+         */
+        end_date?: string;
+        /**
+         * Maximum number of results to return (1–100)
+         */
+        limit?: number;
+        /**
+         * Cursor for pagination — pass meta.next_cursor from the previous response
+         */
+        cursor?: string;
+    };
+    url: "/v1/brand-search";
+};
+export type GetV1BrandSearchErrors = {
+    /**
+     * Invalid search query
+     */
+    400: Error;
+};
+export type GetV1BrandSearchError = GetV1BrandSearchErrors[keyof GetV1BrandSearchErrors];
+export type GetV1BrandSearchResponses = {
+    /**
+     * Search results ranked by relevance
+     */
+    200: {
+        data: Array<SearchResult>;
+        meta: Meta;
+    };
+};
+export type GetV1BrandSearchResponse = GetV1BrandSearchResponses[keyof GetV1BrandSearchResponses];
+export type GetV1AccountData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: "/v1/account";
+};
+export type GetV1AccountResponses = {
+    /**
+     * Account profile
+     */
+    200: {
+        data: AccountProfile;
+        meta: Meta;
+    };
+};
+export type GetV1AccountResponse = GetV1AccountResponses[keyof GetV1AccountResponses];
+export type GetV1AccountBalanceData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: "/v1/account/balance";
+};
+export type GetV1AccountBalanceResponses = {
+    /**
+     * Credit balance
+     */
+    200: {
+        data: AccountBalance;
+        meta: Meta;
+    };
+};
+export type GetV1AccountBalanceResponse = GetV1AccountBalanceResponses[keyof GetV1AccountBalanceResponses];
+export type GetV1AccountUsageData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: "/v1/account/usage";
+};
+export type GetV1AccountUsageResponses = {
+    /**
+     * Usage breakdown
+     */
+    200: {
+        data: AccountUsage;
+        meta: Meta;
+    };
+};
+export type GetV1AccountUsageResponse = GetV1AccountUsageResponses[keyof GetV1AccountUsageResponses];
+export type TeamListData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Substring match on name or team_id
+         */
+        query?: string;
+        creditFilter?: "ALL" | "UNLIMITED";
+        limit?: number;
+        offset?: number | null;
+    };
+    url: "/v1/teams";
+};
+export type TeamListErrors = {
+    /**
+     * Admin required
+     */
+    403: Error;
+};
+export type TeamListError = TeamListErrors[keyof TeamListErrors];
+export type TeamListResponses = {
+    /**
+     * Teams listed
+     */
+    200: {
+        data: Array<AdminTeamRow>;
+        /**
+         * True when more rows exist past the returned page. Increment offset by limit to fetch the next page.
+         */
+        hasMore: boolean;
+    };
+};
+export type TeamListResponse = TeamListResponses[keyof TeamListResponses];
+export type TeamCreateData = {
+    body?: {
+        name: string;
+        slug: string;
+        autoInviteDomain?: string;
+        /**
+         * Override default billable=true. Pass false for an unlimited-credits team.
+         */
+        billable?: boolean;
+    };
+    path?: never;
+    query?: never;
+    url: "/v1/teams";
+};
+export type TeamCreateErrors = {
+    /**
+     * Admin required
+     */
+    403: Error;
+};
+export type TeamCreateError = TeamCreateErrors[keyof TeamCreateErrors];
+export type TeamCreateResponses = {
+    /**
+     * Team created
+     */
+    201: {
+        data: AdminTeamRow;
+    };
+};
+export type TeamCreateResponse = TeamCreateResponses[keyof TeamCreateResponses];
+export type TeamGetData = {
+    body?: never;
+    path: {
+        team_id: number;
+    };
+    query?: never;
+    url: "/v1/teams/{team_id}";
+};
+export type TeamGetErrors = {
+    /**
+     * Admin required
+     */
+    403: Error;
+    /**
+     * Team not found
+     */
+    404: Error;
+};
+export type TeamGetError = TeamGetErrors[keyof TeamGetErrors];
+export type TeamGetResponses = {
+    /**
+     * Team
+     */
+    200: {
+        data: AdminTeamRow;
+    };
+};
+export type TeamGetResponse = TeamGetResponses[keyof TeamGetResponses];
+export type TeamSetBillableData = {
+    body?: {
+        billable: boolean;
+    };
+    path: {
+        team_id: number;
+    };
+    query?: never;
+    url: "/v1/teams/{team_id}/billable";
+};
+export type TeamSetBillableErrors = {
+    /**
+     * Admin required
+     */
+    403: Error;
+};
+export type TeamSetBillableError = TeamSetBillableErrors[keyof TeamSetBillableErrors];
+export type TeamSetBillableResponses = {
+    /**
+     * Team updated
+     */
+    200: {
+        data: AdminTeamRow;
+    };
+};
+export type TeamSetBillableResponse = TeamSetBillableResponses[keyof TeamSetBillableResponses];
+export type TeamListFlagsData = {
+    body?: never;
+    path: {
+        team_id: number;
+    };
+    query?: never;
+    url: "/v1/teams/{team_id}/flags";
+};
+export type TeamListFlagsErrors = {
+    /**
+     * Admin required
+     */
+    403: Error;
+};
+export type TeamListFlagsError = TeamListFlagsErrors[keyof TeamListFlagsErrors];
+export type TeamListFlagsResponses = {
+    /**
+     * Flags listed
+     */
+    200: {
+        data: Array<TeamFlagRow>;
+    };
+};
+export type TeamListFlagsResponse = TeamListFlagsResponses[keyof TeamListFlagsResponses];
+export type TeamSetFlagData = {
+    body?: {
+        flag: string;
+        enabled: boolean;
+    };
+    path: {
+        team_id: number;
+    };
+    query?: never;
+    url: "/v1/teams/{team_id}/flags";
+};
+export type TeamSetFlagErrors = {
+    /**
+     * Bad flag name
+     */
+    400: Error;
+    /**
+     * Admin required
+     */
+    403: Error;
+};
+export type TeamSetFlagError = TeamSetFlagErrors[keyof TeamSetFlagErrors];
+export type TeamSetFlagResponses = {
+    /**
+     * Flag set
+     */
+    200: {
+        data: TeamFlagRow;
+    };
+};
+export type TeamSetFlagResponse = TeamSetFlagResponses[keyof TeamSetFlagResponses];
+//# sourceMappingURL=types.gen.d.ts.map