# Ditto

## Docs

- [Introduction](https://developer.dittowords.com/introduction.md)
- [Key Concepts](https://developer.dittowords.com/concepts.md): Concepts and features in Ditto that can be leveraged by developers
- [Authentication](https://developer.dittowords.com/api-reference/authentication.md)
- [Fetch activity](https://developer.dittowords.com/api-reference/activity/get-activity.md): Returns a paginated list of activity items (change events) in your workspace, optionally filtered by project, text item, library component, or entity type.
- [Fetch components](https://developer.dittowords.com/api-reference/components/get-components.md): Returns a list of components in your workspace.
- [Export components](https://developer.dittowords.com/api-reference/components/export-components.md): Returns components in your workspace in the provided format.
- [Create components](https://developer.dittowords.com/api-reference/components/create-components.md): Creates one or more library components in your workspace.
- [Update components](https://developer.dittowords.com/api-reference/components/patch-components.md): Updates a set of components' base or variant text, plural forms, tags, status, assignee, notes, character limit, integrated and variables.
- [Delete components](https://developer.dittowords.com/api-reference/components/delete-components.md): Deletes library components from the workspace by their developer IDs.
- [Fetch component folders](https://developer.dittowords.com/api-reference/component-folders/get-component-folders.md): Returns all folders in your component library, with their developer IDs, names, and parent folder (by developer ID; null when the folder sits directly under the library root).
- [Create component folders](https://developer.dittowords.com/api-reference/component-folders/create-component-folders.md): Creates one or more folders in the component library.
- [Update component folders](https://developer.dittowords.com/api-reference/component-folders/patch-component-folders.md): Updates a set of component folders.
- [Delete component folders](https://developer.dittowords.com/api-reference/component-folders/delete-component-folders.md): Deletes folders from the component library.
- [Fetch projects](https://developer.dittowords.com/api-reference/projects/get-projects.md): Returns a list of Ditto projects in your workspace.
- [Create a project](https://developer.dittowords.com/api-reference/projects/create-projects.md): Creates a new Ditto project in your workspace.
- [Fetch project blocks](https://developer.dittowords.com/api-reference/project-blocks/get-project-blocks.md): Returns the blocks in a Ditto project, in display order.
- [Create project blocks](https://developer.dittowords.com/api-reference/project-blocks/create-project-blocks.md): Creates one or more blocks in a Ditto project.
- [Update project blocks](https://developer.dittowords.com/api-reference/project-blocks/patch-project-blocks.md): Updates a set of blocks in a Ditto project.
- [Delete project blocks](https://developer.dittowords.com/api-reference/project-blocks/delete-project-blocks.md): Deletes blocks from a Ditto project.
- [Fetch statuses](https://developer.dittowords.com/api-reference/statuses/get-statuses.md): Returns the statuses which text items and library components in the workspace can be set to, in workflow order — from earliest (a first draft) to latest (ready to ship).
- [Get style guides](https://developer.dittowords.com/api-reference/styleguides/get-styleguides.md): Returns the style guides created in the workspace, with their sections and rules.
- [Create a style guide](https://developer.dittowords.com/api-reference/styleguides/create-styleguides.md): Creates a new style guide in your workspace.
- [Update a style guide](https://developer.dittowords.com/api-reference/styleguides/patch-styleguides.md): Updates a style guide's name, description, enabled-by-default setting, or sections.
- [Create style guide rules](https://developer.dittowords.com/api-reference/styleguides/create-styleguide-rules.md): Creates one or more rules in a style guide section.
- [Update style guide rules](https://developer.dittowords.com/api-reference/styleguides/patch-styleguide-rules.md): Updates a set of style guide rules, each identified by its Developer ID.
- [Delete style guide rules](https://developer.dittowords.com/api-reference/styleguides/delete-styleguide-rules.md): Deletes style guide rules by their Developer IDs.
- [Fetch text items](https://developer.dittowords.com/api-reference/text-items/get-text-items.md): Returns a list of text items in your workspace.
- [Export text items](https://developer.dittowords.com/api-reference/text-items/export-text-items.md): Returns text items in your workspace in the desired export format.
- [Create text items](https://developer.dittowords.com/api-reference/text-items/create-text-items.md): Creates a set of text items in a project.
- [Update text items](https://developer.dittowords.com/api-reference/text-items/patch-text-items.md): Updates a set of text items' base or variant text, plural forms, tags, status, assignee, notes, character limit, integrated, variables, and block placement.
- [Update text items](https://developer.dittowords.com/api-reference/text-items/update-text-items.md): Updates a set of text items' base or variant text, tags, status, assignee, and plural forms.
- [Delete text items](https://developer.dittowords.com/api-reference/text-items/delete-text-items.md): Deletes text items by their developer IDs.
- [Fetch variables](https://developer.dittowords.com/api-reference/variables/get-variables.md): Returns a list of the variables in the workspace.
- [Create variables](https://developer.dittowords.com/api-reference/variables/create-variables.md): Creates variables in your workspace.
- [Update variables](https://developer.dittowords.com/api-reference/variables/patch-variables.md): Renames variables or changes their type or value.
- [Delete variables](https://developer.dittowords.com/api-reference/variables/delete-variables.md): Permanently deletes variables from your workspace.
- [Fetch variants](https://developer.dittowords.com/api-reference/variants/get-variants.md): Returns a list of the variants in the workspace.
- [Create variants](https://developer.dittowords.com/api-reference/variants/create-variants.md): Creates one or more variants in the workspace.
- [Update variants](https://developer.dittowords.com/api-reference/variants/patch-variants.md): Updates one or more variants in the workspace, identified by their current developer IDs.
- [Delete variants](https://developer.dittowords.com/api-reference/variants/delete-variants.md): Deletes variants from the workspace by their developer IDs. This can't be undone.
- [Installation](https://developer.dittowords.com/cli-reference/authentication.md): Installation and authentication of the Ditto CLI
- [Configuration](https://developer.dittowords.com/cli-reference/configuration.md): Setting what text and formats the CLI pulls down
- [Commands](https://developer.dittowords.com/cli-reference/commands.md): Commands supported by the CLI
- [Files](https://developer.dittowords.com/cli-reference/files.md): The file structure of text pulled down via the CLI
- [Overview](https://developer.dittowords.com/agent-setup-package/overview.md): Install the Ditto MCP server, always-on instructions, and skills in one step with the agent setup package
- [Overview](https://developer.dittowords.com/mcp-reference/overview.md): Overview of Ditto's MCP server for AI coding agents
- [Installation](https://developer.dittowords.com/mcp-reference/installation.md): Connect the Ditto MCP server to Claude Code, Codex, Cursor, VS Code, Windsurf, Figma Make, and other MCP clients
- [Tools](https://developer.dittowords.com/mcp-reference/tools.md): Available tools in the Ditto MCP server
- [Example use cases](https://developer.dittowords.com/mcp-reference/examples.md): Example prompts and instructions for using the Ditto MCP server with AI coding agents
- [Overview](https://developer.dittowords.com/ditto-specs-cli-reference/overview.md): Overview of Ditto spec files and the Specs CLI for AI-assisted content governance
- [Setup](https://developer.dittowords.com/ditto-specs-cli-reference/setup.md): Install the Specs CLI, configure your project, and set up API keys and agent integration
- [Commands](https://developer.dittowords.com/ditto-specs-cli-reference/commands.md): All commands available in the Ditto Specs CLI
- [Ditto Spec Files](https://developer.dittowords.com/ditto-specs-cli-reference/spec-files.md): Format and structure of .ditto.md Ditto spec files for workspaces and components
- [Agent Skills](https://developer.dittowords.com/ditto-specs-cli-reference/agent-skills.md): Interactive agent workflows for scaffolding Ditto specs, auditing text, and finding style guide rule gaps
- [GitHub PR Review Bot](https://developer.dittowords.com/additional-tools/github-pr-review-bot.md): Automatically review pull requests for style guide violations and text re-use suggestions
- [Webhooks](https://developer.dittowords.com/additional-tools/webhooks.md): Webhooks enable HTTP payloads to be sent to an external service when data in Ditto is changed.
- [GitHub Action](https://developer.dittowords.com/additional-tools/gh-action.md): Automatically create pull requests with the latest text updates
- [Authentication](https://developer.dittowords.com/legacy/api-reference-legacy/authentication.md)
- [Fetch component text](https://developer.dittowords.com/legacy/api-reference-legacy/components/fetch-component-text.md): Returns the components in the workspace of the requesting user. Only component libraries with Developer Mode enabled can be fetched.
- [Import components via a file](https://developer.dittowords.com/legacy/api-reference-legacy/components/import-components-via-a-file.md): For more information about importing components via a file please see: https://dittov3.notion.site/Importing-JSON-iOS-Android-Files-256cc8865c7a80fe94cdf135631bf8c6. The request body must be of type multipart/form-data.
- [Update component text variant](https://developer.dittowords.com/legacy/api-reference-legacy/components/update-component-text-variant.md): Used for updating the text and status fields for components in the workspace of the requesting user.
- [Fetch component folders](https://developer.dittowords.com/legacy/api-reference-legacy/components-folders/fetch-component-folders.md): Returns an object of component folders in the requesting user's workspace.
- [Fetch component text by component folder](https://developer.dittowords.com/legacy/api-reference-legacy/components-folders/fetch-component-text-by-component-folder.md): Returns the components in the specified folder. Format is identical to the format used by the Fetch components endpoint.
- [Fetch component text by project id](https://developer.dittowords.com/legacy/api-reference-legacy/projects/fetch-component-text-by-project-id.md): Returns the components used in the specified project. Format is identical to the format used by the Fetch components endpoint.
- [Fetch projects](https://developer.dittowords.com/legacy/api-reference-legacy/projects/fetch-projects.md): Returns a list of Ditto projects. Only projects with Developer Mode enabled can be fetched.
- [Fetch text by project id](https://developer.dittowords.com/legacy/api-reference-legacy/projects/fetch-text-by-project-id.md): Returns the contents of the Ditto project referred to by :id. You can find the id of a Ditto project from its URL: https://app.dittowords.com/doc/:id. Only projects with Developer Mode enabled can be fetched.
- [Fetch project folders](https://developer.dittowords.com/legacy/api-reference-legacy/project-folders/fetch-project-folders.md): Returns a list of project folders in the workspace of the requesting user.
- [Fetch projects by project folder id](https://developer.dittowords.com/legacy/api-reference-legacy/project-folders/fetch-projects-by-project-folder-id.md): Returns a list of projects in the specified project folder.
- [Fetch variables](https://developer.dittowords.com/legacy/api-reference-legacy/variables/fetch-variables.md): Returns the variables in the workspace of the requesting user.
- [Fetch variants](https://developer.dittowords.com/legacy/api-reference-legacy/variants/fetch-variants.md): Returns a list of variants in the workspace of the requesting user.
- [Installation](https://developer.dittowords.com/legacy/cli-reference-legacy/authentication.md): Installation and authentication of the Ditto CLI
- [Configuration](https://developer.dittowords.com/legacy/cli-reference-legacy/configuration.md): Setting what text and formats the CLI pulls down
- [Files](https://developer.dittowords.com/legacy/cli-reference-legacy/files.md): The file structure of text pulled down via the CLI
- [SDKs](https://developer.dittowords.com/additional-tools/sdks.md): Framework-specific SDKs help developers surface the text managed by Ditto directly in frontend development
- [VS Code Extension](https://developer.dittowords.com/additional-tools/vs-code.md): Extract hardcoded strings into existing Ditto components directly in VS Code
- [Feedback & Support](https://developer.dittowords.com/feedback-support/feedback-support.md)
- [Changelog](https://developer.dittowords.com/feedback-support/changelog.md)

## OpenAPI Specs

- [openapi](https://developer.dittowords.com/openapi.json)
- [openapi-legacy](https://developer.dittowords.com/openapi-legacy.json)
- [openapi-10-18-23](https://developer.dittowords.com/openapi-10-18-23.json)

## Optional

- [Help Guides](https://help.dittowords.com/en/)
- [What's New](https://www.dittowords.com/whats-new)
- [Figma Plugin](https://www.figma.com/community/plugin/798826066406007173/%E2%9C%8D%EF%B8%8F-Ditto-%7C-Manage-copy-from-design-to-production)