Skip to main content
POST
Import a Figma design file and create AI translation orders for one or more target languages. This endpoint handles the full pipeline: importing text layers from Figma, creating/reusing the project, and triggering translation for each target language. The Figma file is always re-imported to capture the latest design state. If a project already exists for this file, it will be reused.

Authorizations

This endpoint requires API key authentication. Include your API key in the request header:
  • Header name: X-Api-Key
  • Header value: Your API key from the Ollang dashboard

Prerequisites

Your Figma account must be connected to Ollang via OAuth before using this endpoint. Connect your Figma account from the Ollang dashboard under Settings → Integrations → Figma.

Body Parameters

string
required
The Figma file key. This is the identifier in the Figma URL between /design/ and the file name. Example: For https://www.figma.com/design/UwNAtPYAu5JPIhFc03M71h/My-Design, the file key is UwNAtPYAu5JPIhFc03M71h.
string
required
The full Figma file URL. Must contain figma.com.
string
required
The source language code of the design content (e.g., en, fr, de).
string[]
required
Array of target language codes to translate into. At least one is required.
string
Optional folder ID to organize the project in. If not provided, a default folder is used.

Response

string
The ID of the created or reused project.
string
The ID of the Figma import record containing extracted text layers.
array
Array of created orders, one per target language.

Error Responses