# Delete a webhook

Deletes the webhook so deliveries stop and it drops out of every read. The record and its delivery history are kept for audit and cannot be restored through the API. A webhook declared in a tenant manifest is removed by dropping it from that manifest.

**DELETE** `/v1/webhooks/{webhookId}`

## Authorization

`Authorization` Bearer token · header required

```plaintext
Authorization: Bearer <token>
```

with an API key (`sfa_` prefix), an OAuth access token, a session token, or a Space machine credential (`sfm_` prefix).

or

`Authorization` OAuth2 access token · header required

OAuth 2.0 with Spacefast scopes. People use the authorization code flow; machines use client credentials.

## Scopes:

`spaces:write`

## Path parameters

`webhookId` string required

- min length 1

## Responses

**204** The webhook was deleted.

### Try it

**Server**  
Base URL: `https://api.spacefast.com`  
Custom base URL Overrides the selected server when set.

### Parameters

`webhookId` path *

#### Request

**cURL**

```bash
curl -X DELETE "https://api.spacefast.com/v1/webhooks/string" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

**JavaScript**

```javascript
const response = await fetch("https://api.spacefast.com/v1/webhooks/string", {
  method: "DELETE",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});
```

**Python**

```python
import requests

response = requests.delete(
    "https://api.spacefast.com/v1/webhooks/string",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)
```

### Response

**204**  
The webhook was deleted.