Preview project template lifecycle settings
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.
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.
Authorization
apiKey API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.
In: header
Path Parameters
Organization name
Project 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/projects/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"}Preview organization template lifecycle settings PUT
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.
Update organization template lifecycle settings PUT
Replace the archive and delete rules an organization supplies to its projects. A null field is not set at this scope and inherits. The body replaces the whole scope: a field you omit is cleared, not kept. Requires the organization admin or owner role.