# Delete a policy rule

Removes one rule. Whatever it decided falls through to the next rule that matches, or to the spec’s own default.

## DELETE `/v1/connectors/policies/{policyRuleId}`

### Authorization

- `Authorization` Bearer token · header required

`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:
- `connectors:write`

### Path parameters

- `policyRuleId` string required
  - min length 1

### Query parameters

- `team` string
  - min length 1 · max length 255

### Responses

#### 200 Response for status 200

- `data` any required

Removing a policy rule returns no resource body.

#### default

Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

- `$schema` string `<uri>`
  - Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
- `type` string required
  - URL of the documentation page for this error. Derived from `code`.
- `title` string required
  - Human-readable name of the error type. Derived from `code`.
- `status` integer required
  - HTTP status of the response, repeated in the body.
  - min -9007199254740991 · max 9007199254740991
- `detail` string required
  - What went wrong in this request.
- `code` string required
  - Stable snake_case error code. Match on this, not on `detail`.
- `pointer` string
  - RFC 6901 JSON Pointer to the request field or batch entry that failed, for example `/files/37/path`. Present on validation failures.
- `details` object
  - Machine-readable context keyed by the error code.
- `suggestions` string[]
  - Recovery steps safe to show to a person.
- `next` string[]
  - Commands or API requests to run next, usable as written.
- `requestId` string required
  - ID of this request, from the `X-Request-Id` header or generated. Quote it when contacting support.

## Try it

### Server

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

### Authorization

Bearer token - Remember on this device - Include my values in samples

### Parameters

- `policyRuleId` path*  
- `team` query

### Send

### Request

#### cURL

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

#### JavaScript

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

#### Python

```python
import requests

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

### Response

#### 200 default

```json
{
  "$schema": "http://example.com",
  "data": null
}
```

```json
{
  "$schema": "http://example.com",
  "type": "string",
  "title": "string",
  "status": -9007199254740991,
  "detail": "string",
  "code": "string",
  "pointer": "string",
  "details": {
    "property1": null,
    "property2": null
  },
  "suggestions": [  
    "string"  
  ],
  "next": [  
    "string"  
  ],
  "requestId": "string"
}
```