Skip to main content
GET
Export text items

Authorizations

Authorization
string
header
required

Query Parameters

filter
string

Stringified JSON filter object. Supports the following filter fields:

  • projects: array of objects with id (project developer ID)
  • statuses: array of status strings (NONE, WIP, REVIEW, FINAL). These are stored status keys; by default the web app and Figma plugin display them as NONE = "Draft", WIP = "In Progress", REVIEW = "In Review", FINAL = "Final" (a workspace may rename these or replace the set entirely, so none of these keys are guaranteed to exist — read the workspace's actual statuses from GET /v2/statuses or the list_statuses MCP tool rather than assuming this set).
  • tags: object with values (array of tag strings) and optional operator (AND or OR, defaults to OR)
  • assignee: email string to match assigned text items, or null for unassigned
  • integrated: boolean value to filter by items that are or are not integrated into development

Example: {"projects":[{"id":"project-id"}], "statuses":["NONE","WIP","FINAL","REVIEW"], "tags":{"values":["tag-1"],"operator":"OR"}, "assignee":"user@example.com", "integrated":true}

sort
enum<string>

Sort order for the returned text items (default: id):

  • id sorts all items alphabetically by developer ID.
  • project_order groups items by project, returned alphabetically by project developer ID, then sorts within projects based on the custom sort order set up in the web app.
Available options:
id,
project_order
richText
enum<string>

When set to 'html', includes HTML-formatted rich text in the response.

Available options:
html
variantId
string
format
enum<string>
required

Output format for exported text items.

Available options:
json_icu,
json_i18next,
json_vue_i18n,
ios-strings,
ios-stringsdict,
android
variableSort
enum<string>

Order in which variables are indexed in positional format exports (ios-strings, ios-stringsdict, android). "alphabetical" assigns indices by variable name (a=1, b=2, ...); "default" preserves the existing creation-order assignment.

Available options:
default,
alphabetical

Response

Returns text item developer id - text item value key/value pairs in the desired format.

For json_icu, json_i18next, json_vue_i18n formats. Object keys are developer-ids (strings) and values are text (strings).

{key}
string

The text value for the developer-id key