@openrouter/sdk 0.12.79 → 0.13.7

package/esm/models/operations/getanalyticsmeta.js

@@ -0,0 +1,141 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 55adc33e474c
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import * as openEnums from "../../types/enums.js";
+/**
+ * Granularity identifier
+ */
+export const GranularityName = {
+    Minute: "minute",
+    Hour: "hour",
+    Day: "day",
+    Week: "week",
+    Month: "month",
+};
+/**
+ * How this metric value should be formatted for display (e.g. percent → multiply by 100 and append %, currency → prefix with $)
+ */
+export const DisplayFormat = {
+    Number: "number",
+    Currency: "currency",
+    Percent: "percent",
+    Latency: "latency",
+    Throughput: "throughput",
+};
+/**
+ * Operator identifier used in filter definitions
+ */
+export const OperatorName = {
+    Eq: "eq",
+    Neq: "neq",
+    In: "in",
+    NotIn: "not_in",
+    Gt: "gt",
+    Gte: "gte",
+    Lt: "lt",
+    Lte: "lte",
+};
+/**
+ * Whether the operator expects a single value or an array
+ */
+export const ValueType = {
+    Scalar: "scalar",
+    Array: "array",
+};
+/** @internal */
+export const GetAnalyticsMetaRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+    });
+});
+export function getAnalyticsMetaRequestToJSON(getAnalyticsMetaRequest) {
+    return JSON.stringify(GetAnalyticsMetaRequest$outboundSchema.parse(getAnalyticsMetaRequest));
+}
+/** @internal */
+export const Dimension$inboundSchema = z.object({
+    display_label: z.string(),
+    name: z.string(),
+}).transform((v) => {
+    return remap$(v, {
+        "display_label": "displayLabel",
+    });
+});
+export function dimensionFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => Dimension$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'Dimension' from JSON`);
+}
+/** @internal */
+export const GranularityName$inboundSchema = openEnums.inboundSchema(GranularityName);
+/** @internal */
+export const Granularity$inboundSchema = z
+    .object({
+    display_label: z.string(),
+    name: GranularityName$inboundSchema,
+}).transform((v) => {
+    return remap$(v, {
+        "display_label": "displayLabel",
+    });
+});
+export function granularityFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => Granularity$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'Granularity' from JSON`);
+}
+/** @internal */
+export const DisplayFormat$inboundSchema = openEnums.inboundSchema(DisplayFormat);
+/** @internal */
+export const Metric$inboundSchema = z.object({
+    display_format: DisplayFormat$inboundSchema,
+    display_label: z.string(),
+    is_rate: z.boolean(),
+    name: z.string(),
+}).transform((v) => {
+    return remap$(v, {
+        "display_format": "displayFormat",
+        "display_label": "displayLabel",
+        "is_rate": "isRate",
+    });
+});
+export function metricFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => Metric$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'Metric' from JSON`);
+}
+/** @internal */
+export const OperatorName$inboundSchema = openEnums.inboundSchema(OperatorName);
+/** @internal */
+export const ValueType$inboundSchema = openEnums
+    .inboundSchema(ValueType);
+/** @internal */
+export const Operator$inboundSchema = z.object({
+    name: OperatorName$inboundSchema,
+    value_type: ValueType$inboundSchema,
+}).transform((v) => {
+    return remap$(v, {
+        "value_type": "valueType",
+    });
+});
+export function operatorFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => Operator$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'Operator' from JSON`);
+}
+/** @internal */
+export const GetAnalyticsMetaData$inboundSchema = z.object({
+    dimensions: z.array(z.lazy(() => Dimension$inboundSchema)),
+    granularities: z.array(z.lazy(() => Granularity$inboundSchema)),
+    metrics: z.array(z.lazy(() => Metric$inboundSchema)),
+    operators: z.array(z.lazy(() => Operator$inboundSchema)),
+});
+export function getAnalyticsMetaDataFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => GetAnalyticsMetaData$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'GetAnalyticsMetaData' from JSON`);
+}
+/** @internal */
+export const GetAnalyticsMetaResponse$inboundSchema = z.object({
+    data: z.lazy(() => GetAnalyticsMetaData$inboundSchema),
+});
+export function getAnalyticsMetaResponseFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => GetAnalyticsMetaResponse$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'GetAnalyticsMetaResponse' from JSON`);
+}
+//# sourceMappingURL=getanalyticsmeta.js.map

