Skip to main content
POST
CreateExport
Questions or issues? Contact us at api-support@manus.ai.
Required combos: Provide either user_id or email. When scope is ENTERPRISE_EXPORT_SCOPE_CUSTOM_SESSION_IDS, session_ids is required. When scope is ENTERPRISE_EXPORT_SCOPE_WEBDEV_PROJECT, optionally narrow with webdev_project_uids. When scope is ENTERPRISE_EXPORT_SCOPE_PROJECT, optionally narrow with project_uids.Async: Returns immediately with EXPORT_STATUS_PENDING. Poll enterprise.export.detail until status is EXPORT_STATUS_COMPLETED, then call enterprise.export.downloadUrl.Concurrency: Recommended to keep at most one in-flight export per user.Audit: reason is logged for compliance review — supply a meaningful value.Protocols: Also callable via Connect RPC. See Protocols.

Authorizations

X-API-Key
string
header
required

Body

application/json
user_id
string<uuid>
required

Target user ID. Either user_id or email must be provided.

Example:

"123e4567-e89b-12d3-a456-426614174000"

scope
enum<string>
required

Export scope. Determines what data is included in the archive.

Available options:
ENTERPRISE_EXPORT_SCOPE_FULL,
ENTERPRISE_EXPORT_SCOPE_TASKS,
ENTERPRISE_EXPORT_SCOPE_TASKS_WITH_ATTACHMENTS,
ENTERPRISE_EXPORT_SCOPE_CUSTOM_SESSION_IDS,
ENTERPRISE_EXPORT_SCOPE_WEBDEV_PROJECT,
ENTERPRISE_EXPORT_SCOPE_PROJECT
email
string

Target user email. Either user_id or email must be provided.

Example:

"user@example.com"

include_deleted
boolean
default:false

Include soft-deleted data in the export.

start_time
string<date-time>

Lower time bound (RFC3339). Only data created on or after this time is included.

end_time
string<date-time>

Upper time bound (RFC3339). Only data created on or before this time is included.

session_ids
string[]

Specific session IDs to export. Required when scope is ENTERPRISE_EXPORT_SCOPE_CUSTOM_SESSION_IDS.

include_files
boolean
default:true

Include attached files in the archive.

reason
string

Reason for the export. Logged for compliance auditing — supply a meaningful value.

Example:

"compliance audit"

webdev_project_uids
string[]

Limit the export to specific webdev project UIDs. Only used when scope is ENTERPRISE_EXPORT_SCOPE_WEBDEV_PROJECT. Leave empty to include all webdev projects.

project_uids
string[]

Limit the export to specific project UIDs. Only used when scope is ENTERPRISE_EXPORT_SCOPE_PROJECT. Leave empty to include all projects.

Response

Export task created successfully.

ok
boolean

Whether the request was successful.

Example:

true

request_id
string

Unique identifier for this API request, useful for debugging.

uid
string

Unique identifier of the export task. Use this with enterprise.export.detail and enterprise.export.downloadUrl.

status
enum<string>

Initial status. Always EXPORT_STATUS_PENDING for a freshly created task.

Available options:
EXPORT_STATUS_PENDING,
EXPORT_STATUS_PROCESSING,
EXPORT_STATUS_COMPLETED,
EXPORT_STATUS_FAILED,
EXPORT_STATUS_CANCELLED
created_at
string<date-time>

Task creation time (RFC3339).

user_id
string<uuid>

Target user ID resolved from the request.

Example:

"123e4567-e89b-12d3-a456-426614174000"

enterprise_uid
string

Enterprise unique identifier.