Get project import status.
curl --request GET \
--url https://{host}/v1/projects/{projectId}/import/{importId} \
--header 'x-api-key: <api-key>'{
"success": true,
"data": {
"id": "imp_01JIMPORT123",
"type": "import",
"status": "completed",
"phase": "completed",
"progressPercent": 100,
"layers": {
"core": "activated",
"connections": "activated",
"workflows": "activated"
},
"dependencyValidation": {
"valid": true,
"missing": [],
"circular": []
},
"applied": {
"created": 3,
"updated": 2,
"deleted": 0,
"toolsCreated": 1,
"toolsUpdated": 1,
"toolsDeleted": 0
},
"warnings": [],
"errors": [],
"createdAt": "2026-09-01T09:00:00Z",
"completedAt": "2026-09-01T09:00:14Z"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"stage": "<string>",
"layer": "core",
"path": "<string>",
"line": 2,
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"stage": "<string>",
"layer": "core",
"path": "<string>",
"line": 2,
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"stage": "<string>",
"layer": "core",
"path": "<string>",
"line": 2,
"details": {}
}
}Get project import status
Get the status of a project import, including layer progress, warnings, errors, and applied counts.
GET
/
v1
/
projects
/
{projectId}
/
import
/
{importId}
Get project import status.
curl --request GET \
--url https://{host}/v1/projects/{projectId}/import/{importId} \
--header 'x-api-key: <api-key>'{
"success": true,
"data": {
"id": "imp_01JIMPORT123",
"type": "import",
"status": "completed",
"phase": "completed",
"progressPercent": 100,
"layers": {
"core": "activated",
"connections": "activated",
"workflows": "activated"
},
"dependencyValidation": {
"valid": true,
"missing": [],
"circular": []
},
"applied": {
"created": 3,
"updated": 2,
"deleted": 0,
"toolsCreated": 1,
"toolsUpdated": 1,
"toolsDeleted": 0
},
"warnings": [],
"errors": [],
"createdAt": "2026-09-01T09:00:00Z",
"completedAt": "2026-09-01T09:00:14Z"
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"stage": "<string>",
"layer": "core",
"path": "<string>",
"line": 2,
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"stage": "<string>",
"layer": "core",
"path": "<string>",
"line": 2,
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"stage": "<string>",
"layer": "core",
"path": "<string>",
"line": 2,
"details": {}
}
}operationId that Start project import returns. The response shows the overall status, the progressPercent, and the state of each layer: pending, staged, activated, skipped, failed, or rolled_back. The request needs the project_io.write scope.
After the import finishes, applied shows how many records and tools the import created, updated, and deleted. dependencyValidation lists missing and circular dependencies. Warnings are informational and errors are blocking. A reverted status means the import’s changes were reverted. A successful request does not mean the import succeeded. Check data.status and data.errors.Authorizations
Path Parameters
Response
Current import operation status.
Was this page helpful?