package/esm/models/operations/getapprankings.d.ts

@@ -0,0 +1,152 @@
+import * as z from "zod/v4";
+import { OpenEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import * as models from "../index.js";
+export type GetAppRankingsGlobals = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+};
+/**
+ * Marketplace category group to filter by (e.g. `coding`). Only apps tagged with a subcategory inside this group are returned. Mutually combinable with `subcategory` — when both are supplied the `subcategory` must belong to the `category` group.
+ */
+export declare const GetAppRankingsCategory: {
+    readonly Coding: "coding";
+    readonly Creative: "creative";
+    readonly Productivity: "productivity";
+    readonly Entertainment: "entertainment";
+};
+/**
+ * Marketplace category group to filter by (e.g. `coding`). Only apps tagged with a subcategory inside this group are returned. Mutually combinable with `subcategory` — when both are supplied the `subcategory` must belong to the `category` group.
+ */
+export type GetAppRankingsCategory = OpenEnum<typeof GetAppRankingsCategory>;
+/**
+ * Marketplace subcategory to filter by (e.g. `cli-agent`). Takes precedence over `category` for the actual filter; when `category` is also supplied the pair must be consistent.
+ */
+export declare const Subcategory: {
+    readonly CliAgent: "cli-agent";
+    readonly IdeExtension: "ide-extension";
+    readonly CloudAgent: "cloud-agent";
+    readonly ProgrammingApp: "programming-app";
+    readonly NativeAppBuilder: "native-app-builder";
+    readonly CreativeWriting: "creative-writing";
+    readonly VideoGen: "video-gen";
+    readonly ImageGen: "image-gen";
+    readonly AudioGen: "audio-gen";
+    readonly Roleplay: "roleplay";
+    readonly Game: "game";
+    readonly WritingAssistant: "writing-assistant";
+    readonly GeneralChat: "general-chat";
+    readonly PersonalAgent: "personal-agent";
+    readonly Legal: "legal";
+};
+/**
+ * Marketplace subcategory to filter by (e.g. `cli-agent`). Takes precedence over `category` for the actual filter; when `category` is also supplied the pair must be consistent.
+ */
+export type Subcategory = OpenEnum<typeof Subcategory>;
+/**
+ * `popular` ranks apps by total token volume inside the date window. `trending` ranks apps by absolute excess token growth: window volume minus the average volume of the three equal-length periods immediately preceding the window. Apps with no excess growth are omitted from `trending` results.
+ */
+export declare const GetAppRankingsSort: {
+    readonly Popular: "popular";
+    readonly Trending: "trending";
+};
+/**
+ * `popular` ranks apps by total token volume inside the date window. `trending` ranks apps by absolute excess token growth: window volume minus the average volume of the three equal-length periods immediately preceding the window. Apps with no excess growth are omitted from `trending` results.
+ */
+export type GetAppRankingsSort = OpenEnum<typeof GetAppRankingsSort>;
+export type GetAppRankingsRequest = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+    /**
+     * Marketplace category group to filter by (e.g. `coding`). Only apps tagged with a subcategory inside this group are returned. Mutually combinable with `subcategory` — when both are supplied the `subcategory` must belong to the `category` group.
+     */
+    category?: GetAppRankingsCategory | undefined;
+    /**
+     * Marketplace subcategory to filter by (e.g. `cli-agent`). Takes precedence over `category` for the actual filter; when `category` is also supplied the pair must be consistent.
+     */
+    subcategory?: Subcategory | undefined;
+    /**
+     * `popular` ranks apps by total token volume inside the date window. `trending` ranks apps by absolute excess token growth: window volume minus the average volume of the three equal-length periods immediately preceding the window. Apps with no excess growth are omitted from `trending` results.
+     */
+    sort?: GetAppRankingsSort | undefined;
+    /**
+     * Start of the date window in YYYY-MM-DD (UTC), inclusive. Defaults to 30 days before `end_date`. The dataset begins at 2025-01-01; earlier values are clamped forward to that floor and the resolved value is echoed in `meta.start_date`.
+     */
+    startDate?: string | undefined;
+    /**
+     * End of the date window in YYYY-MM-DD (UTC), inclusive. Defaults to the most recent completed UTC day. Must be on or after 2025-01-01; earlier values are rejected with a 400.
+     */
+    endDate?: string | undefined;
+    /**
+     * Maximum number of apps to return (1-100). Defaults to 50.
+     */
+    limit?: number | undefined;
+    /**
+     * Number of ranked apps to skip before the first returned row (0-100). Defaults to 0. `rank` stays absolute, so the first row of `offset=50` is `rank: 51`.
+     */
+    offset?: number | null | undefined;
+};
+export type GetAppRankingsResponse = {
+    result: models.AppRankingsResponse;
+};
+/** @internal */
+export declare const GetAppRankingsCategory$outboundSchema: z.ZodType<string, GetAppRankingsCategory>;
+/** @internal */
+export declare const Subcategory$outboundSchema: z.ZodType<string, Subcategory>;
+/** @internal */
+export declare const GetAppRankingsSort$outboundSchema: z.ZodType<string, GetAppRankingsSort>;
+/** @internal */
+export type GetAppRankingsRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    category?: string | undefined;
+    subcategory?: string | undefined;
+    sort: string;
+    start_date?: string | undefined;
+    end_date?: string | undefined;
+    limit: number;
+    offset: number | null;
+};
+/** @internal */
+export declare const GetAppRankingsRequest$outboundSchema: z.ZodType<GetAppRankingsRequest$Outbound, GetAppRankingsRequest>;
+export declare function getAppRankingsRequestToJSON(getAppRankingsRequest: GetAppRankingsRequest): string;
+/** @internal */
+export declare const GetAppRankingsResponse$inboundSchema: z.ZodType<GetAppRankingsResponse, unknown>;
+export declare function getAppRankingsResponseFromJSON(jsonString: string): SafeParseResult<GetAppRankingsResponse, SDKValidationError>;
+//# sourceMappingURL=getapprankings.d.ts.map

