PitchBoost

Generate a hosted, shareable sample pitch deck from a short prompt with no PitchBoost account. The deck carries a small PitchBoost badge and the response includes a single-use claim token the user can enter after signing in to move the deck into their own account. Use this when the user has not connected PitchBoost. Generation takes up to a minute.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "What the deck should cover: the prospect or company, the offer, the audience, and the goal. Up to 1000 characters.",
      "maxLength": 1000
    }
  },
  "required": [
    "prompt"
  ]
}

Generate a published PitchBoost deck from a prompt describing the prospect, offer, audience, and goal. Returns a shareable link. Generation takes up to ~60 seconds.

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "What the deck should cover: the prospect or company, the offer, the audience, and the goal.",
      "maxLength": 4000
    },
    "kind": {
      "type": "string",
      "enum": [
        "pitch_deck",
        "one_sheeter",
        "faq"
      ],
      "description": "Deck type. Defaults to pitch_deck."
    }
  },
  "required": [
    "prompt"
  ]
}

Improve, redesign, polish or rebrand an existing presentation. Pass the text of every slide of the user's uploaded PowerPoint, Google Slides or Keynote deck (title and body, in order). PitchBoost keeps the content and figures, rebuilds every slide with professional layout in the user's brand, checks every number against the source, and returns a shareable link plus PDF and PowerPoint exports. Generation runs in the background for 2 to 4 minutes: this call returns a deal_id at once; call get_rebuild_status with it to get the link when ready.

{
  "type": "object",
  "properties": {
    "slides": {
      "type": "array",
      "description": "The source deck, one entry per slide in order. Extract these from the user's uploaded file: title is the slide heading if any, body is all other text on the slide.",
      "minItems": 1,
      "maxItems": 60,
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "Slide heading, if any.",
            "maxLength": 500
          },
          "body": {
            "type": "string",
            "description": "All other text on the slide, including bullet points and chart labels.",
            "maxLength": 3000
          }
        },
        "required": [
          "body"
        ]
      }
    },
    "mode": {
      "type": "string",
      "enum": [
        "preserve",
        "condense"
      ],
      "description": "preserve (default) keeps one slide per source slide; condense compresses a long deck to about 10 to 15 slides."
    },
    "instructions": {
      "type": "string",
      "description": "Optional guidance from the user, for example the audience, tone, or slides to emphasise. Up to 1000 characters.",
      "maxLength": 1000
    },
    "deal_name": {
      "type": "string",
      "description": "Optional name for the deck in the user's dashboard. Defaults to the first slide title.",
      "maxLength": 80
    }
  },
  "required": [
    "slides"
  ]
}

Check whether a rebuild started with rebuild_deck has finished. Returns the shareable link and editor link when the deck is ready, or how long it has been running.

{
  "type": "object",
  "properties": {
    "deal_id": {
      "type": "number",
      "description": "The deal_id returned by rebuild_deck."
    }
  },
  "required": [
    "deal_id"
  ]
}

Turn a deck's shareable link on. Rebuilt and generated decks go live at their share_url as soon as they are finished; use this when the user made one private and wants the link back. Not destructive and safe to repeat.

{
  "type": "object",
  "properties": {
    "deck_id": {
      "type": "number",
      "description": "The deck id (from get_rebuild_status, list_decks or get_deck)."
    }
  },
  "required": [
    "deck_id"
  ]
}

List the most recent published decks for your team, each with its shareable link.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "How many to return (1-50, default 20)."
    }
  }
}

Get a single deck by its numeric id, including its shareable link and metadata.

{
  "type": "object",
  "properties": {
    "deck_id": {
      "type": "number",
      "description": "The deck id."
    }
  },
  "required": [
    "deck_id"
  ]
}