Start a database import

Import a completed upload into the selected database. The file must belong to the same user, organisation, project and database.

Tool: startDatabaseImport
Permission: database-imports:write
Kind: Destructive

Clients are told this tool can remove, overwrite or interrupt resources, or grant access. Set your client to ask before it runs it.

Queued work: send an idempotencyKey and reuse the same value when retrying this exact call.

Arguments

Name	Type	Required	Limits
`uploadId`	`string`	Yes	At least 1 character(s)
`mode`	`string`	No	See schema
`dryRun`	`boolean`	No	See schema
`snapshotBeforeImport`	`boolean`	No	See schema
`skipSnapshot`	`boolean`	No	See schema
`reason`	`string`	No	See schema
`projectId`	`string`	Yes	At least 1 character(s)
`databaseId`	`string`	Yes	At least 1 character(s)
`idempotencyKey`	`string`	Yes	At least 1 character(s)

Full input schema

{
  "type": "object",
  "properties": {
    "uploadId": {
      "type": "string",
      "minLength": 1
    },
    "mode": {
      "type": "string"
    },
    "dryRun": {
      "type": "boolean"
    },
    "snapshotBeforeImport": {
      "type": "boolean"
    },
    "skipSnapshot": {
      "type": "boolean"
    },
    "reason": {
      "type": "string"
    },
    "projectId": {
      "type": "string",
      "minLength": 1
    },
    "databaseId": {
      "type": "string",
      "minLength": 1
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Unique request key. Reuse this exact value when retrying the same operation."
    }
  },
  "required": [
    "projectId",
    "databaseId",
    "uploadId",
    "idempotencyKey"
  ],
  "additionalProperties": false
}

Example call

The params of a tools/call request. Replace the placeholder values with your own IDs.

{
  "name": "startDatabaseImport",
  "arguments": {
    "projectId": "REPLACE_WITH_PROJECT_ID",
    "databaseId": "REPLACE_WITH_DATABASE_ID",
    "uploadId": "REPLACE_WITH_UPLOAD_ID",
    "idempotencyKey": "REPLACE_WITH_IDEMPOTENCY_KEY"
  }
}

Result

The same data as the API operation, wrapped as {"untrusted_data": true, "source": "startDatabaseImport", "note": "...", "data": ...} so the model treats project content as data, not instructions.