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": {}
}
}Project import API
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": {}
}
}Authorizations
Project-bound Platform Key supplied in the x-api-key header. The key must include the operation's required scope: project_io.read for export operations or project_io.write for import operations. A pipeline that promotes changes normally requires both scopes.
Path Parameters
Project identifier. The project must belong to the authenticated tenant.
Minimum string length:
1Identifier returned when the import operation is created.
Minimum string length:
1Response
Current import operation status.
Indicates that the status request was read successfully. The operation itself may still be running or may have failed; inspect data.status and data.errors.
Import operation record and its current validation, dependency, progress, result, warning, and error state.
Show child attributes
Show child attributes
Was this page helpful?