---
canonical_url: "https://docs.composio.dev/toolkits/starcovery"
markdown_url: "https://docs.composio.dev/toolkits/starcovery.md"
product: "platform"
version: null
last_updated: null
---

# Starcovery

Starcovery helps teams discover creators, research profiles and videos, and manage creator outreach campaigns.

- **Category:** ai sales tools
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 38
- **Triggers:** 0
- **Slug:** `STARCOVERY`
- **Version:** 00000000_00

## Tools

### Add Campaign Match

**Slug:** `STARCOVERY_ADD_CAMPAIGN_MATCH`

Add one creator profile from Search Creators to a draft campaign's shortlist. Repeating the same campaign and profile is idempotent and leaves one match. The shortlist cannot change while a send request is open or after the campaign is sent or archived.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fit_score` | number | No | Creator fit score from Search Creators, or null to add without a score. |
| `profile_id` | string | Yes | Creator profile ID returned by Search Creators. |
| `campaign_id` | string | Yes | Draft campaign ID whose shortlist should receive the creator. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Call Hosted Tool

**Slug:** `STARCOVERY_CALL_TOOL`

Run one Starcovery catalog tool through the native REST endpoint, not MCP, using its provider-native JSON input. Inspect List Hosted Tools and the selected tool's schema before calling. The runtime-selected tool may spend credits, mutate data, notify people, or trigger other external effects. A tool that could change an organization or account returns a web-app confirmation link; this REST call alone does not apply that change.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Hosted tool name returned by List Hosted Tools. |
| `arguments` | object | Yes | Complete provider-native JSON input for the selected hosted tool. Send an empty object when its input schema has no fields. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Campaign Send

**Slug:** `STARCOVERY_CANCEL_CAMPAIGN_SEND`

Cancel a still-open proposal-send request before Starcovery staff send it. Only an organization owner may do this. The call notifies no one, records who cancelled the request and when, and leaves the campaign in draft so its terms and shortlist can change. It cannot recall proposals staff already sent.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | Campaign whose still-open proposal-send request should be cancelled. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Health

**Slug:** `STARCOVERY_CHECK_HEALTH`

Check whether Starcovery's API service is up. This unauthenticated, free read changes no provider state.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create API Key

**Slug:** `STARCOVERY_CREATE_API_KEY`

Mint an API key for the connected organization. Only an organization owner can perform this free operation. The plaintext secret is returned exactly once in the result and must be stored securely without logging it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Human-readable key label; must not begin with agent:. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Campaign

**Slug:** `STARCOVERY_CREATE_CAMPAIGN`

Create a draft campaign with a name and creator brief. Starcovery defaults visibility to public when it is omitted, so this action deliberately omits visibility and creates the free public form. Private visibility costs one prepaid credit and is not supported by this action. This action does not send proposals, notify staff, fund creators, or add campaign terms.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `goal` | string | Yes | Creator brief and campaign goal used to evaluate matches. |
| `name` | string | Yes | Short campaign name. |
| `idempotency_key` | string | No | Client-generated retry key. Reuse the same value to receive the originally created campaign instead of creating a duplicate. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Campaign

**Slug:** `STARCOVERY_DELETE_CAMPAIGN`

Permanently delete a campaign and all of its shortlist matches. Starcovery rejects deletion when the campaign has any funding on record (including refunded funding), a signed hire, a delivered proposal on any match, an active/already-sent state, or an open proposal-send request. An organization owner must cancel an open send request before deleting the campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | Campaign id to permanently delete; use only for a campaign the caller intends to remove with all of its matches. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Campaign Attachment

**Slug:** `STARCOVERY_DELETE_CAMPAIGN_ATTACHMENT`

Permanently delete one stored attachment from a campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | Campaign containing the attachment. |
| `attachment_id` | string | Yes | Attachment id to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Enrich Creator Shortlist

**Slug:** `STARCOVERY_ENRICH_CREATOR_SHORTLIST`

Consume a Search Creators response's single-use, caller-bound ticket to stream niche, celebrity, evidence, and signal analysis for that exact shortlist. The enrichment itself is free and spends no search credit, but the required prior search consumes one daily grant or, after exhaustion, one prepaid credit ($0.05). Enrichment may run for up to 800 seconds. Do not retry after the ticket has been admitted because it is single-use.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Exact query returned by the search that minted the ticket. |
| `ticket` | string | Yes | Single-use shortlist ticket returned by Search Creators. It is bound to the search caller and must not be retried after admission. |
| `creators` | array | Yes | Complete creators array returned by the search that minted the ticket. Preserve every creator and nested video field. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Export Campaign

