---
title: "Delete a contractor service listing"
method: DELETE
path: "/services/{id}"
tags: ["Services"]
---

# Delete a contractor service listing

`DELETE /services/{id}`

## Request

- Base URL: `https://api.purplegrain.com/api/v1`
- URL: `https://api.purplegrain.com/api/v1/services/{id}`
- Auth: HTTP bearer

Permanently remove the service listing identified by `id` from the
contractor catalogue. Requires edit rights on the listing's owner
(a person or business) and the connection's permitted write access.
Confirm the listing and owner before deletion.

The listing's image is removed and existing tasks lose their service
link; the tasks themselves are kept. This does not delete the
contractor's account or business. Returns no content on success.
Use `updateService` to edit the listing instead of deleting it.

## Path parameters

- `id` string, required

## Response `204`

Delete

## Other responses

- `401`: Unauthenticated
- `403`: Forbidden

---

[API](https://skmtc.dev/purplegrain/apis/purple-grain-api.md) · [All operations](https://skmtc.dev/purplegrain/apis/purple-grain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/purplegrain/apis/purple-grain-api/revisions/a9136f78e9fb?raw)