Skip to main content
POST
/
v2
/
enterprise.export.create
CreateExport
curl --request POST \
  --url https://api.manus.im/v2/enterprise.export.create \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "user_id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "user@example.com"
}
'
{
  "ok": true,
  "request_id": "<string>",
  "uid": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "user_id": "123e4567-e89b-12d3-a456-426614174000",
  "enterprise_uid": "<string>"
}
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.