slideforge-dev Sandbox API
The sandbox API from slideforge-dev — 1 operation(s) for sandbox.
The sandbox API from slideforge-dev — 1 operation(s) for sandbox.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/slideforge-dev:slideforge-dev-sandbox-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: SlideForge Sandbox API
description: 'Agent-first PowerPoint generation. Send structured slide intents (a `form` plus typed fields) or a brief; get back a real, editable `.pptx`. The draw path is deterministic — no model renders your slide, so supplied numbers and text come out verbatim. Every response carries `status`, `fidelity` and `warnings` so an automated caller can tell whether the output is usable. $0.05 per slide; an unusable slide is not billed. Authenticate with a SlideForge API key (`Authorization: Bearer sf_live_…` or `X-API-Key`) — new accounts include 60 free slides, no credit card: https://slideforge.dev/sign-up'
version: 5.356.0
servers:
- url: https://api.slideforge.dev
security:
- bearerAuth: []
- apiKeyAuth: []
tags:
- name: Sandbox
paths:
/v1/render/code:
post:
tags:
- Sandbox
summary: Execute python-pptx code in sandbox
description: 'Run arbitrary python-pptx code in a secure sandbox and get a PPTX file + PNG preview. The code is a python-pptx script (the presentation it saves is the output), or a `build(prs)` function (`build(prs, slide)` when chrome is provided). All python-pptx helpers (add_text_box, add_box, add_icon, etc.) are available. Dangerous imports are blocked. 30-second timeout.
Use this for custom layouts, novel visualizations, or any slide that needs full layout control. $0.05 per render. ~2 seconds.'
operationId: render_code_v1_render_code_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SandboxRenderRequest'
required: true
responses:
'200':
description: Render complete with signed URLs
content:
application/json:
schema: {}
'400':
description: Code validation failed (syntax error, blocked import, script made no presentation)
'408':
description: Execution timed out (30s limit)
'402':
description: Insufficient balance
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
Replacement:
properties:
old:
type: string
title: Old
description: Exact string to find in the code
new:
type: string
title: New
description: String to replace it with
type: object
required:
- old
- new
title: Replacement
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
SandboxRenderRequest:
properties:
code:
anyOf:
- type: string
maxLength: 64000
- type: 'null'
title: Code
description: Python code defining build(prs) or build(prs, slide). Required if job_id not provided. Max 64 KB — well above any real slide; the Jev screen (A2) screens the whole thing, so an unbounded field would let a padded payload slip past a prefix screen.
job_id:
anyOf:
- type: string
- type: 'null'
title: Job Id
description: Previous render_code job ID — loads its code for patching with replacements.
replacements:
anyOf:
- items:
$ref: '#/components/schemas/Replacement'
type: array
- type: 'null'
title: Replacements
description: String replacements to apply to the loaded code. Requires job_id.
theme_id:
anyOf:
- type: string
- type: 'null'
title: Theme Id
description: Theme ID for chrome + colors
logo_id:
anyOf:
- type: string
- type: 'null'
title: Logo Id
description: 'Uploaded logo (upload_asset purpose=logo): the account''s logo inside the code — add_logo(slide) draws it in the theme''s logo box.'
chrome:
anyOf:
- type: object
- type: 'null'
title: Chrome
description: 'Chrome overlays: title, subtitle, footer, etc.'
headline:
anyOf:
- type: string
- type: 'null'
title: Headline
description: Slide title (chrome-rendered; use build(prs, slide))
context:
anyOf:
- type: string
- type: 'null'
title: Context
description: Subtitle line under the title (chrome-rendered)
takeaway:
anyOf:
- type: string
- type: 'null'
title: Takeaway
description: Bottom takeaway band (chrome-rendered)
source_note:
anyOf:
- type: string
- type: 'null'
title: Source Note
description: Source citation in the footer zone (chrome-rendered)
notes:
anyOf:
- type: string
- type: 'null'
title: Notes
description: Speaker notes for the presenter; never drawn on the slide. Wins over notes the code wrote.
name:
anyOf:
- type: string
- type: 'null'
title: Name
description: Human-readable job name
include_preview:
anyOf:
- type: string
- type: 'null'
title: Include Preview
description: 'Embed preview inline: none, small (256px), default (768px), full. Default: none.'
verify:
type: string
title: Verify
description: 'Verification tier: off | lint (default — static geometry linter + composer content validators, no LLM) | lint+vlm (adds the VLM second-look, ~+8s) | full.'
default: lint
dry_run:
type: boolean
title: Dry Run
description: 'If true: run the verify tier and return status (validated if clean, invalid if errors) + warnings/errors with cost:0 and NO PPTX — a free pre-commit check. Fix errors, then render for real.'
default: false
quality_profile:
anyOf:
- type: string
- type: 'null'
title: Quality Profile
description: 'Readiness thresholds the layout block is judged against: executive | technical (default) | appendix.'
fail_on_vlm:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Fail On Vlm
description: 'VLM finding categories that BLOCK (escalate to errors, render free per usable-or-free): substring match on the finding, e.g. [''contrast'', ''clipping'']. A high-confidence `overlap` and any `content_missing` already block by default. Requires verify=lint+vlm.'
content:
anyOf:
- type: object
- type: 'null'
title: Content
description: 'Typed business facts (ADR 2026-07-14): available read-only as CONTENT inside the code; the renderer verifies every leaf rendered verbatim and emits fidelity + provenance. Keys named ''id'' are references, not display content.'
code_profile:
anyOf:
- type: string
- type: 'null'
title: Code Profile
description: widgets_only = compose via add_widget + approved helpers + CONTENT/theme only; raw python-pptx (slide.shapes.*, add_text_box/add_box, add_slide) is rejected. Omit or 'native' for full access. Response echoes code_profile.applied + violations.
type: object
title: SandboxRenderRequest
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'SlideForge API key: `Authorization: Bearer sf_live_…`. Create one at https://slideforge.dev/console/keys'
apiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Same key, header form — for clients that cannot set Authorization.