latestOpenAPI 3.1.02026-08-194237902.5 MB

563848e0ecc0

Template

Permanently delete a template record

Deletes the template identified by {id} and all of its column-mapping records from the data layer. This is a hard delete and cannot be undone.

When to use: Call this to retire a template that is no longer needed. Ensure no roster uploads still reference the template before deleting.

How: Supply {id} and the required tenant-id header. The template's existence is verified first; an unknown ID returns 404 without deleting anything.

Returns: 204 No Content on success; the response has no body. Only the data-layer records are removed - the template's GCS artifacts (template.csv, mappings.csv, schema.json) are left in place and remain reachable through any still-valid signed URLs until those expire. The operation is not idempotent: repeating it returns 404.

delete/templates/{id}

Path parameters

idstring required

Server-generated ID of the template to delete, as returned by the create endpoints.

Headers

tenant-idstring required

Tenant that owns the template; scopes the lookup and delete.

Response

The template and its column records were deleted. No response body.