> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trypekto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Start Pekto smart presentation generation

> Create a secure generation request and return a Pekto URL. Opening that URL runs Pekto’s native outline, smart-template selection, content fitting, theme, and editable-project flow. Clients must not synthesize slide layouts themselves.



## OpenAPI

````yaml /openapi.json post /presentation-plans
openapi: 3.1.0
info:
  title: Pekto Developer API
  version: 1.0.0
  description: >-
    Generate editable presentations and LinkedIn/Instagram carousels, read and
    edit projects, browse templates and brand kits, and schedule social posts.
servers:
  - url: https://fwpvfpysaskvlxgwcaxk.supabase.co/functions/v1/api-v1
    description: Production Pekto Developer API
security:
  - bearerAuth: []
paths:
  /presentation-plans:
    post:
      summary: Start Pekto smart presentation generation
      description: >-
        Create a secure generation request and return a Pekto URL. Opening that
        URL runs Pekto’s native outline, smart-template selection, content
        fitting, theme, and editable-project flow. Clients must not synthesize
        slide layouts themselves.
      operationId: createPresentationPlan
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PresentationPlanInput'
      responses:
        '201':
          description: >-
            Created generation request. The job result contains generation_url
            for the user to open in Pekto.
components:
  schemas:
    PresentationPlanInput:
      type: object
      properties:
        topic:
          type: string
          description: Topic or title for the presentation
        content:
          type: string
          description: >-
            Source text, meeting notes, or article content to convert into
            slides
        instructions:
          type: string
          description: Custom design or tone instructions for the slides
        slide_count:
          type: integer
          minimum: 1
          maximum: 30
          description: Number of slides to generate
        language:
          type: string
          default: English
          description: Target language for the presentation
        aspect_ratio:
          type: string
          enum:
            - '16:9'
            - '4:5'
            - '1:1'
            - '9:16'
            - '4:3'
          default: '16:9'
        include_stock_images:
          type: boolean
          default: false
        use_web_search:
          type: boolean
          default: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Pekto API key (pekto_live_...), an OAuth 2.1 access token from Pekto
        sign-in (used by MCP clients), or a Pekto user session token.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.