Import and export

Oroko can export a process to a canonical JSON document and import a compatible document into a workspace.

The current canonical contract uses:

schema_version: "1.0"

Export a process

Open the process you want to export and use the export action.

Oroko downloads a JSON file containing the canonical process document. Exported files use the .oroko.json naming convention.

The document can include:

• process identity and status;
• process variants;
• steps;
• connections;
• supported step metadata.

Import a process

Use the workspace import action and choose a JSON file.

Oroko checks that the document is a canonical Oroko 1.0 process document before creating anything.

The import flow previews the file and validates it first. An invalid file does not change the workspace.

Only workspace Owners and Admins can import a new process.

Supported canonical step types

Imported documents support these canonical step types:

• start
• activity
• decision
• subprocess
• end

Supported process status values

The current canonical format recognises:

• draft
• under_review
• approved
• changes_requested
• archived

Variants

The canonical format supports Current State, Future State and custom process variants.

Each variant carries its own steps and connections.