Submit API

Base URL https://rovexalaunch.com/api/v1. Machine-readable: OpenAPI 3.1. Each operation is also an MCP tool with the same name.

Submit a product by URL and edit the AI draft (needs sign-in)

POST`/api/v1/drafts`

Submit a product by its website URL. Starts a new listing from a website address. We read the site (respecting robots.txt) and an AI drafts the profile in about a minute, quoting evidence from the site for every value; anything not found there is left blank (never invented). Returns a draft with status 'crawling': poll get_draft every few seconds until status is 'ready', then review and edit it, then call submit_draft. Nothing is published and nothing is charged by this call.

MCP tool submit_listing · needs listings:write · accepts Idempotency-Key

Input	Where	Type	Description
`url` required	body	string	The product's public website, e.g. https://example.com

curl -X POST "https://rovexalaunch.com/api/v1/drafts" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "\u2026"}'

GET`/api/v1/drafts`

Your drafts on this site. Drafts you started on this site, newest first, with status and completeness.

MCP tool list_my_drafts · needs account:read · paginated

Input	Where	Type	Description
`page`	query	integer	Page number (1-based) (default 1)
`per_page`	query	integer	Items per page (default 20)

curl "https://rovexalaunch.com/api/v1/drafts" \
  -H "Authorization: Bearer $API_KEY"

GET`/api/v1/drafts/{id}`

Get a draft (poll while it builds). A draft with every profile field: value, state (ai / not_found / edited / manual / override / deleted) and the evidence quotes from the website, plus FAQs, founders, socials, story, milestones, completeness and what is still missing. While status is crawling or drafting, poll again.

MCP tool get_draft · needs account:read

Input	Where	Type	Description
`id` required	path	string	Draft id (from submit_listing)

curl "https://rovexalaunch.com/api/v1/drafts/DRAFT_ID" \
  -H "Authorization: Bearer $API_KEY"

PATCH`/api/v1/drafts/{id}`

Edit a draft. Edit any part of a draft in one call: profile fields (null removes one), lock fields against AI redrafts, ask the AI to redraft fields from the website evidence, restore the AI value, replace FAQs, socials, founders, story sections, milestones, set the main competitor and SEO text. Only send what you change. Returns the updated draft. If the draft was already submitted, the listing is updated too (call submit_draft again is not needed).

MCP tool update_draft · needs listings:write · accepts Idempotency-Key

Input	Where	Type	Description
`id` required	path	string	Draft id (from submit_listing)
`fields`	body	object	Set profile fields. A value you type is marked as yours (edited/manual); null removes the field. Categories: names from list_categories (first = primary).
`lock_fields`	body	array	Field names to lock against AI redrafts (override)
`regenerate`	body	array	Field names for the AI to redraft from the website (uses evidence; may take a few seconds)
`restore`	body	array	Field names to put back to the AI's original value
`faqs`	body	array	Replace all FAQs (max 5)
`company_socials`	body	object	Links by platform: linkedin, x, facebook, instagram, tiktok, youtube, threads, pinterest, github, reddit, producthunt, medium, website, custom
`founder_socials`	body	object	Links by platform: linkedin, x, facebook, instagram, tiktok, youtube, threads, pinterest, github, reddit, producthunt, medium, website, custom
`founders`	body	array	Replace the founders list (first = primary founder)
`story`	body	object	Founder story sections (each up to 8000 characters): title, story, why_started, problem, journey, challenges, achievements, lessons, whats_next
`milestones`	body	array	Replace milestones
`competitor_url`	body	string	Main competitor's website (we read it and compare); empty to clear
`seo`	body	object

curl -X PATCH "https://rovexalaunch.com/api/v1/drafts/DRAFT_ID" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

POST`/api/v1/drafts/{id}/invites`

Invite a co-founder. Emails a co-founder an invite to add their own profile to this listing (up to 10 invites).

MCP tool invite_cofounder · needs listings:write · accepts Idempotency-Key

Input	Where	Type	Description
`id` required	path	string	Draft id (from submit_listing)
`email` required	body	string	Co-founder's email

curl -X POST "https://rovexalaunch.com/api/v1/drafts/DRAFT_ID/invites" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "\u2026"}'

POST`/api/v1/drafts/{id}/submit`

Turn a ready draft into your listing. Saves the draft as your listing on this site (not published yet). Then publish it: either choose_free_listing (free, goes live in a future week once our badge is on your homepage) or create_checkout with the 'launch' product (paid: live at once or in the week you pick, plus extras). Re-running after edits updates the same listing.

MCP tool submit_draft · needs listings:write · accepts Idempotency-Key

Input	Where	Type	Description
`id` required	path	string	Draft id (from submit_listing)

curl -X POST "https://rovexalaunch.com/api/v1/drafts/DRAFT_ID/submit" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Submit API

POST/api/v1/drafts

GET/api/v1/drafts

GET/api/v1/drafts/{id}

PATCH/api/v1/drafts/{id}

POST/api/v1/drafts/{id}/invites

POST/api/v1/drafts/{id}/submit