onlyfansapi · stainless-app · May 25, 2026 · May 25, 2026 · May 25, 2026 · May 25, 2026
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.2.0"
+  ".": "0.3.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 266
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/onlyfansapi/onlyfansapi-b9b67bf32f2b519e3230760d49e20c30e66107a6991f1a1f1a108f6c578c2fde.yml
-openapi_spec_hash: da475361c28b843ddd1b45bbea333762
-config_hash: a522aab696c4535f715ae59ddfe8222f
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/onlyfansapi/onlyfansapi-74609107d9bbe47ca001712873c4449f6657c5539e4e83c398f672b7d4439749.yml
+openapi_spec_hash: 0ced1a38864fe0442a4089920de41e5f
+config_hash: 397c91e15c0024f8b5bbed9b82c2348c
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,63 @@
 # Changelog
 
+## 0.3.0 (2026-06-14)
+
+Full Changelog: [v0.2.0...v0.3.0](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/compare/v0.2.0...v0.3.0)
+
+### Features
+
+* **api:** api update ([980ff36](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/980ff369e0ef08500ae478ded5a232da7f38b5ed))
+* **api:** api update ([b25bee6](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/b25bee6f69bce712a4937386383ccec055309f39))
+* **api:** api update ([5a77418](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/5a77418eb4f2058adb334944d241e7b91f3711c7))
+* **api:** api update ([4a111d4](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/4a111d4f097391fdc6dc920ba1606c0d8621708a))
+* **api:** api update ([a43dc12](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/a43dc1250b1a5933fa4af5a965447b93fc14e793))
+* **api:** api update ([f0b9fb8](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/f0b9fb8ad5624c01e220df4381cc37a1213a1692))
+* **api:** api update ([ca21354](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/ca2135486d6ca505afe5c49142f29adc7e227fa3))
+* **api:** api update ([01c6418](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/01c6418872a4dc0595e42f781d03386a82bff9be))
+* **api:** api update ([057180b](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/057180b905228cbb29c753be8ecac5683c600dd0))
+* **api:** api update ([a48a7e2](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/a48a7e23be200f80b19c72e4b2c82f974cec1117))
+* **api:** api update ([f9977f2](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/f9977f213c80713606e9cfc600e15c7383e4644f))
+* **api:** api update ([aee1709](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/aee1709a9d39bd78be1db9aaaf0e3a2497a45f83))
+* **api:** api update ([66e39a4](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/66e39a42bb0d0c4bb70d0450f0cbff98cc45fe5c))
+* **api:** api update ([9ca88c4](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/9ca88c44a83eb4ab893c19c433044176fcc479d1))
+* **api:** api update ([59cc52a](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/59cc52af2ecf36763f5d1f06c7bba9a55519141e))
+* **api:** api update ([bc7b763](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/bc7b763675ba43a49f8cab78a30255866c35e4b2))
+* **api:** api update ([710d78e](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/710d78e95405788e056f3a338a2d8fd772a26eee))
+* **api:** api update ([3bdb33f](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/3bdb33f46ecd9a661a99ffbe1eeb4ce7ddfb57cb))
+* **api:** api update ([0d0c1dc](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/0d0c1dcf0720c6f4ef56779a1c4e6f2fad1a33c3))
+* **api:** api update ([8d3c93c](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/8d3c93c186cb7a11fd84226957137a7505e045d7))
+* **api:** api update ([0017f6f](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/0017f6f209548fe6a8ead615b86b913a6df7baf1))
+* **api:** api update ([1f119f5](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/1f119f566c1f540f8a466d371fb6956ceecce30a))
+* **api:** api update ([a79343d](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/a79343d9a35f5a31e3d29320e1588e1d3c529f10))
+* **api:** api update ([8ebf680](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/8ebf680384a856aed45875ae4453bb594d8316c6))
+* **api:** api update ([8b449c4](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/8b449c44c869ab90ada7acc26123d58bfc083f1f))
+* **api:** api update ([4b821d9](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/4b821d974a38d50ae58321f62a83cd6c62998bb5))
+* **api:** api update ([3dbb7ca](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/3dbb7ca5c9b27baa4a7be982f69394a683db7090))
+* **api:** api update ([4019fcb](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/4019fcbe6b6fdcc117c6b8dabc174ab166498520))
+* **api:** api update ([ebdc5d4](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/ebdc5d46ba1bec74cc573fafff2d20ac4849db76))
+* **api:** api update ([1de2a95](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/1de2a952889d464577df810a8da0d7af3bbc1c7c))
+* **api:** api update ([b5ac8cc](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/b5ac8ccaa35aab1bfd6c8d391a9cb42302a4849a))
+* **api:** api update ([882ec77](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/882ec779a553bf8f0d1db0ca35ef2609c5a8078c))
+* **api:** api update ([4eec03f](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/4eec03ff386d8c64bd83285865c82bb061bf70a6))
+* **api:** api update ([3df5007](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/3df5007c69007088fc11a9aa01fb31088d9b5206))
+* **api:** api update ([3d8f2c4](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/3d8f2c4ca4509051e645536e656d82dadc9a20f2))
+* **api:** api update ([ac2d398](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/ac2d39857ba083470553fab82c27f940926081b6))
+* **api:** api update ([5ffb97d](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/5ffb97d9f3802d47f115a57bee40f3581801a3cd))
+* **api:** api update ([c2bc00b](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/c2bc00b282aca8daa45b24e6f4dc0fe66a606af4))
+* **api:** api update ([864ab2a](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/864ab2a56a9233228eb3053c0126794e1ae58182))
+* **api:** api update ([21aaa90](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/21aaa9051c98389cd43e3ed577b1a55dc90c1cdd))
+* **api:** api update ([a514bd1](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/a514bd1af8d12749bf37af858f70087126d6efbf))
+* **api:** api update ([83acb2e](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/83acb2edc04277e8494e469cd596cec1faa4ed81))
+* **api:** api update ([ad300ac](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/ad300ac3fb405cebd716bdd0e28d40b419ca6012))
+* **api:** api update ([3974622](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/39746225a5043e7b0861eda2ef1f491f6407da3a))
+* **api:** api update ([4dc96ad](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/4dc96addfdd7e241dcfcb967cd4c237ad417b85a))
+* **api:** api update ([2ba0e5f](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/2ba0e5f5ee52365b833d6904268201f398aaa001))
+* **api:** api update ([1312108](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/131210835bbd489c99ed6056302e0e1c30b0de12))
+* **api:** api update ([ff87eb3](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/ff87eb31769d1fa7de42185fd8089f543809a6b5))
+* **api:** api update ([efe94c1](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/efe94c163c71dbf361316438c01dff00fb2d87d8))
+* **api:** api update ([2894f2a](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/2894f2a7ecb37a33faf9f9e7b128c14e9bb0c518))
+* **api:** api update ([7466589](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/commit/74665892091c8009dc04edf23fea6acb36eda70d))
+
 ## 0.2.0 (2026-05-25)
 
 Full Changelog: [v0.1.1...v0.2.0](https://github.com/onlyfansapi/onlyfansapi-typescript-sdk/compare/v0.1.1...v0.2.0)

diff --git a/api.md b/api.md
@@ -431,13 +431,12 @@ Methods:
 
 Types:
 
-- <code><a href="./src/resources/media/media.ts">MediaDownloadResponse</a></code>
 - <code><a href="./src/resources/media/media.ts">MediaScrapeResponse</a></code>
 - <code><a href="./src/resources/media/media.ts">MediaUploadResponse</a></code>
 
 Methods:
 
-- <code title="get /api/{account}/media/download/{cdnUrl}">client.media.<a href="./src/resources/media/media.ts">download</a>(cdnURL, { ...params }) -> string</code>
+- <code title="get /api/{account}/media/download/{cdnUrl}">client.media.<a href="./src/resources/media/media.ts">download</a>(cdnURL, { ...params }) -> void</code>
 - <code title="post /api/{account}/media/scrape">client.media.<a href="./src/resources/media/media.ts">scrape</a>(account, { ...params }) -> MediaScrapeResponse</code>
 - <code title="post /api/{account}/media/upload">client.media.<a href="./src/resources/media/media.ts">upload</a>(account, { ...params }) -> MediaUploadResponse</code>
 

diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@onlyfansapi/onlyfans-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "The official TypeScript library for the Only Fans API API",
   "author": "Only Fans API <hello@onlyfansapi.com>",
   "types": "dist/index.d.ts",

diff --git a/src/client.ts b/src/client.ts
@@ -256,7 +256,6 @@ import {
 import {
   Media,
   MediaDownloadParams,
-  MediaDownloadResponse,
   MediaScrapeParams,
   MediaScrapeResponse,
   MediaUploadParams,
@@ -1147,7 +1146,7 @@ export class OnlyFansAPI {
   trialLinks: API.TrialLinks = new API.TrialLinks(this);
   giphy: API.Giphy = new API.Giphy(this);
   /**
-   * APIs for managing tags on free trial links and tracking links
+   * APIs for managing tags on free trial links, tracking links, and Smart Links
    */
   linkTags: API.LinkTags = new API.LinkTags(this);
   massMessaging: API.MassMessaging = new API.MassMessaging(this);
@@ -1430,7 +1429,6 @@ export declare namespace OnlyFansAPI {
 
   export {
     Media as Media,
-    type MediaDownloadResponse as MediaDownloadResponse,
     type MediaScrapeResponse as MediaScrapeResponse,
     type MediaUploadResponse as MediaUploadResponse,
     type MediaDownloadParams as MediaDownloadParams,

diff --git a/src/resources/accounts.ts b/src/resources/accounts.ts
@@ -29,7 +29,7 @@ export class Accounts extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.accounts.disconnect('nobis');
+   * const response = await client.accounts.disconnect('aut');
    * ```
    */
   disconnect(id: string, options?: RequestOptions): APIPromise<AccountDisconnectResponse | null> {

diff --git a/src/resources/data-exports.ts b/src/resources/data-exports.ts
@@ -230,6 +230,8 @@ export namespace DataExportRetrieveResponse {
 
     failed_at?: string | null;
 
+    failed_downloads?: number;
+
     failed_reason?: string | null;
 
     file_type?: string;
@@ -327,6 +329,8 @@ export namespace DataExportListResponse {
 
       failed_at?: string | null;
 
+      failed_downloads?: number;
+
       failed_reason?: string | null;
 
       file_type?: string;

diff --git a/src/resources/index.ts b/src/resources/index.ts
@@ -134,7 +134,6 @@ export {
 } from './me';
 export {
   Media,
-  type MediaDownloadResponse,
   type MediaScrapeResponse,
   type MediaUploadResponse,
   type MediaDownloadParams,

diff --git a/src/resources/link-tags.ts b/src/resources/link-tags.ts
@@ -5,12 +5,12 @@ import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
 /**
- * APIs for managing tags on free trial links and tracking links
+ * APIs for managing tags on free trial links, tracking links, and Smart Links
  */
 export class LinkTags extends APIResource {
   /**
-   * Get all existing tags that have been used on free trial links and/or tracking
-   * links for this account. This is a free endpoint.
+   * Get all existing tags that have been used on free trial links, tracking links,
+   * and/or Smart Links for this account. This is a free endpoint.
    *
    * @example
    * ```ts
@@ -73,9 +73,9 @@ export namespace LinkTagListResponse {
 
 export interface LinkTagListParams {
   /**
-   * Filter by link type. If not provided, returns tags for both types.
+   * Filter by link type. If not provided, returns tags for all types.
    */
-  type?: 'trial_links' | 'tracking_links';
+  type?: 'trial_links' | 'tracking_links' | 'smart_links';
 }
 
 export declare namespace LinkTags {

diff --git a/src/resources/media/index.ts b/src/resources/media/index.ts
@@ -2,7 +2,6 @@
 
 export {
   Media,
-  type MediaDownloadResponse,
   type MediaScrapeResponse,
   type MediaUploadResponse,
   type MediaDownloadParams,

diff --git a/src/resources/media/media.ts b/src/resources/media/media.ts
@@ -30,21 +30,22 @@ export class Media extends APIResource {
    * Downloads a file directly from a `https://cdn*.onlyfans.com/*` URL. When the
    * file is already cached on our CDN, this endpoint returns a `302` redirect to a
    * `https://cdn.fansapi.com/*` URL. Most HTTP clients follow redirects
-   * automatically (`curl` requires `-L`). Otherwise, the file is streamed through
-   * our proxies and queued for caching.
+   * automatically (`curl` requires `-L`). Otherwise, the file is redirected to
+   * `dl.fansapi.com`, which streams it through the account proxy and reports billing
+   * back to the API.
    *
    * @example
    * ```ts
-   * const response = await client.media.download('cdnUrl', {
+   * await client.media.download('cdnUrl', {
    *   account: 'acct_XXXXXXXXXXXXXXX',
    * });
    * ```
    */
-  download(cdnURL: string, params: MediaDownloadParams, options?: RequestOptions): APIPromise<string> {
+  download(cdnURL: string, params: MediaDownloadParams, options?: RequestOptions): APIPromise<void> {
     const { account } = params;
     return this._client.get(path`/api/${account}/media/download/${cdnURL}`, {
       ...options,
-      headers: buildHeaders([{ Accept: 'text/plain' }, options?.headers]),
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
 
@@ -93,8 +94,6 @@ export class Media extends APIResource {
   }
 }
 
-export type MediaDownloadResponse = string;
-
 export interface MediaScrapeResponse {
   expiration_date?: string;
 
@@ -201,7 +200,6 @@ Media.Vault = Vault;
 
 export declare namespace Media {
   export {
-    type MediaDownloadResponse as MediaDownloadResponse,
     type MediaScrapeResponse as MediaScrapeResponse,
     type MediaUploadResponse as MediaUploadResponse,
     type MediaDownloadParams as MediaDownloadParams,

diff --git a/src/resources/media/vault/lists/lists.ts b/src/resources/media/vault/lists/lists.ts
@@ -58,12 +58,13 @@ export class Lists extends APIResource {
    * ```ts
    * const list = await client.media.vault.lists.update('123', {
    *   account: 'acct_XXXXXXXXXXXXXXX',
+   *   name: 'My renamed list',
    * });
    * ```
    */
   update(listID: string, params: ListUpdateParams, options?: RequestOptions): APIPromise<ListUpdateResponse> {
-    const { account } = params;
-    return this._client.put(path`/api/${account}/media/vault/lists/${listID}`, options);
+    const { account, ...body } = params;
+    return this._client.put(path`/api/${account}/media/vault/lists/${listID}`, { body, ...options });
   }
 
   /**
@@ -462,9 +463,15 @@ export interface ListRetrieveParams {
 
 export interface ListUpdateParams {
   /**
-   * The Account ID
+   * Path param: The Account ID
    */
   account: string;
+
+  /**
+   * Body param: The new name for the vault list. Must not be greater than 255
+   * characters.
+   */
+  name: string;
 }
 
 export interface ListListParams {

diff --git a/src/resources/media/vault/lists/media.ts b/src/resources/media/vault/lists/media.ts
@@ -12,7 +12,7 @@ export class Media extends APIResource {
    * @example
    * ```ts
    * const response = await client.media.vault.lists.media.add(
-   *   'nihil',
+   *   'aut',
    *   { account: 'acct_XXXXXXXXXXXXXXX', mediaIds: ['string'] },
    * );
    * ```
@@ -28,7 +28,7 @@ export class Media extends APIResource {
    * @example
    * ```ts
    * const media = await client.media.vault.lists.media.remove(
-   *   'nihil',
+   *   'aut',
    *   { account: 'acct_XXXXXXXXXXXXXXX', mediaIds: ['string'] },
    * );
    * ```

diff --git a/src/resources/posts/comments.ts b/src/resources/posts/comments.ts
@@ -11,13 +11,10 @@ export class Comments extends APIResource {
    *
    * @example
    * ```ts
-   * const comment = await client.posts.comments.create(
-   *   'impedit',
-   *   {
-   *     account: 'acct_XXXXXXXXXXXXXXX',
-   *     text: 'This is a comment.',
-   *   },
-   * );
+   * const comment = await client.posts.comments.create('ut', {
+   *   account: 'acct_XXXXXXXXXXXXXXX',
+   *   text: 'This is a comment.',
+   * });
    * ```
    */
   create(
@@ -37,10 +34,9 @@ export class Comments extends APIResource {
    *
    * @example
    * ```ts
-   * const comments = await client.posts.comments.list(
-   *   'impedit',
-   *   { account: 'acct_XXXXXXXXXXXXXXX' },
-   * );
+   * const comments = await client.posts.comments.list('ut', {
+   *   account: 'acct_XXXXXXXXXXXXXXX',
+   * });
    * ```
    */
   list(postID: string, params: CommentListParams, options?: RequestOptions): APIPromise<CommentListResponse> {

diff --git a/src/resources/saved-for-later/messages/settings.ts b/src/resources/saved-for-later/messages/settings.ts
@@ -50,7 +50,7 @@ export class Settings extends APIResource {
    * const response =
    *   await client.savedForLater.messages.settings.enableOrUpdateAutomaticMessaging(
    *     'acct_XXXXXXXXXXXXXXX',
-   *     { period: 12 },
+   *     { period: 6 },
    *   );
    * ```
    */

diff --git a/src/resources/saved-for-later/posts/settings.ts b/src/resources/saved-for-later/posts/settings.ts
@@ -50,7 +50,7 @@ export class Settings extends APIResource {
    * const response =
    *   await client.savedForLater.posts.settings.enableOrUpdateAutomaticPosting(
    *     'acct_XXXXXXXXXXXXXXX',
-   *     { period: 12 },
+   *     { period: 48 },
    *   );
    * ```
    */