reset_project_sandbox
Reset a project’s sandbox + initialization state (the ‘it’s stuck, start
over’ lever).
Kills the project’s sandboxes and clears init state; follow with
initialize_project to bring it back to READY. Destructive to the project’s
sandbox (running tasks lose their sandbox) - confirm with the user first.
Requires an admin-level user.
UUID
required
Project UUID.
UUID
Workspace UUID, if the project has one.
refresh_project_template
Rebuild the project’s sandbox template from the repo’s current HEAD.
Use when new tasks start from a stale dependency snapshot (slow installs,
missing packages). Runs in the background - poll get_template_refresh_status.
UUID
required
Project UUID.
UUID
Workspace UUID, if the project has one.
boolean
default:"False"
Bypass the project’s refresh policy gate (still rate-limited server-side).
get_template_refresh_status
Read-only
Template refresh state for every active workspace in the project: last
success/failure, failure reason, and whether refreshing is currently
disabled after repeated failures.
Project-wide by design - FEI returns one row per active workspace, so filter
by workspace_id on the returned rows rather than in the request.
UUID
required
Project UUID.
force_refresh_template
Force a template refresh, bypassing the refresh policy entirely.
Stronger than refresh_project_template’s force flag, which is still gated by
the policy cascade. Use when the policy would suppress a refresh you know is
needed. Admin-only; runs in the background - poll get_template_refresh_status.
UUID
required
Project UUID.
UUID
Workspace UUID, if the project has one.
retry_template_refresh
Clear the auto-disabled flag after repeated failures and refresh now.
When get_template_refresh_status reports refreshing disabled, this is the
lever that re-enables it - use it after the root cause is fixed (e.g. an
expired token), or it will just disable itself again. Admin-only.
UUID
required
Project UUID.
UUID
required
Workspace UUID.
get_effective_refresh_policy
Read-only
The policy actually in force after the workspace -> project -> org cascade.
Start here when asking “why isn’t this project refreshing?” - it shows the
resolved answer rather than one scope’s stored row.
UUID
required
Project UUID.
UUID
Workspace UUID, if the project has one.
get_refresh_policy
Read-only
Read the policy row stored at one specific scope.
Returns only that scope’s own row (absent = it inherits). For what a project
actually does, use get_effective_refresh_policy. Admin-only.
UUID
required
Project UUID.
string
required
Which level the policy is defined at. Resolution walks workspace -> project -> org -> global default.
UUID
Required for ‘workspace’ scope. For ‘project’ FEI resolves it from the path, and for ‘org’ from the project’s organization.
UUID
Workspace UUID, if the project has one.
set_refresh_policy
Create or update the refresh policy at one scope.
Writes that scope’s row, so everything below it inherits the new value -
confirm the scope with the user before setting ‘org’. Admin-only.
UUID
required
Project UUID.
string
required
Which level the policy is defined at. Resolution walks workspace -> project -> org -> global default.
string
required
‘off’ disables refreshes; ‘scheduled’ runs them on a cadence.
array
required
Events allowed to kick off a refresh. Empty means none do.
UUID
Required for ‘workspace’ scope. For ‘project’ FEI resolves it from the path, and for ‘org’ from the project’s organization.
int
Cadence for ‘scheduled’ mode.
string
Who owns the interval: ‘manual’ (a human set it) or ‘agent’.
UUID
Workspace UUID, if the project has one.
clear_refresh_policy
Delete one scope’s policy row so it falls back through the cascade.
Not the same as setting mode=‘off’: this removes the override, letting the
parent scope decide again. Admin-only.
UUID
required
Project UUID.
string
required
Which level the policy is defined at. Resolution walks workspace -> project -> org -> global default.
UUID
Required for ‘workspace’ scope. For ‘project’ FEI resolves it from the path, and for ‘org’ from the project’s organization.
UUID
Workspace UUID, if the project has one.