Execute a versioned content command
The request is bounded to 1 MiB and at most 1,000 mapped layers. Scope comes from the connection, never the command. Writes reuse content permissions, review and maintenance checks. A preview expires after 24 hours; completed operation receipts remain durable. Command response schemas: scope: Scope; search: TTablePage; resolve: Snapshot; preview: Preview; result: Preview; cancel: Preview; save: Preview; acknowledge: Preview; key: TTranslationKey; values: TValuesPage; value.save: TTranslationValue; key.update: TTranslationKey; review: WReviewResult; history: THistoryPage; context: WContext; context.save: WContext; suggestions: WSuggestions; mentions: Mentions; discussions: WDiscussionThreads; discussion.create: WDiscussionThread; discussion.resolve: WDiscussionThread; comments: WDiscussionComments; comment.reply: WDiscussionComment; comment.edit: WDiscussionComment; comment.history: WDiscussionHistory; images: WImages; image.reserve: WImage; providers: SafeProviders; provider.usage: AUsage; assistance.preview: AJob; assistance.job: AJob; assistance.items: ASuggestionPage; assistance.generate: AJob; assistance.cancel: AJob; assistance.context: AJob; assistance.edit: ASuggestion; assistance.apply: AApplyResult.
POST /api/v1/figma/operationsOperation: executeFigmaOperation · Download OpenAPI
Access
Section titled “Access”This operation does not use the panel session as its authentication mechanism. Follow the operation-specific checks described above.
plugin
{ "type": "http", "scheme": "bearer", "description": "Ephemeral delegated credential held in plugin memory; current parent session and scope remain authoritative."}Parameters
Section titled “Parameters”| Name | Location | Required | Description |
|---|---|---|---|
X-Localisync-Figma-Protocol |
header | Yes | See constraints below. |
Origin |
header | Yes | Must equal the configured panel origin. |
X-Localisync-Figma-Protocol
Section titled “X-Localisync-Figma-Protocol”{ "type": "string", "enum": [ "1" ]}Origin
Section titled “Origin”{ "type": "string"}Request body
Section titled “Request body”Required: Yes.
application/json
Section titled “application/json”Schema reference: Operation.
{ "$ref": "#/components/schemas/Operation"}Responses
Section titled “Responses”Authorized result.
Content type: application/json
Schema reference: OperationResult.
{ "$ref": "#/components/schemas/OperationResult"}Authorized result from a POST command.
Content type: application/json
Schema reference: OperationResult.
{ "$ref": "#/components/schemas/OperationResult"}Safe failure; preserve drafts and inspect the existing operation before retrying.
Content type: application/json
Schema reference: Error.
| Field | Type | Required | Constraints / description |
|---|---|---|---|
error |
string | Yes | — |
message |
string | Yes | — |
requestId |
string | No | format: "uuid"; pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" |
{ "$ref": "#/components/schemas/Error"}Safe failure; preserve drafts and inspect the existing operation before retrying.
Content type: application/json
Schema reference: Error.
| Field | Type | Required | Constraints / description |
|---|---|---|---|
error |
string | Yes | — |
message |
string | Yes | — |
requestId |
string | No | format: "uuid"; pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" |
{ "$ref": "#/components/schemas/Error"}Safe failure; preserve drafts and inspect the existing operation before retrying.
Content type: application/json
Schema reference: Error.
| Field | Type | Required | Constraints / description |
|---|---|---|---|
error |
string | Yes | — |
message |
string | Yes | — |
requestId |
string | No | format: "uuid"; pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" |
{ "$ref": "#/components/schemas/Error"}Safe failure; preserve drafts and inspect the existing operation before retrying.
Content type: application/json
Schema reference: Error.
| Field | Type | Required | Constraints / description |
|---|---|---|---|
error |
string | Yes | — |
message |
string | Yes | — |
requestId |
string | No | format: "uuid"; pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" |
{ "$ref": "#/components/schemas/Error"}Safe failure; preserve drafts and inspect the existing operation before retrying.
Content type: application/json
Schema reference: Error.
| Field | Type | Required | Constraints / description |
|---|---|---|---|
error |
string | Yes | — |
message |
string | Yes | — |
requestId |
string | No | format: "uuid"; pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" |
{ "$ref": "#/components/schemas/Error"}Safe failure; preserve drafts and inspect the existing operation before retrying.
Content type: application/json
Schema reference: Error.
| Field | Type | Required | Constraints / description |
|---|---|---|---|
error |
string | Yes | — |
message |
string | Yes | — |
requestId |
string | No | format: "uuid"; pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" |
{ "$ref": "#/components/schemas/Error"}Safe failure; preserve drafts and inspect the existing operation before retrying.
Content type: application/json
Schema reference: Error.
| Field | Type | Required | Constraints / description |
|---|---|---|---|
error |
string | Yes | — |
message |
string | Yes | — |
requestId |
string | No | format: "uuid"; pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" |
{ "$ref": "#/components/schemas/Error"}Safe failure; preserve drafts and inspect the existing operation before retrying.
Content type: application/json
Schema reference: Error.
| Field | Type | Required | Constraints / description |
|---|---|---|---|
error |
string | Yes | — |
message |
string | Yes | — |
requestId |
string | No | format: "uuid"; pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" |
{ "$ref": "#/components/schemas/Error"}Safe failure; preserve drafts and inspect the existing operation before retrying.
Content type: application/json
Schema reference: Error.
| Field | Type | Required | Constraints / description |
|---|---|---|---|
error |
string | Yes | — |
message |
string | Yes | — |
requestId |
string | No | format: "uuid"; pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" |
{ "$ref": "#/components/schemas/Error"}Related guidance
Section titled “Related guidance”
Choose whether we remember appearance preferences and use Google Analytics on Localisync and its documentation. Optional storage stays off until you accept.
Read our cookie policy