Retrieve full details for a single template
GET/templates/:id
Returns the complete record for the template identified by {id} within the requesting tenant.
When to use: Call this after creating a template (via either upload flow) to check its status, retrieve download URLs for its artifacts, or inspect its metadata. To browse or filter all templates use GET /templates; for the ordered column definitions of a scratch-built template use GET /templates/{id}/columns.
How: Supply {id} (the template ID returned by the create endpoints) and the required tenant-id header.
Returns: The template record whose data object carries the template's name, description, status (in-progress, success, or failure), type, and the GCS object paths of its artifacts. For each artifact that exists in GCS, a V4-signed download URL valid for 7 days is generated at request time (never stored) and injected into data: templateUrl (template CSV), mappingsUrl (column-mappings CSV), and schemaUrl (generated validation schema). Read-only; no state is changed.
Request
Responses
- 200
- 401
- 403
- 404
- 500
The template record, with request-time signed download URLs injected into data for every artifact that exists in GCS.
Authentication required - supply a valid bearer token.
The authenticated user lacks the READ_TEMPLATE permission.
No template with the given {id} exists for the tenant. Verify the ID against GET /templates.
Unexpected server-side failure (for example a GCS or data-layer outage). Safe to retry; the operation is read-only.