get_import_status
Retrieve the current status and summary of a specific import, including total, succeeded, failed, and warning counts. Tracks status lifecycle from scheduled through completed or reverted.
Instructions
Returns a single import's current status and summary (total / succeeded / failed / warnings). Status lifecycle: SCHEDULED → IN_PROGRESS → FINISHED | FINISHED_WITH_WARNINGS | FAILED | CANCELED. FINISHED can transition to REVERTING → REVERTED.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"companyId": "<companyId>",
"importId": "<importId>"
},
"name": "get_import_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| companyId | Yes | Company id from list_companies. | |
| importId | Yes | Import id from list_imports. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Import id. | |
| status | Yes | Lifecycle status (SCHEDULED, IN_PROGRESS, FINISHED, FINISHED_WITH_WARNINGS, FAILED, CANCELED, REVERTING, REVERTED). | |
| entityName | No | Entity type being imported. | |
| fileName | No | Uploaded file name. | |
| summary | No | Counts per result type. | |
| createdAt | No | ISO timestamp. | |
| finishedAt | No | ISO timestamp when reached terminal status, if applicable. |