Return errors and status codes

[[rules]]
when.request.url_path = "/widgets/999"
respond = { text = "widget not found", status = 404 }

[[rules]]
when.request.url_path = "/widgets/rate-limited"
respond = { text = "rate limit exceeded, retry after 30s", status = 429 }

[[rules]]
when.request.url_path = "/widgets/2"
when.request.method = "DELETE"
respond.status = 204

respond.status alone is an empty body with just that status code — useful for 204, or any response where the status is the whole answer. respond = { text = "...", status = N } pairs a status with a message body. Either way, status accepts any HTTP status code.

respond.headers is honoured uniformly alongside status — including a 3xx redirect’s Location header:

[[rules]]
when.request.url_path = "/moved"
respond = { status = 301, headers = { "Location" = "https://example.com" } }

See Response headers for the full default set every response also carries.

A worked, verified example covering the common REST-error range (400, 401, 403, 404, 429, 500) plus a bare 204: crates/apimock/examples/status-codes-and-errors/.