Skip to main content
The DELETE /plants/{id} endpoint permanently removes the plant with the given ID from the store. A successful deletion returns a 204 No Content response with an empty body — there is no JSON payload on success. If the ID does not exist or the request is otherwise invalid, the API returns a 400 error. This action is irreversible, so confirm the correct ID before sending the request.
Deleting a plant cannot be undone. Make sure you are passing the correct id before calling this endpoint.

​
Path parameters

​
id
integer
required
The unique integer ID of the plant to delete. This is the same id you provided when creating the plant.

​
Response

​
204 — success

The plant was deleted. The response body is empty.

​
400 — error

​
error
integer
required
Numeric error code identifying the type of failure.
​
message
string
required
Human-readable description of the error.

​
Example

curl -X DELETE "http://sandbox.mintlify.com/plants/1" \
  -H "Authorization: Bearer <your-token>"

(empty response body)