Reference

All tools

Every action Membrane can take, translated into plain English. You shouldn't need this page in day-to-day use — your AI calls these for you. We keep it here for troubleshooting and for the curious.

Reference only

You probably don't need this

You don't talk to tools directly — you describe what you want and the AI picks the right combination. If you're looking for how to actually run a campaign, the campaign pages are where to start.

Getting connected

generate_api_key

Issues the key your AI uses to act on your behalf. Running it a second time just returns the existing key — no duplicates. You never need to see or copy this key yourself; the AI handles it.

Sign out

revoke_api_key

Invalidates the current key. After this, your AI won't be able to do anything on your behalf until you sign in again. Useful if you suspect your account has been used without your permission.

Uploading your files

Get an upload link

request_upload_url

Creates a private browser page where you drag-and-drop your video or images. The link is single-use and expires in one hour.

Check upload status

check_upload_status

The AI runs this after you come back to chat saying 'uploaded'. Confirms your files landed safely before creating the campaign.

Creating text surveys

Create a text survey

create_survey

Creates a new text survey in a paused state. You'll add questions next, then flip it live.

Set survey questions

add_survey_questions

Adds or replaces the question list on an existing survey. Safe to rerun mid-campaign if you want to tweak wording.

Creating image surveys

Create a round-robin comparison

create_round_robin_survey

Creates a pairwise comparison survey from your uploaded images. Respondents see pairs and pick a favorite. See the round-robin guide for pair-count math.

Create a Yes/No image survey

create_binary_survey

Creates a binary (yes/no) survey. Respondents vote on each image independently.

Create an image-slider survey

create_image_survey

Creates a swipeable gallery where each image gets its own per-image free-text feedback.

Creating video ads

Create a video ad

create_advertisement

Creates a video advertisement from your uploaded file. Returns immediately — the video processes in the background for 3–5 minutes before it can go live.

Add feedback questions to an ad

add_ad_feedback_questions

Appends post-video feedback questions to a video ad. Only works if feedback was requested at creation time.

Managing campaigns

List your campaigns

list_campaigns

Returns every campaign you've created, optionally filtered to only live or only paused ones.

View a campaign

view_campaign

Pulls full details of a single campaign — title, status, questions, aggregate responses.

Start or stop a campaign

toggle_campaign_live

Flips a campaign on or off. For video ads, waits until processing is finished before accepting a 'live' request.

Reading results

Get an AI insight report

get_ai_insight_report

Returns an AI-ready summary of your campaign results — executive summary, question-by-question breakdowns, and suggested follow-up questions to ask the AI.

What's not here

There's no delete-campaign tool — campaigns can be paused but not removed. Core metadata (title, description, reward) can't be edited after creation; if you need to change those, create a new campaign instead.