**Slug:** `STARCOVERY_EXPORT_CAMPAIGN`

Export a visible campaign shortlist as exact CSV text with Rank, Handle, Name, Platform, Followers, Fit, and Source columns. This is free and read-only and does not modify the campaign or notify creators or staff.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | Campaign whose shortlist should be exported. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Campaign Matches

**Slug:** `STARCOVERY_GENERATE_CAMPAIGN_MATCHES`

Run one creator search from a campaign's goal and idempotently save ranked creators as shortlist matches. The campaign must be mutable: an open send request, sent campaign, or archived campaign is rejected. This uses one daily search grant or, after grant exhaustion, one prepaid credit ($0.05), changes the campaign shortlist, and may run for up to 800 seconds.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tier` | string ("nano" | "micro" | "mid" | "macro" | "mega" | "nano+" | "micro+" | "mid+" | "macro+" | "micro-" | "mid-" | "macro-") | No | Optional follower-tier filter, including documented plus/minus ranges. |
| `country` | string | No | Optional comma-separated ISO 3166-1 alpha-2 country codes. |
| `platform` | string ("ig" | "tt") | No | Optional Instagram (ig) or TikTok (tt) filter. |
| `campaign_id` | string | Yes | Campaign whose goal should drive creator-match generation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Billing State

**Slug:** `STARCOVERY_GET_BILLING_STATE`

Read the organization's prepaid-credit balance, daily search grant, last purchased pack, and whether a card is on file. This free read starts no checkout and changes no payment setting.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Campaign

**Slug:** `STARCOVERY_GET_CAMPAIGN`

Get one campaign with its shortlisted creator matches and current workflow steps. Organization stakeholders also receive available campaign terms, people, funding, hire, payout, and post state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | Campaign id returned by Create Campaign or List Campaigns. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Campaign Attachment

**Slug:** `STARCOVERY_GET_CAMPAIGN_ATTACHMENT`

Download one campaign attachment. Downloads are capped at the provider's 4 MiB attachment limit and returned as a file reference; the response media type is preserved and the provider filename is reduced to a safe basename.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | Campaign containing the attachment. |
| `attachment_id` | string | Yes | Attachment id returned by Upload Campaign Attachment. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Campaign Chat

**Slug:** `STARCOVERY_GET_CAMPAIGN_CHAT`

Read one visible campaign together with its attachment metadata. This is free, read-only, and has no side effects. It does not return or create conversation turns and does not call MCP; use the separate native thread actions for the campaign conversation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | Campaign to read together with its attachment metadata. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current Identity

**Slug:** `STARCOVERY_GET_CURRENT_IDENTITY`

Read the user, organization, credential kind, billing state, and source of the next search credit resolved from the connected API key. This is a free, read-only identity check.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Thread

**Slug:** `STARCOVERY_GET_THREAD`

Read a durable search thread without spending a search grant or prepaid credit. Returns its brief, filters, result id, ordered stored messages, every admitted run id and state, and any active run. Use this after disconnecting instead of rerunning a turn: assistant replies are stored on the thread.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `thread_id` | string | Yes | Thread id returned by Open Thread. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Thread Results

**Slug:** `STARCOVERY_GET_THREAD_RESULTS`

Read the creator set stored by a thread, preserving its result order and single-use enrichment ticket. Reading an existing set is free and runs no search. If the thread has a brief but no stored set, this call runs and stores one search using the daily grant or one prepaid credit after exhaustion; every later read of that set is free. A thread without a brief returns not found.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `thread_id` | string | Yes | Thread whose stored or newly generated result set to read. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List API Keys

**Slug:** `STARCOVERY_LIST_API_KEYS`

List revocable API-key metadata for the connected organization. This free read returns identifiers and display prefixes, never plaintext secrets, and changes nothing.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Campaigns

**Slug:** `STARCOVERY_LIST_CAMPAIGNS`

List the connected organization's campaigns, optionally filtered by status, with each campaign's match count and next workflow step.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("draft" | "active" | "archived") | No | Return only campaigns in this status; omit to return all campaigns. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Hosted Tools

**Slug:** `STARCOVERY_LIST_TOOLS`

List Starcovery's hosted tool catalog with each tool's name, title, description, and input and output JSON Schemas.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Look Up Video

**Slug:** `STARCOVERY_LOOKUP_VIDEO`

Look up an Instagram or TikTok video URL in Starcovery's catalog and return its canonical identity, duration, creator account, caption hash, and sound when present.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `video_url` | string | Yes | Instagram post or reel URL, or TikTok /@handle/video/id URL, to find in the Starcovery catalog. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Open Thread

