Loads (import) a file and return its preview

POST /api/v1/formulas/import/file/preview

Previews a formula ZIP import without persisting any changes to the database.

Authentication: Bearer token required (Authorization: Bearer <token>)

Permission: Permissions.FORMULAS_FORMULA_CREATE

---

Request

Request Body

Binary ZIP file containing the formula export to preview.

Content-Type: application/zip

---

Response

Success Response

Status: 200 OK

{
  "id": "63e3e5e8a01b3c001234abcd",
  "uuid": "c4a3b2d1-e5f6-7890-abcd-ef1234567890",
  "name": "Carbon Credit Calculator",
  "description": "Calculates carbon credits based on emission factors",
  "status": "DRAFT",
  "owner": "did:hedera:testnet:zHcDLGFNymFAJiMBKnpbHDgjvTn6yZnwkPPeFhtJBECH_0.0.4532001",
  "config": {}
}

Error Responses

Status	Description
400 Bad Request	Malformed or missing ZIP file
401 Unauthorized	Missing or invalid token
403 Forbidden	Insufficient permissions
500 Internal Server Error	Unexpected server failure