Skip to main content

Managing Scripts in Script Engine

Create, schedule and monitor the JavaScript scripts in your workspace from Workspace Administration

Written by Peter Novosel

Script Engine is the page in Workspace Administration where workspace administrators create, schedule and monitor the JavaScript scripts that run in their workspace. From one place you can see every script, write and edit code in a built-in editor, set memory and timeout limits, choose which workspace secrets each script can use, and review every run.

Plan Availability

Enterprise plan or higher

Permissions

Workspace Administrators: create, edit, duplicate, schedule, export and monitor scripts in Workspace Administration > Script Engine.

Platform

Web

Related Reading


What is Script Engine?

Scripts that sync data, call external services or keep records current need a home where administrators can see what exists, when it runs and whether it worked. Script Engine is that home. Use it to:

  • See every script in the workspace at a glance, with its status, schedule and recent activity.

  • Create, edit and duplicate scripts in a built-in code editor.

  • Set Memory and Timeout limits for each script.

  • Choose which workspace secrets a script can use, so credentials never appear in code.

  • Run scripts on a schedule.

  • Review each script's run history.

  • Export the script list, or a single script's definition.

Secrets are managed on their own page. In the left sidebar, open Workspace Administration and select Secrets, directly below Script Engine. For details, see Secrets Management.


Create a script

  1. In the left sidebar, open Workspace Administration and select Script Engine.

  2. Create a new script.

  3. Enter a name and a Script ID (see the rules below).

  4. Write or paste your JavaScript into the code editor.

  5. Set the Memory and Timeout limits.

  6. Open Choose secrets, check the secrets this script needs and click Done. Your selections appear as tags in the field.

  7. If the script should run automatically, give it a schedule (see Schedules below).

  8. Save the script.

Note: You can only choose secrets that already exist. To add a new one, create it on the Secrets page first. To read a secret's value in your code, see Using secrets in scripts.

Script ID rules

Every script needs a Script ID that is:

  • 3 to 63 characters long.

  • Made up of lowercase letters, numbers and hyphens only.

  • Unique within your workspace.

For example, nightly-evidence-sync is valid, while Nightly_Sync is not.

Validation and status

After you save a script, it is validated. Each script shows a status badge:

  • Active scripts are ready to run.

  • Inactive scripts are not running.

  • If validation fails, the badge shows the failure. Hover over the badge to see the reason, when one is available.


Schedules

A script can run on a preset schedule or a custom expression. In the script list, the Schedule column shows:

  • Hourly, Daily or Weekly for preset schedules.

  • The expression itself for custom schedules, such as rate(6 hours) or cron(0 12 * * ? *).

  • A dash (—) when the script has no schedule.


The script directory

Workspace health at a glance

The top of the Script Engine page shows three counts:

  • Active scripts

  • Scheduled scripts

  • Failed runs in the last 24 hours

Click any count to filter the list to the matching scripts.

Customize columns

  1. Open the column options.

  2. Check or uncheck columns to show or hide them. The list updates as you go.

  3. Click Apply to close the panel, or Reset to defaults to return to the original columns.

Note: Column choices are saved in your browser. If you open Script Engine in a different browser, you will see the default columns.

Load more scripts

The list loads in pages. Click Load more at the bottom to see additional scripts.

Export the script list

Export the script list as a CSV file, an Excel (.xlsx) file or a Google Sheet.


Manage a script

Edit a script

Open a script to update its code, settings, schedule, Memory and Timeout limits, or selected secrets. The script is validated again when you save.

Duplicate a script

Duplicate a script to use it as the starting point for a new one. Before you can save the copy, give it a new, unique Script ID.

Export a single script

Export a script's full definition as a JSON file. The export includes references to the secrets the script uses, but never the secret values themselves.

Review run history

Every time a script runs, Script Engine records the run. Open a script's run history to review past runs, including each run's execution mode and the script version that ran. Filter and sort the history to find specific runs, and select a run to see its details.


Practical Scenarios and Use Cases

Nightly evidence collection

Scenario: Your compliance team needs control evidence pulled from an external system every night, and auditors want proof that each collection ran.

Solution: Create a script that calls the external service, using a secret for its API key, and give it a Daily schedule. Each morning, the script's run history shows whether the collection succeeded.

Finding failing scripts fast

Scenario: A service desk integration stopped updating tickets, and you are not sure which script is responsible.

Solution: Click the failed-runs count at the top of Script Engine to filter to scripts with recent failures, then open the script's run history to investigate.

Changing a script safely

Scenario: You want to try a change without affecting a script that is already in use.

Solution: Duplicate the script, give the copy a new Script ID and make your changes there. Once the copy works as expected, update the original.

Rotating a credential

Scenario: An API key used by several scripts is being replaced.

Solution: Update the value on the Secrets page. Every script that uses that secret picks up the new value automatically, with no script edits needed.


Frequently Asked Questions

Who can use Script Engine?

Workspace Administrators on the Enterprise plan or higher.

Where did the Workspace Secrets tab go?

Secrets moved to their own page in Workspace Administration, directly below Script Engine. Scripts now choose secrets by reference with Choose secrets. See Secrets Management.

Does exporting a script expose my secrets?

No. A JSON export includes references to the secrets a script uses, never their values.

Why do I see the default columns on another computer?

Column choices are saved in your browser, so a different browser or device starts with the default columns.

Last verified: 22 Oct 2026, against the original draft of this article, the Script Engine requirements and the Secrets Management article. No product change was verified in the app in this pass.

Did this answer your question?