**Slug:** `STARCOVERY_OPEN_THREAD`

Open a free, durable search thread for the connected organization. The call creates stored state even though the thread starts with no brief or messages; Starcovery exposes no thread-delete endpoint. Send the first brief and page context with Run Thread Turn, and retain the returned thread id for reads, stream replay, results, and stopping runs.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Parse Creator Search

**Slug:** `STARCOVERY_PARSE_CREATOR_SEARCH`

Extract platform, follower-tier, and country filters from a natural-language creator brief before calling Search Creators. This does not run a creator search or consume a daily search grant.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Natural-language creator brief whose explicit platform, follower tier, and countries should be extracted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove Campaign Match

**Slug:** `STARCOVERY_REMOVE_CAMPAIGN_MATCH`

Remove one undelivered, unlocked creator match from a campaign shortlist. Starcovery rejects removal after proposal delivery or while the campaign has an open send request, has been sent, or is archived.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `match_id` | string | Yes | Match id returned in Get Campaign's matches array; this is not the creator profile id. |
| `campaign_id` | string | Yes | Campaign id that owns the shortlist match. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Request Campaign Funding

**Slug:** `STARCOVERY_REQUEST_CAMPAIGN_FUNDING`

Create an open funding request for accepted, unfunded creators and immediately notify Starcovery staff to invoice the organization. Owner or admin access is required, as are a contract, a market-information answer, and at least one accepted unfunded creator; archived campaigns must first be reopened. The quote includes creator compensation and, on the campaign's first funding request, a non-refundable $99, $499, or $999 campaign price based on company size. This call moves no money, but staff may issue that invoice and the campaign price is never refunded.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | Campaign with a contract, market-information answer, and at least one accepted creator who is not yet funded. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Request Campaign Send

**Slug:** `STARCOVERY_REQUEST_CAMPAIGN_SEND`

Create an open proposal-send request and immediately notify Starcovery staff. The campaign must be a draft with a contract, paid-partnership disclosure, at least one match, and no past creator posting date. This call does not mail creators itself, but staff may send proposals from their queue after the gates pass; the open request locks shortlist changes until it is cancelled or sent.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaign_id` | string | Yes | Draft campaign with a contract, disclosure, a non-past creator posting date when one is set, and at least one match. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resume Thread Stream

**Slug:** `STARCOVERY_RESUME_THREAD_STREAM`

Reconnect to the currently open turn and replay its UI-message stream from the first chunk through the stored outcome. This is free and does not run the turn again. A 204 response means there is no open turn, or the supplied run id is not the open run; it returns active=false with no events. Use Get Thread for stored messages and admitted run states after the turn closes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | string | No | Run to replay; a run other than the currently open one returns no stream. |
| `thread_id` | string | Yes | Thread whose currently open turn should be replayed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Reveal Creator Contact

**Slug:** `STARCOVERY_REVEAL_CREATOR_CONTACT`

Reveal a creator's contact address. The organization's first successful reveal for this profile spends 5 prepaid credits ($0.25); later reveals are free. A profile with no contact data returns an error and is not charged.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `profile_id` | string | Yes | Creator profile id whose contact address should be revealed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Revoke API Key

**Slug:** `STARCOVERY_REVOKE_API_KEY`

Irreversibly revoke one organization API key by id. This free deletion cannot be undone and affects only that key; keys previously minted with it remain enabled until separately revoked.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `key_id` | string | Yes | API-key id from List API Keys, not a plaintext key or display prefix. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Run Thread Turn

**Slug:** `STARCOVERY_RUN_THREAD_TURN`

Run and store the next assistant turn, returning its ordered AI SDK UI-message chunks. The fresh run id identifies this stream for replay and stopping. Each turn spends one daily search allowance use, plus one for every new search and exclusion; after the allowance, each use spends one prepaid credit. A failed turn is refunded. The reply is durable, so after a disconnect use Get Thread or Resume Thread Stream instead of rerunning it. Agent mode can mutate records; proposal sends, funding, destructive actions, and API-key revocation still wait for customer confirmation on the Starcovery site.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mode` | string ("agent" | "ask") | No | Assistant mode; omit for ask. Agent mode may change organization records, although destructive and proposal/funding actions still require a website click. |
| `run_id` | string | Yes | Fresh UUID for this run. Keep it to resume or stop this exact run; an already-admitted run id is rejected without changing the thread. |
| `context` | object | No | Page and records shown beside the thread, when applicable. |
| `filters` | object | No | Explicit filters for a first brief; omit to derive them from its text. |
| `message` | object | Yes | Exact user UI message to store and run. |
| `thread_id` | string | Yes | Thread to continue. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Creators

