Skip to main content
POST
Open a sample as your campaign

Authorizations

Authorization
string
header
required

Either a Supabase user access token (from a password login, or the passwordless magic-link flow) or a long-lived forge_sk_… API key. Both are sent as Authorization: Bearer <value> and resolve to the same owner, so every endpoint accepts either. Session tokens expire in ~1h; API keys do not expire and are the credential for MCP clients, CI, and partner integrations.

Path Parameters

sample_id
string
required

Response

Your campaign over this sample (existing or newly created).

campaign_id
string
Example:

"camp_1f2e3d4c5b6a"