> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TinyFish

> TinyFish provides web automation, live search, content extraction, research, browser sessions, reusable browser profiles, and run management through native REST APIs.

![TinyFish logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/tinyfish.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=13b387e1e13cee5a9aa6af4672140ca5)

* **Category:** ai agents
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 32
* **Triggers:** 0
* **Slug:** `TINYFISH`
* **Version:** 20261101\_00
* **Instant:** Supported on the latest version. Support varies by tool.

## Tools

> [accordion] Cancel Profile Setup Session
>
> **Slug:** `TINYFISH_CANCEL_PROFILE_SETUP_SESSION`
>
> Cancel a Browser Context Profile setup session and permanently discard its unsaved cookies and browser storage.
>
> #### Input Parameters
>
> **profile\_id** `string` *required*
>
> Browser Context Profile whose temporary setup session should be cancelled.
>
> **session\_id** `string` *required*
>
> Setup session to cancel and discard without saving its browser state.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Cancel Research Run
>
> **Slug:** `TINYFISH_CANCEL_RESEARCH_RUN`
>
> Cancel one running TinyFish research run using a connected TinyFish account. Cancellation is irreversible but idempotent: terminal runs return their current status with cancelled=false.
>
> #### Input Parameters
>
> **research\_run\_id** `string` *required*
>
> Running research run ID owned by the connected TinyFish account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Cancel Runs
>
> **Slug:** `TINYFISH_CANCEL_RUNS`
>
> Idempotently cancel one or up to 100 asynchronous or SSE runs. Active cancellation is irreversible; synchronous runs cannot be cancelled, and already-terminal runs are returned with their actual status.
>
> #### Input Parameters
>
> **run\_ids** `array` *required*
>
> One to 100 TinyFish run IDs to cancel. Only asynchronous and SSE runs can be cancelled; synchronous runs cannot be cancelled.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Browser Session
>
> **Slug:** `TINYFISH_CREATE_BROWSER_SESSION`
>
> Create an isolated TinyFish remote browser session and return its CDP connection URL. This action starts billable browser infrastructure: TinyFish meters Browser usage until the session ends or becomes inactive. You must call Terminate Browser Session with the returned session\_id immediately after browser work finishes, including after failures, to stop further usage charges. Creation can return before startup navigation completes.
>
> #### Input Parameters
>
> **url** `string`
>
> Optional startup URL. TinyFish adds https\:// when given a bare domain; session creation may finish before navigation to this URL completes.
>
> **timeout\_seconds** `integer`
>
> Requested session lifetime in seconds (5-86400). The effective lifetime may be capped by the TinyFish account plan.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Monitor
>
> **Slug:** `TINYFISH_CREATE_MONITOR`
>
> Create a scheduled Page or Topic Monitor and immediately capture its paid baseline using a connected TinyFish account. Each completed baseline costs \$0.005, failed runs are not charged, and an account can hold at most 50 Monitors; a timeout or server error can leave the Monitor created.
>
> #### Input Parameters
>
> **name** `string`
>
> Optional Monitor name.
>
> **type** `string ("fetch" | "search")` *required*
>
> fetch creates a Page Monitor; search creates a Topic Monitor.
>
> **config** `string` *required*
>
> Immutable Page or Topic target configuration.
>
> **purpose** `string`
>
> Optional description of the change TinyFish should evaluate.
>
> **webhook\_url** `string`
>
> Optional public HTTP or HTTPS callback for scheduled results.
>
> **schedule\_cron** `string` *required*
>
> Five-field cron schedule, in UTC unless prefixed by CRON\_TZ=\<IANA zone>. Topic schedules must keep runs at least 30 minutes apart.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Profile
>
> **Slug:** `TINYFISH_CREATE_PROFILE`
>
> Create a reusable Browser Context Profile for cookies and browser storage; this changes persistent account state.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Human-readable name for the Browser Context Profile (1-100 characters).
>
> **set\_as\_default** `boolean`
>
> Whether the new profile should become the account's default profile.
>
> **proxy\_country\_code** `string ("US" | "GB" | "CA" | "AU" | "DE" | "FR" | "IT" | "ES" | "NL" | "JP" | "SG" | "BR" | "IN")`
>
> Country for the profile proxy, or null for no country preference.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Monitor
>
> **Slug:** `TINYFISH_DELETE_MONITOR`
>
> Permanently delete a TinyFish Monitor and its schedule using a connected TinyFish account. Its Monitor run history becomes unavailable and this action cannot be undone; verify an ambiguous outcome before another delete.
>
> #### Input Parameters
>
> **monitor\_id** `string` *required*
>
> Monitor ID to permanently delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Profile
>
> **Slug:** `TINYFISH_DELETE_PROFILE`
>
> Permanently delete a Browser Context Profile and all browser state saved in it. This action cannot be undone.
>
> #### Input Parameters
>
> **profile\_id** `string` *required*
>
> Browser Context Profile ID to permanently delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Profile Domain
>
> **Slug:** `TINYFISH_DELETE_PROFILE_DOMAIN`
>
> Permanently remove saved cookies and browser storage for one domain from a Browser Context Profile. This action cannot be undone.
>
> #### Input Parameters
>
> **domain** `string` *required*
>
> Exact domain whose saved cookies and browser storage should be removed.
>
> **profile\_id** `string` *required*
>
> Browser Context Profile containing the saved domain state.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Fetch URLs
>
> **Slug:** `TINYFISH_FETCH_URLS`
>
> Render and extract content from 1-10 URLs in one provider-native batch. Always inspect both results and errors because HTTP 200 can contain successful pages and per-URL failures together.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0 per request
>
> #### Input Parameters
>
> **ttl** `integer`
>
> Cache freshness tolerance in seconds; 0 prefers a live fetch.
>
> **urls** `array` *required*
>
> Between 1 and 10 public HTTP(S) URLs to fetch in parallel.
>
> **links** `boolean`
>
> Whether to include absolute outbound page links.
>
> **format** `string ("markdown" | "html" | "json")`
>
> Output representation for extracted page content.
>
> **purpose** `string`
>
> Nonblank reason for fetching the pages, used to guide extraction.
>
> **image\_links** `boolean`
>
> Whether to include absolute image links.
>
> **if\_none\_match** `string`
>
> ETag validator from a prior fetch; valid only with exactly one URL.
>
> **page\_metadata** `boolean`
>
> Whether to include browser and page-head metadata.
>
> **exclude\_selectors** `array`
>
> One to 20 nonblank CSS selectors (each at most 1000 characters) to remove.
>
> **if\_modified\_since** `string`
>
> Last-Modified validator from a prior fetch; valid only with exactly one URL.
>
> **include\_selectors** `array`
>
> One to 20 nonblank CSS selectors (each at most 1000 characters) to include.
>
> **per\_url\_timeout\_ms** `integer`
>
> Independent wall-clock timeout for each URL in milliseconds (1-110000).
>
> **include\_etag\_and\_last\_modified** `boolean`
>
> Whether to return origin ETag and Last-Modified validators when available.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Monitor
>
> **Slug:** `TINYFISH_GET_MONITOR`
>
> Get one TinyFish Page or Topic Monitor by ID using a connected TinyFish account, including its target config, schedule, lifecycle status, webhook, and last error.
>
> #### Input Parameters
>
> **monitor\_id** `string` *required*
>
> Monitor ID owned by the connected TinyFish account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Profile
>
> **Slug:** `TINYFISH_GET_PROFILE`
>
> Get one Browser Context Profile and its saved-domain metadata.
>
> #### Input Parameters
>
> **profile\_id** `string` *required*
>
> Browser Context Profile ID to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Research Run
>
> **Slug:** `TINYFISH_GET_RESEARCH_RUN`
>
> Read one saved TinyFish research run using a connected TinyFish account, including status, partial or final reports, plan, evidence, and iteration count. Inspect status before treating any report as complete; unsuccessful runs can retain partial results.
>
> #### Input Parameters
>
> **research\_run\_id** `string` *required*
>
> Research run ID owned by the connected TinyFish account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Runs
>
> **Slug:** `TINYFISH_GET_RUNS`
>
> Get summary records for 1-100 TinyFish automation run IDs in one request. The response separately reports IDs that were not found or are not owned.
>
> #### Input Parameters
>
> **run\_ids** `array` *required*
>
> TinyFish automation run IDs to retrieve in one batch (1-100 IDs).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Wallet
>
> **Slug:** `TINYFISH_GET_WALLET`
>
> Get the TinyFish wallet balance, auto-reload and pending-top-up state, and current Agent and Browser rates. Monetary values are returned as exact decimal strings. Legacy-credit accounts report FEATURE\_NOT\_AVAILABLE rather than an authentication failure.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Monitors
>
> **Slug:** `TINYFISH_LIST_MONITORS`
>
> List Page and Topic Monitors owned by a connected TinyFish account, including their IDs for management and run operations.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Profiles
>
> **Slug:** `TINYFISH_LIST_PROFILES`
>
> List Browser Context Profiles available to the connected TinyFish account. Use the returned IDs when attaching or managing reusable browser state.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Research Runs
>
> **Slug:** `TINYFISH_LIST_RESEARCH_RUNS`
>
> List saved TinyFish research runs with optional status, query, date, and sort filters, returning one cursor-controlled page.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum saved runs to return (1-100).
>
> **query** `string`
>
> Filter saved research runs by query text.
>
> **cursor** `string`
>
> Opaque cursor returned by this tool. Omit it for the first page.
>
> **status** `string ("RUNNING" | "COMPLETED" | "FAILED" | "CANCELLED" | "TIMED_OUT" | "QUEUED")`
>
> Filter by a TinyFish research-run lifecycle status.
>
> **created\_after** `string`
>
> Return runs created after this ISO 8601 timestamp.
>
> **created\_before** `string`
>
> Return runs created before this ISO 8601 timestamp.
>
> **sort\_direction** `string ("asc" | "desc")`
>
> Sort by creation time in ascending or descending order. Continuation cursors retain the first page's value.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Runs
>
> **Slug:** `TINYFISH_LIST_RUNS`
>
> List automation runs with optional status, goal, date, and sort filters, returning one cursor-controlled page.
>
> #### Input Parameters
>
> **goal** `string`
>
> Filter runs by a case-insensitive partial match on goal text.
>
> **limit** `integer`
>
> Maximum runs to return in this page (1-100).
>
> **cursor** `string`
>
> Opaque cursor returned by this tool. Omit it for the first page.
>
> **status** `string ("PENDING" | "RUNNING" | "COMPLETED" | "FAILED" | "CANCELLED")`
>
> Return only runs in this lifecycle state.
>
> **created\_after** `string`
>
> Return runs created after this ISO 8601 timestamp.
>
> **created\_before** `string`
>
> Return runs created before this ISO 8601 timestamp.
>
> **sort\_direction** `string ("asc" | "desc")`
>
> Sort by creation time in ascending or descending order.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Usage
>
> **Slug:** `TINYFISH_LIST_USAGE`
>
> List one page of Search, Fetch, or Browser usage history. Search and Fetch usage reads are free; Browser usage requires the paid Browser service.
>
> #### Input Parameters
>
> **page** `integer`
>
> One-based usage-history page.
>
> **limit** `integer`
>
> Maximum usage records to return in this page (1-1000).
>
> **status** `string ("completed" | "failed" | "running" | "ended")`
>
> Filter by completed or failed for Search and Fetch, or running or ended for Browser.
>
> **service** `string ("search" | "fetch" | "browser")` *required*
>
> TinyFish product whose usage history should be listed.
>
> **end\_before** `string`
>
> Return usage created before this ISO 8601 timestamp.
>
> **session\_id** `string`
>
> Browser session ID filter; valid only when service is browser.
>
> **start\_after** `string`
>
> Return usage created after this ISO 8601 timestamp.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Vault Connections
>
> **Slug:** `TINYFISH_LIST_VAULT_CONNECTIONS`
>
> List display-safe metadata for password-manager vaults connected to TinyFish. Credentials and secret values are excluded.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Vault Items
>
> **Slug:** `TINYFISH_LIST_VAULT_ITEMS`
>
> List display-safe metadata for items synchronized from password-manager vaults connected to TinyFish. Secret field values are never returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Run Monitor Now
>
> **Slug:** `TINYFISH_RUN_MONITOR_NOW`
>
> Run an existing Page or Topic Monitor immediately and save its result; managed Instant users must connect their own TinyFish account. Each completed run costs \$0.005 and sends no webhook or email notification; a timeout or server error leaves creation uncertain.
>
> #### Input Parameters
>
> **monitor\_id** `string` *required*
>
> Existing active, paused, or failed Monitor ID to run immediately.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Save Profile Setup Session
>
> **Slug:** `TINYFISH_SAVE_PROFILE_SETUP_SESSION`
>
> Persist cookies and browser storage from a completed setup session into a Browser Context Profile, then clean up the temporary session. Persisted state and successful session cleanup cannot be undone. The response retains domain-level skips and failures plus cleanup status so partial success remains visible.
>
> #### Input Parameters
>
> **profile\_id** `string` *required*
>
> Profile that should receive the setup session's browser state.
>
> **session\_id** `string` *required*
>
> Completed setup session whose cookies and browser storage should be persisted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Web
>
> **Slug:** `TINYFISH_SEARCH_WEB`
>
> Search live web pages, news, or research papers with domain and time filters, optionally fetching result pages inline, and return exactly one caller-selected zero-based result page.
>
> **Instant:** Supported on the latest version.
>
> **Instant pricing:** \$0 per request
>
> #### Input Parameters
>
> **page** `integer`
>
> Zero-based result page (0-10).
>
> **query** `string` *required*
>
> Search query (1-2000 characters).
>
> **purpose** `string`
>
> Why the results are needed, used by TinyFish to improve ranking.
>
> **language** `string`
>
> Language code for results. TinyFish infers it from location, or defaults to en when both fields are omitted.
>
> **location** `string`
>
> Country code for localized results. TinyFish infers it from language, or defaults to US when both fields are omitted.
>
> **after\_date** `string`
>
> Earliest publication date, inclusive (YYYY-MM-DD). Not compatible with recency\_minutes or research\_paper searches.
>
> **before\_date** `string`
>
> Latest publication date, inclusive (YYYY-MM-DD). Not compatible with recency\_minutes or research\_paper searches.
>
> **domain\_type** `string ("web" | "news" | "research_paper")`
>
> Content corpus to search: web, news, or research\_paper.
>
> **fetch\_content** `boolean`
>
> Fetch each result page inline with TinyFish's default Fetch settings. Fetched content or per-result fetch errors are returned on each result.
>
> **exclude\_domains** `array`
>
> Exclude results from these domains; sent as one comma-separated value.
>
> **include\_domains** `array`
>
> Only return results from these domains; sent as one comma-separated value.
>
> **recency\_minutes** `integer`
>
> Only return content from the last 1-5256000 minutes. Not compatible with date bounds or research\_paper searches.
>
> **include\_thumbnail** `boolean`
>
> Request thumbnail URLs when available; sent as true or false.
>
> **publication\_year\_max** `integer`
>
> Maximum publication year, inclusive (0-9999). Valid only for research\_paper searches.
>
> **publication\_year\_min** `integer`
>
> Minimum publication year, inclusive (0-9999). Valid only for research\_paper searches.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Start Profile Setup Session
>
> **Slug:** `TINYFISH_START_PROFILE_SETUP_SESSION`
>
> Start a billable temporary remote browser session for establishing login state in a Browser Context Profile. The returned browser state is not saved automatically: after setup, always call Save Profile Setup Session to persist it or Cancel Profile Setup Session to discard it and tear down the session.
>
> #### Input Parameters
>
> **url** `string`
>
> Optional absolute HTTP(S) URL or bare domain to open when the temporary setup browser starts. TinyFish prefixes bare domains with https\://.
>
> **profile\_id** `string` *required*
>
> Browser Context Profile that will receive saved login and browser state.
>
> **timeout\_seconds** `integer`
>
> Requested lifetime of the billable temporary browser session in seconds (5-86400), subject to the account plan's cap.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Start Research Async
>
> **Slug:** `TINYFISH_START_RESEARCH_ASYNC`
>
> Start a paid TinyFish research run in the background and return its run ID; managed Instant users must connect their own TinyFish account. A timeout does not prove rejection, so avoid automatically submitting the same research again.
>
> #### Input Parameters
>
> **mode** `string ("auto" | "instant" | "standard" | "deep" | "max")`
>
> Research depth. Omit for deep; legacy auto selects standard.
>
> **query** `string` *required*
>
> Research question.
>
> **stream** `boolean`
>
> Whether synthesis events contain report text. The async response remains non-streaming and must be polled.
>
> **after\_date** `string`
>
> Include results on or after this date.
>
> **session\_id** `string`
>
> Standard or instant research session to continue.
>
> **before\_date** `string`
>
> Include results on or before this date.
>
> **domain\_type** `string ("web" | "news" | "research_paper")`
>
> Source corpus to research.
>
> **prior\_run\_id** `string`
>
> Completed research run whose report and evidence seed this run.
>
> **domain\_filter** `object`
>
> Domain preferences or restrictions.
>
> **output\_language** `string`
>
> BCP 47 report language tag, such as en, ja, or pt-BR.
>
> **recency\_minutes** `integer`
>
> Freshness window in minutes.
>
> **weak\_sources\_enabled** `boolean`
>
> Allow relevant social and community sources.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Sync Vault Items
>
> **Slug:** `TINYFISH_SYNC_VAULT_ITEMS`
>
> Refresh display-safe item metadata from all password-manager vaults already connected to TinyFish. Synchronization can add, update, or remove mirrored items. Returns synchronization counts and allowlisted item metadata without credential or secret values.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Terminate Browser Session
>
> **Slug:** `TINYFISH_TERMINATE_BROWSER_SESSION`
>
> Idempotently terminate a remote TinyFish browser session to stop further browser usage charges. Already-ended sessions are also successful.
>
> #### Input Parameters
>
> **session\_id** `string` *required*
>
> Browser session to terminate; use only a session the caller owns.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Monitor
>
> **Slug:** `TINYFISH_UPDATE_MONITOR`
>
> Pause or resume a TinyFish Monitor, or edit its schedule and delivery metadata, using a connected TinyFish account. Status changes cannot be combined with other edits, and schedule or metadata edits require a schedule; type and target config are immutable.
>
> #### Input Parameters
>
> **name** `string`
>
> Replacement name. Explicit null clears it; omission preserves it.
>
> **status** `string ("active" | "paused")`
>
> Resume or pause scheduled checks. This must be the only update field.
>
> **purpose** `string`
>
> Replacement change purpose. Explicit null clears it; omission preserves it.
>
> **monitor\_id** `string` *required*
>
> Monitor ID owned by the connected TinyFish account.
>
> **webhook\_url** `string`
>
> Replacement public HTTP or HTTPS callback. Explicit null clears it; omission preserves it.
>
> **schedule\_cron** `string`
>
> Replacement five-field schedule, optionally prefixed by CRON\_TZ=\<IANA zone>. Required for schedule or metadata edits. TinyFish enforces the 30-minute Topic minimum because this PATCH does not include type.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Profile
>
> **Slug:** `TINYFISH_UPDATE_PROFILE`
>
> Rename a Browser Context Profile or change its default and proxy-country settings. Omitted fields remain unchanged.
>
> #### Input Parameters
>
> **name** `string`
>
> New profile name (1-100 characters); omit to leave it unchanged.
>
> **profile\_id** `string` *required*
>
> Browser Context Profile ID to update.
>
> **set\_as\_default** `boolean`
>
> Whether this profile should be the account default; omit to leave it unchanged.
>
> **proxy\_country\_code** `string ("US" | "GB" | "CA" | "AU" | "DE" | "FR" | "IT" | "ES" | "NL" | "JP" | "SG" | "BR" | "IN")`
>
> New proxy country; pass null explicitly to clear the setting, or omit the field to leave it unchanged.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Profile State
>
> **Slug:** `TINYFISH_UPLOAD_PROFILE_STATE`
>
> Upload cookies and local or session storage directly into a Browser Context Profile. This changes persistent login state and may transmit authentication secrets; call it only with the credential owner's explicit authorization. TinyFish provides no rollback endpoint, so restoring prior state requires a caller-held copy or deleting the affected domains.
>
> #### Input Parameters
>
> **cookies** `array` *required*
>
> Up to 3000 browser cookies. WARNING: cookies can grant account access; provide them only with the credential owner's explicit authorization.
>
> **profile\_id** `string` *required*
>
> Browser Context Profile ID that should receive the uploaded state.
>
> **local\_storage** `array`
>
> Up to 100 local-storage origin records. WARNING: values may contain authentication tokens or private user data.
>
> **session\_storage** `array`
>
> Up to 100 session-storage origin records. WARNING: values may contain authentication tokens or private user data.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
