Skip to main content

Update Tag

The Update Tag endpoint changes a tag's label. It is a PUT, but in practice label is the only field you should send. orgId is not an accepted body field and returns a validation error if sent. id is different: it isn't rejected by validation, and it isn't ignored either; the endpoint applies whatever body you send, so an id that differs from the TagId in the URL will overwrite the tag's actual id instead of being discarded. Omit id from the body and let the URL path segment identify the tag to update.

When to use it​

Use this endpoint to rename a tag across your organization; every template or variable already tagged with it keeps the same tag id, so the rename applies everywhere the tag is used.

Example request​

curl -X PUT "https://api.turbodocx.com/Tag/7c1a0b52-9e88-4f0d-b3a2-1d4c6f8e2a90" \
  -H "Authorization: Bearer $TURBODOCX_API_KEY" \
  -H "x-rapiddocx-org-id: $TURBODOCX_ORG_ID" \
  -H "Content-Type: application/json" \
  -d '{"label": "legal-2026"}'

Example response​

On success the endpoint returns 200 OK with the updated tag object directly (not wrapped in a data envelope, unlike most other TurboDocx endpoints):

{
  "id": "7c1a0b52-9e88-4f0d-b3a2-1d4c6f8e2a90",
  "label": "legal-2026",
  "isActive": true,
  "orgId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "createdBy": "f5e6d7c8-9a0b-4c1d-2e3f-4a5b6c7d8e9f",
  "createdOn": "2026-05-01T14:22:10.000Z",
  "updatedOn": "2026-05-02T09:00:00.000Z"
}

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)
400TagId is not a valid UUID, or label fails validation{ "message", "type": "ValidationError", "data": { "errors": [...] } }
Last updated on