---
updatedAt: 2026-04-21T11:22:20.000Z
agentTools:
  projectIndex: https://docs.lmnl.app/v2/llms.txt
---

# Import MPC shard

This API is a request to transfer of MPC (Multi-Party Computation) key shares from a mobile environment to the SDK. <br><br>In MPC, a private key is divided into multiple parts, called shards, which are distributed to authorised users of an organisation for enhanced security. Each shard is encrypted using the RSA public key associated with the SDK and can only be decrypted using the corresponding RSA private key within the SDK. <br><br> **Note** <li> Ensure to run the API only once after the shard sharing request is approved by the owner on their mobile device. <br><br> **Failure scenarios** <li> The API error response with the message "Encrypted shards not found" means that the owner has not yet approved the shard sharing request.

In MPC, a private key is divided into multiple parts, called shards, which are distributed to authorised users of an organisation for enhanced security. Each shard is encrypted using the RSA public key associated with the SDK and can only be decrypted using the corresponding RSA private key within the SDK.

<Callout icon="📘" theme="info">
  **Note**

  * Ensure to run the API only once after the shard sharing request is approved by the owner on their mobile device.
  * Failure scenario: The API error response with the message "Encrypted shards not found" means that the owner has not yet approved the shard sharing request.
</Callout>

<br />

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "API REFERENCES",
    "contact": {},
    "version": "8"
  },
  "servers": [
    {
      "url": "https://api-sdk.lmnl.dev",
      "variables": {}
    }
  ],
  "tags": [
    {
      "name": "Key management"
    }
  ],
  "paths": {
    "/api/mpc-shard/import": {
      "post": {
        "tags": [
          "Key management"
        ],
        "summary": "Import MPC shard",
        "description": "This API is a request to transfer of MPC (Multi-Party Computation) key shares from a mobile environment to the SDK. <br><br>In MPC, a private key is divided into multiple parts, called shards, which are distributed to authorised users of an organisation for enhanced security. Each shard is encrypted using the RSA public key associated with the SDK and can only be decrypted using the corresponding RSA private key within the SDK. <br><br> **Note** <li> Ensure to run the API only once after the shard sharing request is approved by the owner on their mobile device. <br><br> **Failure scenarios** <li> The API error response with the message \"Encrypted shards not found\" means that the owner has not yet approved the shard sharing request.",
        "operationId": "Import",
        "parameters": [],
        "responses": {
          "200": {
            "description": "",
            "headers": {},
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Export-OK-Response"
                    },
                    {
                      "example": {
                        "success": true
                      }
                    }
                  ]
                },
                "example": {
                  "success": true
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json; charset=utf-8": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Import-MPC-Shard-Internal-Server-Error-Response"
                    },
                    {
                      "example": {
                        "success": false,
                        "data": {},
                        "message": "Encrypted shards not found.",
                        "code": ""
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": [
          {
            "basic": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "Export-OK-Response": {
        "title": "Export-OK-Response",
        "required": [
          "success"
        ],
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        },
        "example": {
          "success": true
        }
      },
      "Import-MPC-Shard-Internal-Server-Error-Response": {
        "title": "Import-MPC-Shard-Internal-Server-Error-Response",
        "required": [
          "success"
        ],
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false,
            "description": "This indicates whether the request was successful or not."
          },
          "data": {
            "type": "object",
            "description": "This object contains the response data. Empty if the request was unsuccessful."
          },
          "message": {
            "type": "string",
            "description": "A short description of the error."
          },
          "code": {
            "type": "string",
            "description": "The status code of the error."
          }
        }
      }
    },
    "securitySchemes": {
      "basic": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": []
}
```