**Slug:** `STARCOVERY_SEARCH_CREATORS`

Rank Instagram and TikTok creators for a brief, optionally using explicit filters returned by Parse Creator Search. An uncached search uses the connected account's daily grant; after that grant is exhausted, it spends one prepaid credit ($0.05).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tier` | string ("nano" | "micro" | "mid" | "macro" | "mega" | "nano+" | "micro+" | "mid+" | "macro+" | "micro-" | "mid-" | "macro-" | "") | No | Restrict results by follower tier. Plus means that tier and above; minus means that tier and every smaller tier. An empty string applies no tier filter. |
| `query` | string | Yes | Natural-language creator brief to rank against. |
| `country` | string | No | One or more ISO 3166-1 alpha-2 country codes in either letter case, separated by commas, such as us or us,ca. Surrounding whitespace is accepted. An empty string applies no country filter. Words in the brief do not apply this filter. |
| `platform` | string ("ig" | "tt" | "") | No | Restrict results to Instagram (ig) or TikTok (tt), or send an empty string for no platform filter. Words in the brief do not apply this filter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start Profile Claims

**Slug:** `STARCOVERY_START_PROFILE_CLAIMS`

Start an Instagram handle claim, a TikTok handle claim, or both. This free operation creates durable manual-review state and emails the calling user a verification code and claim link for each claim in review.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `handles` | object | Yes | Instagram and/or TikTok handles to place into claim review. |
| `organization_id` | string | No | Organization id to claim for. An API key can name only its own organization; omit to use the connected organization. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Stop Thread Turn

**Slug:** `STARCOVERY_STOP_THREAD_TURN`

Record a stop for one run id, preventing that run from starting new searches, exclusions, or tool calls. A stop sent before the run starts still stops it. Work already started may finish, and the stream can remain open until a partial reply is stored; a run that started no work ends without a reply. The stop is scoped to this run id, does not stop a later run with a new id, and does not delete the durable thread.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `run_id` | string | Yes | Run UUID to stop, including a run that has not started yet. |
| `thread_id` | string | Yes | Thread containing the run to stop. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Submit Feedback

**Slug:** `STARCOVERY_SUBMIT_FEEDBACK`

Submit a real bug or feature report to Starcovery staff, including the Starcovery site path it concerns. This sends the report immediately; it is not a local draft or preview.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | Yes | Bug details or feature request sent to Starcovery staff. |
| `path` | string | Yes | Starcovery site path that the feedback concerns. |
| `title` | string | Yes | Short bug or feature-report title sent to Starcovery staff. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Campaign

**Slug:** `STARCOVERY_UPDATE_CAMPAIGN`

Update the name or creator brief of an existing campaign, or make it public. Unset fields are omitted and remain unchanged. Changing a public campaign to private costs one prepaid credit, so private visibility is deliberately not available. This action cannot change campaign status, contract terms, disclosure, embargo, or market information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `goal` | string | No | Replacement creator brief and campaign goal; omit to keep the current goal. |
| `name` | string | No | Replacement campaign name; omit to keep the current name. |
| `visibility` | string | No | Set a private campaign to public. Omit to preserve current visibility. Private visibility is unavailable because changing a public campaign to private costs one prepaid credit. |
| `campaign_id` | string | Yes | Campaign id to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upload Campaign Attachment

**Slug:** `STARCOVERY_UPLOAD_CAMPAIGN_ATTACHMENT`

Upload one attachment of at most 4 MiB to a campaign. Supported media types are JSON, PDF, GIF, JPEG, PNG, WebP, CSV, and plain text. Starcovery limits attachments to 50 files or 100 MiB per campaign, 100 files or 200 MiB per user in an organization, and 250 files or 500 MiB per organization. It also limits each user to 20 uploads per 60 seconds. A quota rejection does not identify which limit was reached.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | Yes | JSON, PDF, GIF, JPEG, PNG, WebP, CSV, or plain-text file no larger than 4 MiB. |
| `filename` | string | Yes | Safe filename, including its extension, to store with the attachment. |
| `campaign_id` | string | Yes | Campaign that will store the attachment. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Profile Claim

**Slug:** `STARCOVERY_VERIFY_PROFILE_CLAIM`

Read the current state of one handle claim by id. Despite the provider's operation name and POST method, this free action does not approve or mutate the claim; Starcovery staff approve claims manually.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `claim_id` | string | Yes | Claim id returned by Start Profile Claims. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
