---
title: "Delete a relationship type"
description: "DELETE /relationship_types/{relationship_type_id} — Deletes a relationship type and every relationship using it — including ones that were soft-deleted and could otherwise have been restored. This cascade is permanent, so check usage before calling it."
canonical_url: https://developer.onepagecrm.com/api/reference/relationship-types/delete-relationship_types-relationship_type_id/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/relationship-types/delete-relationship_types-relationship_type_id/
---

`DELETE /relationship_types/{relationship_type_id}`

Deletes a relationship type and every relationship using it — including ones that were soft-deleted and could otherwise have been restored. This cascade is permanent, so check usage before calling it.

Resource: [Relationship Types](https://developer.onepagecrm.com/api/reference/relationship-types/) · [API Reference](https://developer.onepagecrm.com/api/reference/)

## Request

```bash
curl -X DELETE "https://app.onepagecrm.com/api/v3/relationship_types/{relationship_type_id}" \
  -u $user_id:$api_key
```

Authentication is HTTP Basic — `user_id` as username, `api_key` as password.
See https://developer.onepagecrm.com/api/authentication/.

## Path parameters

| Name | Type | Description |
| --- | --- | --- |
| `relationship_type_id` | string | Relationship type ID |

## Responses

### 200

OK

Standard error responses: 400, 401, 403, 404, 409, 500 — shared across the API. See https://developer.onepagecrm.com/api/errors/.

## Related guides

- [Authentication](https://developer.onepagecrm.com/api/authentication/)
- [Errors](https://developer.onepagecrm.com/api/errors/)
- [Rate limits](https://developer.onepagecrm.com/api/rate-limits/)
- [Undo deletion](https://developer.onepagecrm.com/api/undo-deletion/)