Troubleshooting

I cannot create a process from a template

Creating a process from a template requires workspace Owner or Admin access.

Check your workspace role in Workspace settings.

I cannot import a process

Only workspace Owners and Admins can import a new process.

Also confirm that the file is a canonical Oroko process document with:

schema_version: "1.0"

Oroko validates the file before creating anything.

I cannot approve a process I submitted

This is expected.

The person who submitted a pending version cannot approve that same version. Another eligible Reviewer, Owner or Admin must make the decision.

I cannot edit an approved process

Approved processes are locked.

Create a new draft before making further changes.

I cannot delete a Role or System

A Role or System cannot be deleted while an active process step still references it.

Check the usage count, replace those references and then delete the catalogue item.

I cannot create a share link

The process must already be saved to Oroko before a share link can be created.

A share link no longer works

The link may have expired or been revoked.

Ask the workspace user who created the link to check the Share manager and create a new link if needed.

My process import is rejected

Check that the JSON:

• is valid JSON;
• uses Oroko schema version 1.0;
• contains a complete process object;
• uses supported step and variant values.

Invalid files do not modify the workspace.

I cannot change workspace members

Only workspace Owners and Admins can invite, change or remove members.