Skip to main content

Edit Template Metadata

The Edit Template Metadata endpoint updates a template's name, description, folder, or tags without touching its file or variables. Send only the fields you want to change; fields you omit are left as-is.

When to use it​

Use this endpoint to rename a template, move it into a different folder (templateFolderId), or replace its tags after you have already uploaded it. To change the file itself, delete the template and upload a new one with Upload Template with Optional Default Values.

Example request​

curl -X PATCH "https://api.turbodocx.com/template/2b8f1c9e-4d3a-4a7c-9f21-6b0d5e9a1c34" \
  -H "Authorization: Bearer $TURBODOCX_API_KEY" \
  -H "x-rapiddocx-org-id: $TURBODOCX_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "SOW Template (v2)",
    "description": "Standard statement of work, updated for 2026 pricing",
    "tags": [{"id": "7c1a0b52-9e88-4f0d-b3a2-1d4c6f8e2a90"}]
  }'

Sending tags replaces the template's entire tag list: existing tags not included in the array are removed. Each entry only needs the tag's id, from Create Tag or Read Tag.

Example response​

On success the endpoint returns 200 OK with no response body.

Common errors​

StatusWhenResponse body
401Missing or invalid API key/token, or the organization cannot be resolvedEmpty (status only)
403The key's role is not administrator, contributor, or userEmpty (status only)
423The template is locked{ "error": "Resource is locked", "message", "data": { "locked": true, "lockedBy", "lockedOn" } }
400A field fails validation (for example name under 3 characters){ "message", "type": "ValidationError", "data": { "errors": [...] } }
Last updated on