Delete Template Configuration

Delete the specified template configuration. If the template is currently being used by a message plan (in pending or running status), it cannot be deleted.

Request URL

DELETE https://smsapi.engagelab.com/v1/template-configs/:templateId

Call Authentication

Please refer to Call Authentication to learn how to authenticate API requests.

Request Example

Request Header

DELETE /v1/template-configs/123456789 HTTP/1.1 Content-Type: application/json Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0

              
              DELETE /v1/template-configs/123456789  HTTP/1.1
Content-Type: application/json
Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0

This code block in the floating window

Request Body

None

Request Parameters

Path Parameters

Parameter	Type	Option	Description
templateId	String	Required	Template ID

Response Parameters

Success Response

The HTTP status code is 200, and the response body contains the following fields:

Field	Type	Description
code	Integer	Status code, 0 indicates success
message	String	Status description

Success Example

{ "code": 0, "message": "success" }

              
              {
  "code": 0,
  "message": "success"
}

This code block in the floating window

Error Response

The HTTP status code is 4xx/5xx, and the response body contains the following fields:

Field	Type	Description
code	Integer	Error code
message	String	Error details

Error Example

{ "code": 400, "message": "there are pending or running plans using current template, can not update" }

              
              {
  "code": 400,
  "message": "there are pending or running plans using current template, can not update"
}

This code block in the floating window

Error Codes

Error Code	HTTP Code	Description
400	400	Parameter error or business logic error
500	500	Internal server error

Common error messages:

invalid templateId: Template ID format error
template config not exist: Template configuration does not exist
there are pending or running plans using current template, can not update: There are pending or running plans using this template, cannot be deleted

Notes

If there are pending or running message plans using this template, it cannot be deleted.
Both template and signature IDs are string-type numbers.