> ## Documentation Index > Fetch the complete documentation index at: https://developer.dittowords.com/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > These are Ditto's developer docs. Ditto is a single source of truth for product copy across design, review, localization, and code. > The first step on any codebase is a scan: https://developer.dittowords.com/get-started/scan-your-repo.md. That page also covers reviewing the style guide Ditto drafts from the scan. After it, the follow-on guides are Connect Figma files and Set up localization (under /guides/) and Connect the Ditto MCP (the Setup page of the MCP reference). > Two different MCP servers: the Ditto MCP server at https://api.dittowords.com/v2/mcp gives an agent a workspace's text and style guide rules; the documentation MCP server at https://developer.dittowords.com/mcp searches these docs. > Prefer logging in with a Ditto account (npx -y @dittowords/cli@latest login; OAuth in MCP clients) over API keys. API keys are for CI and headless clients only. > Commands are complete as written and use npx -y @dittowords/cli@latest; nothing needs a global install. # Create variants > Creates one or more variants in the workspace. A variant is a named alternative that text items and library components can each have their own text for — most often a locale to translate into, but also a tone or brand variation. Creating a variant adds no text on its own; use the text item endpoints to set a text item's text for that variant. Read the developer IDs off the response rather than assuming them — a developer ID you don't specify is generated from the name. ## OpenAPI ````yaml openapi.json post /variants openapi: 3.0.0 info: version: 1.0.0 title: Ditto API description: Programmatically read and write data in your Ditto workspace. servers: - url: https://api.dittowords.com/v2 security: [] paths: /variants: post: tags: - Variants summary: Create variants description: >- Creates one or more variants in the workspace. A variant is a named alternative that text items and library components can each have their own text for — most often a locale to translate into, but also a tone or brand variation. Creating a variant adds no text on its own; use the text item endpoints to set a text item's text for that variant. Read the developer IDs off the response rather than assuming them — a developer ID you don't specify is generated from the name. requestBody: content: application/json: schema: type: object properties: variants: type: array items: type: object properties: name: type: string minLength: 1 description: >- The variant's name. Must be unique within the workspace; 'base' is reserved. developerId: type: string minLength: 1 description: >- Optional preconfigured developer ID for the variant. Must be unique within the workspace, and 'base' and 'all' are reserved. Accepted in any casing and stored lowercase. Characters outside letters, numbers, hyphens, and underscores are stripped. If omitted, one is generated from the name. description: type: string description: Optional description of what the variant is for. localeCode: type: string enum: - af - ar - ar-ae - ar-bh - ar-dz - ar-eg - ar-iq - ar-jo - ar-kw - ar-lb - ar-ly - ar-ma - ar-om - ar-qa - ar-sa - ar-sy - ar-tn - ar-ye - az - be - bg - bs - ca - cs - cy - da - de - de-at - de-ch - de-li - de-lu - el - en - en-au - en-bz - en-ca - en-gb - en-ie - en-jm - en-nz - en-sg - en-tt - en-us - en-za - es - es-ar - es-bo - es-cl - es-co - es-cr - es-do - es-ec - es-gt - es-hn - es-mx - es-ni - es-pa - es-pe - es-pr - es-py - es-sv - es-uy - es-ve - et - eu - fa - fi - fo - fr - fr-be - fr-ca - fr-ch - fr-lu - ga - gd - he - hi - hr - hu - hy - id - is - it - it-ch - ja - ka - kk - ko - ku - lt - lv - mk - ml - ms - mt - nb - nl - nl-be - nn - 'no' - pa - pl - pt - pt-br - rm - ro - ro-md - ru - ru-md - sk - sl - sq - sr - sv - sv-fi - th - tn - tr - ts - uk - ur - ve - vi - wen - xh - yi - zh-cn - zh-hk - zh-sg - zh-tw - zu description: >- Locale code for the variant, from the set Ditto supports. Casing does not matter on the way in — 'fr-CA' and 'fr-ca' are both accepted — and the code is stored lowercase, which is the form reads return. Not every language-region pairing exists in the set, so pick one of the listed values rather than composing your own. At most one variant per workspace can hold a given locale code. Set this whenever the variant represents a language: translation tools treat it as the authoritative target locale. required: - name minItems: 1 description: Array of new variants to create required: - variants example: variants: - name: Spanish localeCode: es - name: Canadian French developerId: fr-ca description: French translations for Canada responses: '200': description: Returns the developer IDs of the created variants, in request order content: application/json: schema: type: object properties: developerIds: type: array items: type: string description: >- Array of developer IDs for the created variants, in request order required: - developerIds example: developerIds: - spanish - fr-ca '400': description: >- Returned when the request body fails validation. Common causes include: the same name, developer ID, or locale code appearing twice in one request; a reserved developer ID. content: application/json: schema: type: object properties: message: type: string description: Error message describing the validation failure required: - message example: message: 'Duplicate locale codes in request: es' '409': description: >- Returned when a name, developer ID, or locale code is already in use by another variant in the workspace content: application/json: schema: type: object properties: message: type: string description: Error message describing the conflict required: - message example: message: >- Locale code already attached to another variant: es. A locale code can belong to at most one variant. security: - ApiKeyAuth: [] components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.