Delete Template

This endpoint deletes a specific template for a specific user. It is used to permanently remove a template identified by its unique templateId. Deleting a template is irreversible.

HTTP Method and URL

DELETE {{host}}/api/v2/templates/:templateId?user_type=ENTERPRISE_API

Authentication Requirements

Requires authentication via a valid user token. The token should be provided in the request headers as:

Authorization: Bearer {USER-TOKEN}

Path and Query Parameters

• Path Parameter:

  • templateId (string, required): The unique identifier of the template to be deleted.

• Query Parameter:

  • user_type (string, required): Must be set to ENTERPRISE_API.

Request Body

No request body is required for this endpoint.

Example Request

DELETE {{host}}/api/v2/templates/12345?user_type=ENTERPRISE_API
Headers:
  Authorization: Bearer {USER-TOKEN}

Example Successful Response

{
  "success": true,
  "message": "Template deleted successfully."
}

Error Responses

• 400 Bad Request: Missing or invalid templateId or user_type.

• 401 Unauthorized: Authentication token is missing or invalid.

• 404 Not Found: The specified templateId does not exist.

• 500 Internal Server Error: An unexpected error occurred on the server.

Usage Notes

• Ensure the templateId provided exists and is accessible to the authenticated user.

• Deleting a template is irreversible; ensure this action is intended.

• The user_type query parameter must always be set to ENTERPRISE_API for this endpoint.