System Defaults โ
Force-recreate default objects in the system โ themes, blueprints, scope sets, forms, mail templates, etc. These endpoints are typically used during initial deployment, after a major upgrade that changes default content, or when recovering from a misconfiguration that broke a defaulted resource.
All of these operations write to the platform. Treat them as administrative-only, never bind them to a customer-facing flow.
Scopes โ
| Scope | Reach |
|---|---|
admin | All defaults endpoints. |
Endpoints โ
List Recreate Targets โ
GET /api/admin/defaults/
Returns the list of object categories that have a "recreate defaults" target.
Required scope: admin ยท also accepts API key
Response 200 โ DefaultsListResponse
Recreate All Defaults โ
POST /api/admin/defaults/all/recreate
Runs every per-category recreate operation in one call. Useful for first-run bootstrap or post-upgrade reseeding.
Required scope: admin
Response 200 โ DefaultsRecreateResponse
WARNING
This is an aggregate operation that touches many resource categories. Run it during a low-traffic window.
Recreate Default Assets โ
POST /api/admin/defaults/assets/recreate
Recreates the platform's default asset records.
Required scope: admin
Response 200 โ DefaultsRecreateResponse
Recreate Default Blueprints โ
POST /api/admin/defaults/blueprints/recreate
Recreates the platform's default blueprint records.
Required scope: admin
Response 200 โ DefaultsRecreateResponse
Recreate Default Forms โ
POST /api/admin/defaults/forms/recreate
Recreates the platform's default form records.
Required scope: admin
Response 200 โ DefaultsRecreateResponse
Recreate Default Menu โ
POST /api/admin/defaults/menu/recreate
Recreates the platform's default navigation menu structure.
Required scope: admin
Response 200 โ DefaultsRecreateResponse
Recreate Default Scope Sets โ
POST /api/admin/defaults/scope-sets/recreate
Recreates the platform's default Scope Set records.
Required scope: admin
Response 200 โ DefaultsRecreateResponse
Recreate Default Templates โ
POST /api/admin/defaults/templates/recreate
Recreates the platform's default mail-template records.
Required scope: admin
Response 200 โ DefaultsRecreateResponse
Recreate Default Themes โ
POST /api/admin/defaults/themes/recreate
Recreates the platform's default theme records.
Required scope: admin
Response 200 โ DefaultsRecreateResponse
See also โ
- Configuration โ tenant-wide platform settings.
- Bootstrap Activation โ the one-shot bootstrap endpoint used at very first deployment.
