Inspect the authenticated Hyperstar principal, workspace, scopes, and capabilities before running workflow tools.

List Hyperstar workspaces available to the current credential. Hosted all-workspace grants pass one organization_id as workspace_id on later calls; an API key is already bound to one workspace.

Return the recommended Hyperstar workflow sequence, discovery resources, and send-safety notes.

Create a creator search and return compact creator summaries. Use kind=keyword for YouTube, whose supported arguments are region and query and whose supported structured filters are follower_range, creator_language, and has_email; YouTube reference search and metric sorting are unavailable. TikTok/Instagram use semantic or reference search and their existing richer filters. A reference (lookalike) search needs its reference creator indexed first: check get_creator_catalog_status, and use request_creator_catalog_enrichment when it reports not_in_catalog; a 409 REFERENCE_CREATOR_NOT_INDEXED error means the same. Use search_id with save_search_results_to_campaign.

Page through an existing creator search. Defaults to compact creator summaries; use detail_level full only for raw detail-on-demand pages.

List campaigns in the authenticated workspace so agents can choose a campaign_id before saving search results.

Create a campaign in the authenticated workspace. Use the returned campaign id with save_search_results_to_campaign.

Save selected or top-ranked creator search results to a campaign roster server-side using search_id.

List creators saved on a campaign roster. Call check_bulk_email_readiness before any bulk-email send.

The final dry-run gate before bulk email. Requires recipient_target with exact IDs or a narrowed selection, checks those selected recipients, and returns sendability guidance.

Create an idempotent campaign email-unlock job after explicit cost confirmation. Unlocks only real catalog email addresses, including eligible YouTube channel emails.

Read a durable campaign email-unlock job status before checking bulk-email readiness.

REAL SEND: start a campaign bulk-email job after readiness has passed and the user authorized sending. Requires recipient_target, an explicit idempotency key, and send_confirmation: "user_authorized".

Read campaign bulk-email job status after start_bulk_email returns a job_id.

List Hyperstar inbox thread summaries with filters for triage. Call get_inbox_thread_messages before drafting replies.

Read full message history for one Hyperstar inbox thread before deciding whether to reply.

Read aggregate counts for Hyperstar inbox filters to summarize inbox state.

Archive, snooze, star, or set read state for one inbox thread without sending a message.

REAL SEND: send one user-authorized reply to a Hyperstar inbox thread with an explicit idempotency key and send_confirmation: "user_authorized".

Read campaign settings and status.

Update campaign settings or set active, paused or completed. Active-slot limits still apply.

Read workflow counts for the same platform, country, source, stage and search context as the roster.

Add a creator by canonical identity or manual username. Existing identities are deduplicated.

Edit contact details, memo, outreach metadata or correct the outreach stage. This does not send email or register posted content.

Save up to 100 matching creator IDs for review before copy or removal. Narrow larger selections.

Copy exact creator IDs or a prepared selection into another campaign. Return source and destination IDs; reuse the same key for retries.

Remove explicitly approved creator IDs or a prepared selection from a campaign. Requires confirmation and a stable retry key.

Read bounded finalized campaign revenue by provider and native currency. Details and products are opt-in.

Read campaign totals for an explicit UTC window, with lifetime metrics and missing-history coverage separately labeled.

Rank tracked videos by observed period metrics. Follow next_offset for more results.

Rank campaign creators by tracked-video period metrics. These are campaign metrics, not creator profile statistics.

Read bounded daily, weekly or monthly cumulative samples for one tracked campaign video.

Read bounded active/recent campaign email waves and delivery state counts.

Read one campaign email wave, including delivery uncertainty and cancellation availability.

Stop eligible pending sends in an explicitly approved wave. This cannot recall delivered mail.

Send again only to backend-eligible failures after fresh user approval. Successful and uncertain recipients are never automatically resent.

Check whether a TikTok/Instagram creator is indexed and can seed a reference (lookalike) search. Call this before a reference search; not_in_catalog means request_creator_catalog_enrichment first.

Queue indexing (crawl and embed) of a TikTok/Instagram creator so it can seed a reference search. Returns immediately; poll get_creator_catalog_status until ready_in_catalog. Indexing usually takes a few minutes.

Read a known creator by a stable ID or username. Recent content is optional and bounded.

List available system and workspace forms for a send.

Read one form template and its editable fields.

Create a workspace form with a stable retry key. Use explicit localized text for the creator audience.

Replace a workspace form configuration. Sent links retain immutable snapshots.

Delete an explicitly approved workspace form from future selection. System defaults remain protected.

Prepare an actor-bound email attachment, contract or draft/final upload. Return direct PUT instructions and an authenticated browser handoff.

Read upload status or refresh pending transfer instructions for the same actor and workspace.

Verify uploaded object metadata and accept it once. Repeat completion returns the same result.

Cancel an explicitly approved pending upload. Completed campaign files use their removal tool.

Authorize one inbox attachment and return a short-lived download URL.

Read contract and draft/final review file metadata for one creator.

Return a short-lived authorized download for a contract or selected draft/final file.

Remove an explicitly approved contract or exact draft/final file from its campaign creator.

Prepare a CSV/XLSX campaign import with a stable idempotency key. Choose browser handoff when the client cannot upload bytes; direct mode returns an S3 multipart POST. This does not start the import.

Read import progress, quota accounting and bounded row issues using the same job or handoff reference.

Start the uploaded canonical import only after user approval. Successful AND skipped rows consume upload quota; errors and unprocessed rows are refunded. Does not unlock emails or send mail.

Cancel a pending handoff or awaiting-upload/queued job. Processing jobs cannot be cancelled. Returns the actual state if the job already finished.

Get the result CSV for a terminal import. Result generation can remain pending after completion; preserve the reference and never reimport to retrieve results. Files expire after seven days.

Read available credits, upload quota and occupied creator/campaign capacity. Requires usage:read. Read-only; does not initialize balances or reserve units.

Advisory check for an import row count, saved-creator count, one campaign or email unlock. Unlock estimates accept 1–500 unique campaign roster IDs and also require campaigns:read. Never a reservation or guaranteed price.