Preview organization template lifecycle settings
Report what the archive and delete rules would take across an organization's templates under the values in the body. The body is the proposed values, not the saved ones, so the effect of a change is visible before anybody saves it. Nothing is written. Archiving frees no storage — an archived version keeps its bytes — so the archive rule reports zero, and the delete rule's figure is the one that moves storage. That figure is what the storage collector eventually reclaims, not what the rule frees: the collector ticks hourly and only takes an image nothing has used for 48 hours. An image two versions share is counted once, and only when the rule takes both. Requires organization membership.
Report what the archive and delete rules would take across an organization's templates under the values in the body. The body is the proposed values, not the saved ones, so the effect of a change is visible before anybody saves it. Nothing is written. Archiving frees no storage — an archived version keeps its bytes — so the archive rule reports zero, and the delete rule's figure is the one that moves storage. That figure is what the storage collector eventually reclaims, not what the rule frees: the collector ticks hourly and only takes an image nothing has used for 48 hours. An image two versions share is counted once, and only when the rule takes both. Requires organization membership.
Authorization
apiKey API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.
In: header
Path Parameters
Organization name
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Days a version goes unused before the archive rule takes it. Null = inherit.
int321 <= value <= 60Archive unused versions. Null = inherit.
Days a version stays archived before the delete rule takes it. Null = inherit.
int321 <= value <= 30Permanently delete archived versions. Null = inherit.
Response Body
application/json
application/problem+json
curl -X PUT "https://example.com/v1/orgs/string/settings/template-lifecycle/preview" \ -H "Content-Type: application/json" \ -d '{ "archive_after_days_unused": 1, "archive_enabled": true, "delete_after_days_archived": 1, "delete_enabled": true }'{ "archive": { "eventually_reclaimed_bytes": 0, "eventually_reclaimed_bytes_delta": 0, "versions": 0, "versions_delta": 0 }, "counts_truncated": true, "delete": { "eventually_reclaimed_bytes": 0, "eventually_reclaimed_bytes_delta": 0, "versions": 0, "versions_delta": 0 }, "effective": { "archive_after_days_unused": 0, "archive_enabled": true, "delete_after_days_archived": 0, "delete_enabled": true }, "source": { "archive_after_days_unused": "project", "archive_enabled": "project", "delete_after_days_archived": "project", "delete_enabled": "project" }, "versions": [ { "archived_days": 0, "idle_days": 0, "rule": "archive", "state": "active", "tagged": true, "template_name": "string", "verdict": "take", "version_id": "string" } ], "versions_truncated": true}{ "detail": "Property foo is required but is missing.", "errors": [ { "location": "string", "message": "string", "value": null } ], "instance": "https://example.com/error-log/abc123", "status": 400, "title": "Bad Request", "type": "https://example.com/errors/example"}Get project template lifecycle settings GET
Get the archive and delete rules that apply to a project's templates, and the scope each value came from. Requires read access to the project.
Preview project template lifecycle settings PUT
Report what the archive and delete rules would take in a project under the values in the body. The body is the proposed values, not the saved ones, so the effect of a change is visible before anybody saves it. Nothing is written. Archiving frees no storage — an archived version keeps its bytes — so the archive rule reports zero, and the delete rule's figure is the one that moves storage. That figure is what the storage collector eventually reclaims, not what the rule frees: the collector ticks hourly and only takes an image nothing has used for 48 hours. An image two versions share is counted once, and only when the rule takes both. Requires read access to the project.