package/esm/models/operations/getapprankings.js

@@ -0,0 +1,85 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: edd3364e84c1
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import * as openEnums from "../../types/enums.js";
+import * as models from "../index.js";
+/**
+ * Marketplace category group to filter by (e.g. `coding`). Only apps tagged with a subcategory inside this group are returned. Mutually combinable with `subcategory` — when both are supplied the `subcategory` must belong to the `category` group.
+ */
+export const GetAppRankingsCategory = {
+    Coding: "coding",
+    Creative: "creative",
+    Productivity: "productivity",
+    Entertainment: "entertainment",
+};
+/**
+ * Marketplace subcategory to filter by (e.g. `cli-agent`). Takes precedence over `category` for the actual filter; when `category` is also supplied the pair must be consistent.
+ */
+export const Subcategory = {
+    CliAgent: "cli-agent",
+    IdeExtension: "ide-extension",
+    CloudAgent: "cloud-agent",
+    ProgrammingApp: "programming-app",
+    NativeAppBuilder: "native-app-builder",
+    CreativeWriting: "creative-writing",
+    VideoGen: "video-gen",
+    ImageGen: "image-gen",
+    AudioGen: "audio-gen",
+    Roleplay: "roleplay",
+    Game: "game",
+    WritingAssistant: "writing-assistant",
+    GeneralChat: "general-chat",
+    PersonalAgent: "personal-agent",
+    Legal: "legal",
+};
+/**
+ * `popular` ranks apps by total token volume inside the date window. `trending` ranks apps by absolute excess token growth: window volume minus the average volume of the three equal-length periods immediately preceding the window. Apps with no excess growth are omitted from `trending` results.
+ */
+export const GetAppRankingsSort = {
+    Popular: "popular",
+    Trending: "trending",
+};
+/** @internal */
+export const GetAppRankingsCategory$outboundSchema = openEnums.outboundSchema(GetAppRankingsCategory);
+/** @internal */
+export const Subcategory$outboundSchema = openEnums.outboundSchema(Subcategory);
+/** @internal */
+export const GetAppRankingsSort$outboundSchema = openEnums.outboundSchema(GetAppRankingsSort);
+/** @internal */
+export const GetAppRankingsRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+    category: GetAppRankingsCategory$outboundSchema.optional(),
+    subcategory: Subcategory$outboundSchema.optional(),
+    sort: GetAppRankingsSort$outboundSchema.default("popular"),
+    startDate: z.string().optional(),
+    endDate: z.string().optional(),
+    limit: z.int().default(50),
+    offset: z.nullable(z.int().default(0)),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+        startDate: "start_date",
+        endDate: "end_date",
+    });
+});
+export function getAppRankingsRequestToJSON(getAppRankingsRequest) {
+    return JSON.stringify(GetAppRankingsRequest$outboundSchema.parse(getAppRankingsRequest));
+}
+/** @internal */
+export const GetAppRankingsResponse$inboundSchema = z.object({
+    Result: models.AppRankingsResponse$inboundSchema,
+}).transform((v) => {
+    return remap$(v, {
+        "Result": "result",
+    });
+});
+export function getAppRankingsResponseFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => GetAppRankingsResponse$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'GetAppRankingsResponse' from JSON`);
+}
+//# sourceMappingURL=getapprankings.js.map

package/esm/models/operations/getbenchmarksartificialanalysis.d.ts

@@ -0,0 +1,58 @@
+import * as z from "zod/v4";
+export type GetBenchmarksArtificialAnalysisGlobals = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+};
+export type GetBenchmarksArtificialAnalysisRequest = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+    /**
+     * Max results to return (1–100, default 50).
+     */
+    maxResults?: number | undefined;
+};
+/** @internal */
+export type GetBenchmarksArtificialAnalysisRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    max_results: number;
+};
+/** @internal */
+export declare const GetBenchmarksArtificialAnalysisRequest$outboundSchema: z.ZodType<GetBenchmarksArtificialAnalysisRequest$Outbound, GetBenchmarksArtificialAnalysisRequest>;
+export declare function getBenchmarksArtificialAnalysisRequestToJSON(getBenchmarksArtificialAnalysisRequest: GetBenchmarksArtificialAnalysisRequest): string;
+//# sourceMappingURL=getbenchmarksartificialanalysis.d.ts.map

package/esm/models/operations/getbenchmarksartificialanalysis.js

@@ -0,0 +1,22 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1b7863e0088a
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+/** @internal */
+export const GetBenchmarksArtificialAnalysisRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+    maxResults: z.int().default(50),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+        maxResults: "max_results",
+    });
+});
+export function getBenchmarksArtificialAnalysisRequestToJSON(getBenchmarksArtificialAnalysisRequest) {
+    return JSON.stringify(GetBenchmarksArtificialAnalysisRequest$outboundSchema.parse(getBenchmarksArtificialAnalysisRequest));
+}
+//# sourceMappingURL=getbenchmarksartificialanalysis.js.map

package/esm/models/operations/getbenchmarksdesignarena.d.ts

@@ -0,0 +1,83 @@
+import * as z from "zod/v4";
+import { OpenEnum } from "../../types/enums.js";
+export type GetBenchmarksDesignArenaGlobals = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+};
+/**
+ * Arena to query. Defaults to `models`.
+ */
+export declare const Arena: {
+    readonly Models: "models";
+    readonly Builders: "builders";
+    readonly Agents: "agents";
+};
+/**
+ * Arena to query. Defaults to `models`.
+ */
+export type Arena = OpenEnum<typeof Arena>;
+export type GetBenchmarksDesignArenaRequest = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+    /**
+     * Arena to query. Defaults to `models`.
+     */
+    arena?: Arena | undefined;
+    /**
+     * Category within the arena (e.g. `codecategories`, `uicomponent`, `gamedev`, `3d`, `dataviz`, `image`, `video`, `svg`). When omitted, returns all categories.
+     */
+    category?: string | undefined;
+    /**
+     * Max results to return: per category when no category filter is applied (1–100, default 50).
+     */
+    maxResults?: number | undefined;
+};
+/** @internal */
+export declare const Arena$outboundSchema: z.ZodType<string, Arena>;
+/** @internal */
+export type GetBenchmarksDesignArenaRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    arena: string;
+    category?: string | undefined;
+    max_results: number;
+};
+/** @internal */
+export declare const GetBenchmarksDesignArenaRequest$outboundSchema: z.ZodType<GetBenchmarksDesignArenaRequest$Outbound, GetBenchmarksDesignArenaRequest>;
+export declare function getBenchmarksDesignArenaRequestToJSON(getBenchmarksDesignArenaRequest: GetBenchmarksDesignArenaRequest): string;
+//# sourceMappingURL=getbenchmarksdesignarena.d.ts.map

package/esm/models/operations/getbenchmarksdesignarena.js

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 86e27de57b33
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+import * as openEnums from "../../types/enums.js";
+/**
+ * Arena to query. Defaults to `models`.
+ */
+export const Arena = {
+    Models: "models",
+    Builders: "builders",
+    Agents: "agents",
+};
+/** @internal */
+export const Arena$outboundSchema = openEnums
+    .outboundSchema(Arena);
+/** @internal */
+export const GetBenchmarksDesignArenaRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+    arena: Arena$outboundSchema.default("models"),
+    category: z.string().optional(),
+    maxResults: z.int().default(50),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+        maxResults: "max_results",
+    });
+});
+export function getBenchmarksDesignArenaRequestToJSON(getBenchmarksDesignArenaRequest) {
+    return JSON.stringify(GetBenchmarksDesignArenaRequest$outboundSchema.parse(getBenchmarksDesignArenaRequest));
+}
+//# sourceMappingURL=getbenchmarksdesignarena.js.map

package/esm/models/operations/getfilemetadata.d.ts

@@ -0,0 +1,60 @@
+import * as z from "zod/v4";
+export type GetFileMetadataGlobals = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+};
+export type GetFileMetadataRequest = {
+    /**
+     * The app identifier should be your app's URL and is used as the primary identifier for rankings.
+     *
+     * @remarks
+     * This is used to track API usage per application.
+     */
+    httpReferer?: string | undefined;
+    /**
+     * The app display name allows you to customize how your app appears in OpenRouter's dashboard.
+     *
+     * @remarks
+     */
+    appTitle?: string | undefined;
+    /**
+     * Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.
+     *
+     * @remarks
+     */
+    appCategories?: string | undefined;
+    fileId: string;
+    /**
+     * Workspace to scope the request to. Defaults to the caller’s default workspace.
+     */
+    workspaceId?: string | undefined;
+};
+/** @internal */
+export type GetFileMetadataRequest$Outbound = {
+    "HTTP-Referer"?: string | undefined;
+    appTitle?: string | undefined;
+    appCategories?: string | undefined;
+    file_id: string;
+    workspace_id?: string | undefined;
+};
+/** @internal */
+export declare const GetFileMetadataRequest$outboundSchema: z.ZodType<GetFileMetadataRequest$Outbound, GetFileMetadataRequest>;
+export declare function getFileMetadataRequestToJSON(getFileMetadataRequest: GetFileMetadataRequest): string;
+//# sourceMappingURL=getfilemetadata.d.ts.map

package/esm/models/operations/getfilemetadata.js

@@ -0,0 +1,24 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: accbd0757579
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../../lib/primitives.js";
+/** @internal */
+export const GetFileMetadataRequest$outboundSchema = z.object({
+    httpReferer: z.string().optional(),
+    appTitle: z.string().optional(),
+    appCategories: z.string().optional(),
+    fileId: z.string(),
+    workspaceId: z.string().optional(),
+}).transform((v) => {
+    return remap$(v, {
+        httpReferer: "HTTP-Referer",
+        fileId: "file_id",
+        workspaceId: "workspace_id",
+    });
+});
+export function getFileMetadataRequestToJSON(getFileMetadataRequest) {
+    return JSON.stringify(GetFileMetadataRequest$outboundSchema.parse(getFileMetadataRequest));
+}
+//# sourceMappingURL=getfilemetadata.js.map