Delete Horse

curl --request DELETE \
  --url https://api.example.com/api/horses/:id

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/horses/:id",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/horses/:id"

	req, _ := http.NewRequest("DELETE", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/horses/:id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Horse listing deleted"
}

DELETE

api

horses

:id

Delete Horse

curl --request DELETE \
  --url https://api.example.com/api/horses/:id

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/horses/:id",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/horses/:id"

	req, _ := http.NewRequest("DELETE", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/horses/:id")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Horse listing deleted"
}

Authentication

Required - JWT Bearer token

Authorization: Bearer YOUR_JWT_TOKEN

Authorization

Sellers can only delete their own listings
Admins can delete any listing

Path Parameters

string

required

Horse unique identifier (MongoDB ObjectId)

Behavior

Permanently deletes the horse listing
Automatically deletes all associated vet records
Cannot be undone

Response

boolean

Indicates if the request was successful

string

Confirmation message

Examples

curl -X DELETE "https://api.horsetrust.com/api/horses/507f1f77bcf86cd799439011" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

const horseId = '507f1f77bcf86cd799439011';
const response = await fetch(`https://api.horsetrust.com/api/horses/${horseId}`, {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_JWT_TOKEN'
  }
});

const data = await response.json();
console.log(data);

import requests

horse_id = '507f1f77bcf86cd799439011'
response = requests.delete(
    f'https://api.horsetrust.com/api/horses/{horse_id}',
    headers={
        'Authorization': 'Bearer YOUR_JWT_TOKEN'
    }
)

data = response.json()
print(data)

{
  "success": true,
  "message": "Horse listing deleted"
}

Error Responses

400 - Invalid Horse ID

{
  "success": false,
  "message": "Invalid horse ID"
}

401 - Unauthorized

{
  "success": false,
  "message": "Authentication required"
}

404 - Not Found or Unauthorized

Returned when:

Horse ID doesn’t exist
User is not the owner and not an admin

{
  "success": false,
  "message": "Horse not found or unauthorized"
}

500 - Server Error

{
  "success": false,
  "message": "Server error"
}

Notes

This operation is permanent and cannot be undone. All associated vet records will also be deleted.

Sellers can only delete horses they own
Admins can delete any horse listing
Associated vet records are automatically removed
Consider setting status: "paused" instead of deleting if you want to temporarily hide a listing

Update Horse

My Listings

⌘I

Authentication

Horses

Chat

Admin

Delete Horse

Authentication

Authorization

Path Parameters

Behavior

Response

Examples

Error Responses

400 - Invalid Horse ID

401 - Unauthorized

404 - Not Found or Unauthorized

500 - Server Error

Notes

​Authentication

​Authorization

​Path Parameters

​Behavior

​Response

​Examples

​Error Responses

​400 - Invalid Horse ID

​401 - Unauthorized

​404 - Not Found or Unauthorized

​500 - Server Error

​Notes

Authentication

Authorization

Path Parameters

Behavior

Response

Examples

Error Responses

400 - Invalid Horse ID

401 - Unauthorized

404 - Not Found or Unauthorized

500 - Server Error

Notes