Get project export status
curl --request GET \
--url https://{host}/v1/projects/{projectId}/export/{exportId} \
--header 'x-api-key: <api-key>'{
"success": true,
"data": {
"id": "exp_01JEXPORT123",
"type": "export",
"status": "completed",
"phase": "packaging",
"progressPercent": 100,
"dependencyValidation": {
"valid": true,
"missing": [],
"circular": []
},
"manifest": {
"name": "customer-support",
"version": "1.0.0",
"entryAgent": "support-agent",
"layers": [
"core",
"connections",
"workflows"
],
"requiredEnvVars": [
"CRM_BASE_URL"
]
},
"lockfile": {
"version": 2,
"layers": {
"core": "sha256:abc123...",
"connections": "sha256:def456..."
}
},
"downloadUrl": "https://api.example.com/v1/archives/exp_01JEXPORT123/download",
"expiresAt": "2026-09-01T10:00:14Z",
"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 export status
Get the status of a project export and, after completion, its manifest, lockfile, and download URL.
GET
/
v1
/
projects
/
{projectId}
/
export
/
{exportId}
Get project export status
curl --request GET \
--url https://{host}/v1/projects/{projectId}/export/{exportId} \
--header 'x-api-key: <api-key>'{
"success": true,
"data": {
"id": "exp_01JEXPORT123",
"type": "export",
"status": "completed",
"phase": "packaging",
"progressPercent": 100,
"dependencyValidation": {
"valid": true,
"missing": [],
"circular": []
},
"manifest": {
"name": "customer-support",
"version": "1.0.0",
"entryAgent": "support-agent",
"layers": [
"core",
"connections",
"workflows"
],
"requiredEnvVars": [
"CRM_BASE_URL"
]
},
"lockfile": {
"version": 2,
"layers": {
"core": "sha256:abc123...",
"connections": "sha256:def456..."
}
},
"downloadUrl": "https://api.example.com/v1/archives/exp_01JEXPORT123/download",
"expiresAt": "2026-09-01T10:00:14Z",
"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 export returns. The status values include queued, processing, packaging, completed, and failed. The progressPercent field estimates progress from 0 to 100. The request needs the project_io.read scope.
When the export is completed, the response includes the manifest, the lockfile, and a short-lived downloadUrl. Download the archive before expiresAt. The lockfile holds content hashes that you can use to verify the archive. A successful request does not mean the export succeeded. Check data.status and data.errors.Authorizations
Path Parameters
Response
Current export operation status and result metadata.
Was this page helpful?