Skip to main content
PATCH
Updates a template you own and can mutate in the authenticated scope.

Path Parameters

string
required
Template UUID.

Body Parameters

string
Optional new name (1-100 chars after trimming). Must remain owner-unique.
string | null
Optional description update. Pass null to clear.
string
Optional: private or workspace.
object
Optional full config replacement. Must satisfy config v1 schema.
Body cannot be empty. Send at least one updatable field.
visibility: "workspace" requires workspace scope.

Error Responses

  • 400 missing_template_id - path param missing
  • 400 invalid_json - body is not valid JSON
  • 422 invalid_payload - schema validation failed or body is empty
  • 404 not_found - template not found in readable scope
  • 403 forbidden_template - template exists but mutation is not allowed in current scope
  • 409 template_name_conflict - name already exists for owner
  • 422 invalid_template_config - provided config is invalid
  • 401 - authentication failed (missing/invalid/revoked token)
  • 402 subscription_required - active Creator/Professional/Business plan required
  • 403 tier_not_allowed - Scheduler tier cannot use Partner API
  • 500 template_update_failed - unexpected update failure