Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API 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.
openapi: 3.2.0
info:
title: SlideForge Account 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: Account
paths:
/v1/account/deletion:
get:
tags:
- Account
summary: Check for a pending erasure
description: Returns the open erasure request on this account, if there is one.
operationId: deletion_status_v1_account_deletion_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DeletionStatusResponse'
post:
tags:
- Account
summary: Request erasure of your account (GDPR Art. 17)
description: 'Starts an account erasure. Nothing is deleted by this call: it sends a confirmation link to the account''s email address, valid for 24 hours. Confirming schedules the erasure 24 hours out, and it can be cancelled at any point before then.'
operationId: request_deletion_v1_account_deletion_post
responses:
'200':
description: Confirmation email sent
content:
application/json:
schema:
$ref: '#/components/schemas/DeletionRequestResponse'
'401':
description: Authentication required
'409':
description: No email address on the account — contact support instead
delete:
tags:
- Account
summary: Cancel a pending erasure
description: Withdraws an open erasure request. Only works before the erasure has run.
operationId: cancel_deletion_v1_account_deletion_delete
responses:
'200':
description: Request cancelled
content:
application/json:
schema: {}
'404':
description: No open request on this account
components:
schemas:
DeletionStatusResponse:
properties:
state:
anyOf:
- type: string
- type: 'null'
title: State
request_id:
anyOf:
- type: string
- type: 'null'
title: Request Id
scheduled_for:
anyOf:
- type: string
- type: 'null'
title: Scheduled For
type: object
title: DeletionStatusResponse
description: The open erasure request on this account, if any.
DeletionRequestResponse:
properties:
request_id:
type: string
title: Request Id
description: Reference for this request; quoted in every email about it
state:
type: string
title: State
description: pending_confirmation until the emailed link is clicked
message:
type: string
title: Message
description: What the requester must do next
email_sent_to:
anyOf:
- type: string
- type: 'null'
title: Email Sent To
description: Where the confirmation was sent
type: object
required:
- request_id
- state
- message
title: DeletionRequestResponse
description: What the caller gets back when an erasure is requested.
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.