Skip to main content

Creating a new process

🔒 Required permissions

Creating a process requires ck:ListKits and ck:CreateKit. Without ck:CreateKit, the New process button appears as Forbidden.

From the process list, click New process then Create a new process to open the creation modal.

Process list with New process dropdown

Create a new Process modal

From scratch​

Once the creation modal is open:

  1. Select Create from scratch (the default option) and click Next.
  2. Enter a name and choose a category for your process.
  3. Add an optional description and click Next.
  4. Once created, you are redirected to the process detail page.

Process creation modal, name and category step New process modal: name and category.

From a template​

  1. In the creation modal, browse or search the template library using the filter bar.
  2. Click a template to preview its steps.
  3. Click Next, adjust the name and category as needed, then click Next again.
  4. Once created, you are redirected to the process detail page.

Process creation modal, template selection step Template selection step.

Template preview Preview a template before choosing it.

From an import​

Importing uses its own modal, separate from the Create a new process modal above.

  1. From the process list, click New process, then select Import process.
  2. Drop a .zip archive from a previous process export into the upload area, or click Select a file.
  3. Once the archive is read, review the process preview shown below the upload area, then click Next.
  4. Adjust the name and category if needed, then click Import.
  5. If the archive carries permissions (managers, contributors, viewers, groups), you land on a permission review step first. Each entry can be kept, remapped to a different user or group in this account, or reset. Untick Import permissions to skip all of it, in which case the process is imported without process level or step level permissions. Click Import (or Import without permissions when the checkbox is unticked) to continue.
  6. Once creation completes, the modal closes and you are redirected to the process detail page automatically.

Process creation modal, import step Import step: drop a .zip file.

Permission review step of the import modal Permission review step, with remap controls.

The archive must contain an Astran process definition file at __astran__/process-definition.asck (older exports using a single .asck file at another path are also accepted). Size limits apply: 5 MB for the definition file, 256 MB for any single entry, and 1 GB for the archive's total uncompressed content. The archive is also capped at 4,096 entries.

info

Each process is backed by an S3-compatible bucket named kit-<UUID>. This bucket is created along with the process. Deleting a process also deletes this bucket and all its contents.