Skip to content

Export collection as ZIP

GET
/api/v1/collections.export
curl --request GET \
--url 'https://your-orimora-instance.example.com/api/v1/collections.export?id=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0&format=zip' \
--header 'Authorization: Bearer <token>'

Downloads all documents in a collection as a ZIP archive.

Authorization: Three-layer check:

  1. API key must carry the read scope.
  2. If the key uses restricted mode, the collection must be in the key’s allowlist.
  3. The caller must have read access to the collection (same as document listing).

format=zip (default) returns Markdown files. format=html returns HTML files.

id
required

Collection ID to export

string format: uuid

Collection ID to export

format
string
default: zip
Allowed values: zip html

ZIP archive download

Media type application/zip
string format: binary

Unauthorized

Media type application/json
object
error
required

Human-readable error message

string
Example generated
{
"error": "example"
}

Forbidden (missing read scope or insufficient permissions)

Media type application/json
object
error
required

Human-readable error message

string
Example generated
{
"error": "example"
}

Collection not found

Media type application/json
object
error
required

Human-readable error message

string
Example generated
{
"error": "example"
}