# Faces Docs

## Docs

- [Introduction](https://faces.app/docs/en/introduction.md): Welcome to the Faces docs. Whether you're editing your first slide or connecting a custom domain, you'll find everything you need here.
- [Overview](https://faces.app/docs/en/guides/overview.md): Everything you need to know about using Faces: editing, publishing, sharing, collaboration, and billing.
- [Editing Content](https://faces.app/docs/en/guides/content.md): Learn how to edit text, images, icons, and tables on your slides using the content editor.
- [Using Controls](https://faces.app/docs/en/guides/controls.md): Fine-tune animations, sizes, colors, and other visual settings with slide controls.
- [Layouts](https://faces.app/docs/en/guides/layouts.md): Choose between slideshow and scroll layouts for your published project.
- [Publishing](https://faces.app/docs/en/guides/publishing.md): Publish your project and share it with anyone.
- [Access Control](https://faces.app/docs/en/guides/access-control.md): Control who can view your published project: public, invited-only, or organization-wide.
- [Custom Domains](https://faces.app/docs/en/guides/custom-domains.md): Connect your own domain to publish projects on a memorable, branded URL.
- [SEO & Discoverability](https://faces.app/docs/en/guides/seo.md): Make your published project findable on Google and other search engines.
- [Export (PDF & PowerPoint)](https://faces.app/docs/en/guides/pdf-export.md): Download your project as a PDF or PowerPoint file for offline sharing.
- [Multiplayer & Collaboration](https://faces.app/docs/en/guides/multiplayer.md): Work on projects together in real time with your team.
- [The Dashboard](https://faces.app/docs/en/guides/dashboard.md): Browse, search, and manage all your projects from the dashboard.
- [Billing, Credits & Plans](https://faces.app/docs/en/guides/billing.md): Understand how pricing, credits, and subscriptions work on Faces.
- [Account Settings](https://faces.app/docs/en/guides/account.md): Manage your password, security settings, and profile.
- [API Overview](https://faces.app/docs/en/api-reference/overview.md): REST API basics, including base URL, authentication, errors, and rate limits.
- [Authentication](https://faces.app/docs/en/authentication.md): How to create and use API keys to authenticate with the Faces API.
- [Quickstart](https://faces.app/docs/en/quickstart.md): Generate your first interactive, explorable deck with the Faces API in under 2 minutes.
- [Create Project](https://faces.app/docs/en/api-reference/projects/create.md): Create a new blank project. Add slides with Create Slide + Update Slide.
- [Generate Project](https://faces.app/docs/en/api-reference/projects/generate.md): Generate an interactive, explorable deck from a text prompt.
- [Get Job Status](https://faces.app/docs/en/api-reference/projects/job-status.md): Check the status of a project generation job.
- [List Projects](https://faces.app/docs/en/api-reference/projects/list.md): List your projects with optional filtering and pagination.
- [Get Project](https://faces.app/docs/en/api-reference/projects/get.md): Get detailed information about a project.
- [List Templates](https://faces.app/docs/en/api-reference/projects/templates.md): List your team's templates to reuse as a templateId when generating a project.
- [Rename Project](https://faces.app/docs/en/api-reference/projects/rename.md): Update a project's display name. The slug and URLs stay the same.
- [Duplicate Project](https://faces.app/docs/en/api-reference/projects/duplicate.md): Create a full copy of a project, including all of its slides.
- [Get Configuration](https://faces.app/docs/en/api-reference/projects/get-config.md): Read a project's configuration, including its shared design system tokens.
- [Update Configuration](https://faces.app/docs/en/api-reference/projects/update-config.md): Update a project's configuration and shared design system tokens.
- [Publish Project](https://faces.app/docs/en/api-reference/publishing/publish.md): Publish a project's latest version, making it publicly accessible.
- [Unpublish Project](https://faces.app/docs/en/api-reference/publishing/unpublish.md): Take a published project offline. Its slides are kept and can be re-published.
- [Get Project URL](https://faces.app/docs/en/api-reference/publishing/get-url.md): Get a project's live URL and the subdomains and domains available to switch to.
- [Update Project URL](https://faces.app/docs/en/api-reference/publishing/update-url.md): Change a project's path, switch subdomains, or point it at a custom domain.
- [Create Subdomain](https://faces.app/docs/en/api-reference/publishing/create-subdomain.md): Create a custom subdomain for the project's team.
- [Connect Domain](https://faces.app/docs/en/api-reference/publishing/connect-domain.md): Register a custom domain and get the DNS records to configure.
- [List Slides](https://faces.app/docs/en/api-reference/slides/list.md): List all slides in a project.
- [Get Slide](https://faces.app/docs/en/api-reference/slides/get.md): Read a slide's source files.
- [Create Slides](https://faces.app/docs/en/api-reference/slides/create.md): Create one or more empty slides in a project in a single atomic call.
- [Update Slide](https://faces.app/docs/en/api-reference/slides/update.md): Update a slide's source files. Validates before saving.
- [Reorder Slides](https://faces.app/docs/en/api-reference/slides/reorder.md): Reorder every slide in a project in a single atomic call.
- [Start Slide Editing](https://faces.app/docs/en/api-reference/slides/start-editing.md): Show a loading indicator in the editor while editing a slide.
- [Finish Slide Editing](https://faces.app/docs/en/api-reference/slides/finish-editing.md): Clear the loading indicator after editing a slide.
- [Capture Screenshot](https://faces.app/docs/en/api-reference/slides/screenshot.md): Render a slide headlessly and return a public screenshot URL.
- [Slide Authoring Guide](https://faces.app/docs/en/api-reference/slides/guide.md): Fetch the slide authoring guide covering conventions for writing face.tsx, face.content.json, and face.controls.json. Include in your agent's system prompt before calling updateSlide.
- [List Plugins](https://faces.app/docs/en/api-reference/plugins/list.md): List the face plugins available to attach to a slide.
- [Get Plugin Docs](https://faces.app/docs/en/api-reference/plugins/get.md): Fetch a plugin's config schema, functions, and code examples.
- [Configure Plugin](https://faces.app/docs/en/api-reference/plugins/setup.md): Configure a plugin instance on a slide.
- [List Teams](https://faces.app/docs/en/api-reference/teams/list.md): List the teams the authenticated user belongs to.
- [Create API Key](https://faces.app/docs/en/api-reference/auth/create-key.md): Create a new API key scoped to a team.
- [CLI Installation](https://faces.app/docs/en/cli/installation.md): Install and authenticate the Faces CLI to generate interactive decks from your terminal.
- [CLI Commands](https://faces.app/docs/en/cli/commands.md): Complete reference for all Faces CLI commands.
- [MCP Overview](https://faces.app/docs/en/mcp/overview.md): Use Faces with Claude and other MCP-compatible AI assistants to build presentations slide by slide.
- [MCP Setup](https://faces.app/docs/en/mcp/setup.md): Connect Faces to Claude, ChatGPT, or another MCP client to generate interactive presentations.

## OpenAPI Specs

- [openapi](https://faces.app/docs/openapi.json)