Show the connected account's email, workspace, role, plan, and credit balance.

Use it when the user asks which account is connected, its plan, or its credits left.

Create a finished, designed presentation from a prompt, text, or an outline.

Use it when the user asks for a presentation, deck, slides, a pitch, or a PowerPoint. The deck is saved in the user's Presentations.AI workspace and can be exported as PPTX, PDF or slide images, or shared by link.

deck takes the same fields as POST /decks: e.g. prompt, sources ({"type": "text", "content": ...}), slide_count, audience, level_of_detail, deck_purpose, brand_kit_id (find one with search_brand_kits), or an edited outline from create_outline. Retrying an identical call returns the same deck; pass a new request_id to generate another copy.

Generation spends credits and takes a few minutes in the background: poll task_id with get_task, then fetch the file with get_export, or a public link with share_deck when the user asks for one.

Status of an async task (e.g. a presentation generation).

With wait_time=0, returns an immediate snapshot. With wait_time>0 (capped at 60s), waits until the task reaches COMPLETED/FAILED or the window elapses, then returns the latest status. Once a generation is COMPLETED, get_export returns its file.

Latest export artifact for a deck, with a short-lived download URL.

Get or create the deck's public share link and return the URL.

Anyone with the link can open the deck, so use it only when the user asks for a link or to share the deck. Reuses the existing link so the URL is stable; pass rotate=true to mint a fresh one (the previous URL stops working).

List projects, or folders with kind=FOLDER (optionally one container's children).

top_level=true keeps the caller's top level: no parent, or a parent they cannot reach. Not with parent_id. A project-bound key sees its project and the folders below it, with that project as its top.

Search the brand kits you can style a deck with.

Use a result's id as brand_kit_id when creating a deck. Includes published brands, your workspace's kits and your own unshared kits. A brand limited to approved email domains appears only when your verified email domain is one of them.

List accessible decks with project, flag, sort, search, and pagination filters.

Decks that have no slides yet (generation still running, or never completed) are omitted; fetch those by id.

Fetch deck metadata, latest generation status, and existing export artifacts.

Over MCP, export download URLs open without a key and expire after 15 minutes.

Soft-delete a deck; the operation is idempotent for an already deleted deck.

Rename a deck, change who can open it, or move it to another project.

It can also switch which content version the deck shows. Changing visibility can make the deck public or remove other people's access. It doesn't start generation or create an export.

Share a deck with one person, by user ID or email address, at the given role.

If they already have access, their role is replaced, which can lower it.

Generate a stateless outline from a prompt and/or extracted files.

No deck, session, or generation request is persisted. Referenced files must belong to the caller's workspace and have completed extraction before this request.

Bills the outline's slides at the Standard rate (10 credits per slide), once, before it is returned; an empty balance is a 402. Send an Idempotency-Key to retry safely: a key that already paid is a 409.