Launch kits API

Launch kits and their day-by-day plans.

4 endpoints. Every path is relative to the API base URL and needs a bearer token unless it is marked public. See the REST API overview for authentication, errors and pagination.

GET/v1/orgs/{orgId}/launch-kits

Bearer tokenMCP tool: list_launch_kits

Lists the workspace's launch kits, newest first, with plan progress.

Path parameters

• orgIdstring (uuid)required

Query parameters

• pageinteger
• limitinteger

Responses

200Lists the workspace's launch kits, newest first, with plan progress.

• dataobjectrequired
  Fields

  • itemsarray<object>required
    Item fields

    • idstring (uuid)required
    • productNamestringrequired
    • launchDatestringrequired
    • timezonestringrequired
    • channelsarray<string>required
    • createdAtstringrequired
    • stepCountintegerrequired
    • doneCountintegerrequired
  • pageintegerrequired
  • limitintegerrequired
  • totalintegerrequired
  • hasMorebooleanrequired

Request

curl -X GET "https://api.adventur.ai/v1/orgs/$ORG_ID/launch-kits" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

POST/v1/orgs/{orgId}/launch-kits

Bearer tokenMCP tool: create_launch_kit

Writes a product launch in the brand voice: a Product Hunt listing and Show HN post to paste, launch posts for X, LinkedIn and Reddit drafted into Review as pending approval, and a day-by-day plan. Never schedules or publishes.

Path parameters

• orgIdstring (uuid)required

Request body application/json

• pitchstringrequired
• launchDatestringrequired
• productNamestring
• urlstring (uri)
• channelsarray<string>
• subredditsarray<any>
• guidancestring

Responses

201Writes a product launch in the brand voice: a Product Hunt listing and Show HN post to paste, launch posts for X, LinkedIn and Reddit drafted into Review as pending approval, and a day-by-day plan. Never schedules or publishes.

• dataobjectrequired
  Fields

  • kitobjectrequired
    Fields

    • idstring (uuid)required
    • orgIdstring (uuid)required
    • productNamestringrequired
    • pitchstringrequired
    • urlstring | nullrequired
    • launchDatestringrequired
    • timezonestringrequired
    • channelsarray<string>required
    • productHuntobject | nullrequired
      Fields

      • namestringrequired
      • taglinestringrequired
      • descriptionstringrequired
      • topicsarray<string>required
      • firstCommentstringrequired
      • galleryIdeasarray<string>required
    • hackerNewsobject | nullrequired
      Fields

      • titlestringrequired
      • urlstring | nullrequired
      • textstringrequired
    • stepsarray<object>required
      Item fields

      • idstringrequired
      • dayintegerrequired
      • datestringrequired
      • timestring | nullrequired
      • scheduledForUtcstring | nullrequired
      • kindstringrequired

        one of post, listing, task

      • channelstring | nullrequired

        one of product_hunt, hacker_news, x, linkedin, reddit

      • titlestringrequired
      • detailstringrequired
      • groupIdstring (uuid) | nullrequired
      • platformstring | nullrequired

        one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

      • postStatusstring | nullrequired

        one of draft, pending_approval, approved, scheduled, canceled

      • postTextstring | nullrequired
      • donebooleanrequired
    • createdAtstringrequired
    • updatedAtstringrequired
  • providerModelstringrequired
  • creditsUsednumberrequired
  • remainingCreditsnumberrequired

Request

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/launch-kits" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pitch":"string","launchDate":"string"}'

GET/v1/orgs/{orgId}/launch-kits/{kitId}

Bearer tokenMCP tool: get_launch_kit

The kit's Product Hunt and Show HN copy and its day-by-day plan, with each drafted post's current status.

Path parameters

• orgIdstring (uuid)required
• kitIdstring (uuid)required

Responses

200The kit's Product Hunt and Show HN copy and its day-by-day plan, with each drafted post's current status.

• dataobjectrequired
  Fields

  • idstring (uuid)required
  • orgIdstring (uuid)required
  • productNamestringrequired
  • pitchstringrequired
  • urlstring | nullrequired
  • launchDatestringrequired
  • timezonestringrequired
  • channelsarray<string>required
  • productHuntobject | nullrequired
    Fields

    • namestringrequired
    • taglinestringrequired
    • descriptionstringrequired
    • topicsarray<string>required
    • firstCommentstringrequired
    • galleryIdeasarray<string>required
  • hackerNewsobject | nullrequired
    Fields

    • titlestringrequired
    • urlstring | nullrequired
    • textstringrequired
  • stepsarray<object>required
    Item fields

    • idstringrequired
    • dayintegerrequired
    • datestringrequired
    • timestring | nullrequired
    • scheduledForUtcstring | nullrequired
    • kindstringrequired

      one of post, listing, task

    • channelstring | nullrequired

      one of product_hunt, hacker_news, x, linkedin, reddit

    • titlestringrequired
    • detailstringrequired
    • groupIdstring (uuid) | nullrequired
    • platformstring | nullrequired

      one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

    • postStatusstring | nullrequired

      one of draft, pending_approval, approved, scheduled, canceled

    • postTextstring | nullrequired
    • donebooleanrequired
  • createdAtstringrequired
  • updatedAtstringrequired

Request

curl -X GET "https://api.adventur.ai/v1/orgs/$ORG_ID/launch-kits/$KIT_ID" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

PATCH/v1/orgs/{orgId}/launch-kits/{kitId}

Bearer tokenMCP tool: update_launch_step

Marks one step of the launch plan done, or not done.

Path parameters

• orgIdstring (uuid)required
• kitIdstring (uuid)required

Request body application/json

• stepIdstringrequired
• donebooleanrequired

Responses

200Marks one step of the launch plan done, or not done.

• dataobjectrequired
  Fields

  • idstring (uuid)required
  • orgIdstring (uuid)required
  • productNamestringrequired
  • pitchstringrequired
  • urlstring | nullrequired
  • launchDatestringrequired
  • timezonestringrequired
  • channelsarray<string>required
  • productHuntobject | nullrequired
    Fields

    • namestringrequired
    • taglinestringrequired
    • descriptionstringrequired
    • topicsarray<string>required
    • firstCommentstringrequired
    • galleryIdeasarray<string>required
  • hackerNewsobject | nullrequired
    Fields

    • titlestringrequired
    • urlstring | nullrequired
    • textstringrequired
  • stepsarray<object>required
    Item fields

    • idstringrequired
    • dayintegerrequired
    • datestringrequired
    • timestring | nullrequired
    • scheduledForUtcstring | nullrequired
    • kindstringrequired

      one of post, listing, task

    • channelstring | nullrequired

      one of product_hunt, hacker_news, x, linkedin, reddit

    • titlestringrequired
    • detailstringrequired
    • groupIdstring (uuid) | nullrequired
    • platformstring | nullrequired

      one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

    • postStatusstring | nullrequired

      one of draft, pending_approval, approved, scheduled, canceled

    • postTextstring | nullrequired
    • donebooleanrequired
  • createdAtstringrequired
  • updatedAtstringrequired

Request

curl -X PATCH "https://api.adventur.ai/v1/orgs/$ORG_ID/launch-kits/$KIT_ID" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"stepId":"string","done":true}'