Update organization template lifecycle settings
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.
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.
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" \ -H "Content-Type: application/json" \ -d '{ "archive_after_days_unused": 1, "archive_enabled": true, "delete_after_days_archived": 1, "delete_enabled": true }'{ "effective": { "archive_after_days_unused": 0, "archive_enabled": true, "delete_after_days_archived": 0, "delete_enabled": true }, "settings": { "archive_after_days_unused": 1, "archive_enabled": true, "delete_after_days_archived": 1, "delete_enabled": true }, "source": { "archive_after_days_unused": "project", "archive_enabled": "project", "delete_after_days_archived": "project", "delete_enabled": "project" }}{ "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 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.
Update project template lifecycle settings PUT
Replace the archive and delete rules for a project's templates. 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 project admin role.