Skip to main content

template_not_found

No template with that template_id exists in the workspace the key belongs to. Nothing was sent and nothing was charged.

Status: 404

{
  "status": 404,
  "type": "template_not_found",
  "message": "Template not found",
  "request_id": "req_01J8K2P...",
  "doc_url": "https://docs.epostix.com/errors/template_not_found"
}

Why you got this​

  • The template belongs to another workspace. That returns 404 as well, so the response never confirms whether the id exists somewhere else.
  • The key was issued by a different workspace than the one you built the template in.
  • The template was deleted after its id was hard-coded or stored in configuration.
  • The id is truncated, or carries whitespace picked up in a copy and paste.

How to fix it​

List the templates in the workspace the key belongs to and compare the id character for character. If the id is right, the workspace is the problem: check which one issued the key you are sending with.

An unknown path returns not_found instead, so this type tells you the route was correct and template_id was the field at fault.

Is it safe to retry​

No. The same id returns the same 404 until the template exists in this workspace. Correct the id or create the template, then send a new request.

Reusing the Idempotency-Key afterwards is safe, because a rejected request was never stored.