This page collects the missing parameters discovered while drafting index.md, setup.md, tools.md, and examples.md.
For direct questions to ask product/API owners, see confirmation-questions.md.
Confirmed Values
| Area | Confirmed Value |
|---|
| MCP endpoint | https://dev.deckflow.com/mcp/v1/ |
| Authentication | API key only |
| First-batch clients | Claude Code, Claude Web/Desktop, Manus, OpenAI/ChatGPT |
| Output delivery | Temporary download links |
Connection
| Parameter | Needed Definition |
|---|
| MCP endpoint | Whether https://dev.deckflow.com/mcp/v1/ is production or dev/beta, plus staging/regional/versioning policy. |
| Transport | Remote HTTP only, SSE support, stdio/local server support, or multiple modes. |
| Server name | Canonical config key: deckflow, DeckFlow, or another name. |
| Capability discovery | Whether get_deckflow_capabilities exists and what it returns. |
Authentication And Permissions
| Parameter | Needed Definition |
|---|
| Auth method | Confirmed API key only. Still need key creation URL, header/env var, and client-specific secret handling. |
| API key scopes | File upload, task creation, task read, workspace read, glossary read, Brand DNA read, billing read, if scoped keys exist. |
| Workspace scope | Personal account, team workspace, organization, or project. |
| Token lifetime | Expiration, refresh, reconnect, logout, and revocation behavior. |
| Domain/app allowlist | Whether custom agents need domain whitelisting or app registration. |
| User identity tool | Final name and response shape for current user/account lookup. |
| Parameter | Needed Definition |
|---|
| File reference model | file_id, asset_id, signed upload URL, client attachment ID, external URL, or inline content. |
| Upload limits | Max size, max files per task, total batch size, page count, slide count, video duration. |
| Supported MIME types | Canonical MIME and extension list for each workflow. |
| URL import | Public URLs only, authenticated URLs, allowed domains, crawl depth, and timeout. |
| Inline content | Max length for pasted HTML, Markdown, text, and prompt fields. |
| Retention | How long uploaded inputs are stored and when they are deleted. |
Common Task Lifecycle
| Parameter | Needed Definition |
|---|
| Task ID | Format, stability, workspace visibility, and expiration. |
| Status enum | Canonical states for queueing, processing, success, failure, cancellation, and expiration. |
| Progress | Percent, stage labels, ETA, current step, or no progress. |
| Cancellation | Which tools support cancellation and when cancellation is allowed. |
| Retry behavior | Client retry rules, idempotency key support, and duplicate task prevention. |
| Webhooks | Whether MCP tasks can register callbacks or only support polling. |
| Error schema | Error code, message, retryable flag, field-level validation errors, and support trace ID. |
Output Delivery
| Parameter | Needed Definition |
|---|
| Result model | Files, previews, metadata, warnings, logs, and nested assets. |
| Download URLs | Temporary signed URL lifetime, access control, filename, and content type. |
| Multiple outputs | How PPTX + PDF or image batches are represented. |
| ZIP packaging | When multi-file outputs are zipped and how users request it. |
| Workspace persistence | Whether outputs appear in the DeckFlow web app/project library. |
| Result expiration | How long outputs stay downloadable. |
Create
| Parameter | Needed Definition |
|---|
source_type | Enum for file, URL, text, Markdown, topic, or mixed sources. |
source | File reference, URL, inline content, or multiple sources. |
prompt | Max length, required/optional behavior, and prompt safety rules. |
output_format | PPTX, PDF, HTML, image, or multiple output formats. |
slide_count | Exact number, min/max range, or agent-estimated default. |
aspect_ratio | Supported ratios and default. |
brand_profile_id | Brand DNA ID format and default profile behavior. |
template_id | Template catalog, compatibility, and preview support. |
language | Language code standard and auto-detection behavior. |
| Complex element handling | Defaults for formulas, charts, diagrams, images, tables, and nested structures. |
Revamp
| Parameter | Needed Definition |
|---|
| Input formats | PPTX, Keynote, PDF, and whether PPT is accepted. |
style_mode | Template, Brand DNA, custom instructions, or auto style. |
template_id | Template list, filtering, preview, and compatibility. |
brand_profile_id | Brand DNA availability, selection, and fallback. |
preserve_content | Whether content preservation is always enforced or configurable. |
| Batch revamp | Max files, ordering, output packaging, and per-file failures. |
| Output formats | Same as input, PPTX only, PDF, Keynote, or multiple. |
Translate
| Parameter | Needed Definition |
|---|
| Supported languages | Canonical list, language codes, locale variants, and right-to-left support. |
source_language | Optional, required, or auto-detected. |
target_language | Required field format. |
| Glossary model | glossary_id, inline terms, CSV upload, term case sensitivity, and priority. |
| Layout preservation | Defaults and warning behavior when translated text cannot fit. |
| Same-format output | Whether input format is always preserved or can be changed. |
| Image text translation | Whether OCR text inside images is translated by default. |
| Speaker notes/comments | Whether notes and comments are translated. |
| Parameter | Needed Definition |
|---|
operation enum | Final names for 13 converter operations. |
| HTML render options | Viewport, scale, wait time, external assets, fonts, and page height behavior. |
| PPT/video options | Duration per slide, animation handling, transition handling, resolution, FPS. |
| Image output options | PNG/JPEG/WebP, scale, page range, ZIP packaging, and naming. |
| Legacy PPT handling | Whether PPT input is converted directly or normalized to PPTX first. |
| Parameter | Needed Definition |
|---|
| OCR languages | Auto-detection, language hints, and supported scripts. |
| OCR output | Plain text, JSON blocks, coordinates, confidence, reading order. |
| PPTX font output | Font family, style, weight, slide usage, missing-font detection. |
| PPTX text output | Shape IDs, slide numbers, coordinates, style metadata, speaker notes. |
| Range parameter | Standardize on page_range, slide_range, or ranges. |
Merger And Splitter
| Parameter | Needed Definition |
|---|
| Merge order | Upload order, explicit order array, or filename sort. |
| Style preservation | How themes, masters, fonts, and duplicate assets are handled. |
| Split strategy | Split every slide, selected ranges, fixed chunk size, or named sections. |
| HTML player package | Canvas size, title, description, navigation, and asset packaging. |
| Partial failure | Behavior when one input file fails validation. |
Optimizer
| Parameter | Needed Definition |
|---|
| Compression quality | Presets, numeric ranges, defaults, and min quality. |
| Target size | Whether users can request a max MB output and what happens if impossible. |
| Image resize | Width/height rules, aspect ratio lock, upscaling policy, output type. |
| Font embedding | Font file upload, licensing warnings, subsetting, and font selection. |
| Video compression | Codec, bitrate, resolution, FPS, audio handling, and target format. |
Limits And Billing
| Parameter | Needed Definition |
|---|
| Plan access | Which DeckFlow plans can use MCP. |
| Credits | How tasks consume credits and how failed/cancelled tasks are charged. |
| Rate limits | Requests per minute, tasks per hour, concurrent jobs, batch limits. |
| Free tier | Whether MCP is available and with which limits. |
| Usage reporting | Whether agents can query remaining credits or task history. |
Documentation Publishing Checklist
- Confirm whether
https://dev.deckflow.com/mcp/v1/ is final production or dev/beta. - Confirm final tool names and remove "proposed" language.
- Add final JSON schemas or link to generated reference pages.
- Add real client screenshots only after integrations exist.
- Confirm security, retention, billing, and plan language with product/legal.
- Confirm examples against a working MCP server before publishing.