# Delete terms

`DELETE /v2/terms/{id}`

Endpoints: `https://{tenant}.fuse.server.test.neobits.ai/v2/terms/{id}`, `https://{tenant}.fuse.server.prod.neobits.ai/v2/terms/{id}`
OpenAPI document: https://docs.neobits.ai/openapi/fuse.json

Authentication: `bearer` (Bearer token authentication using OAuth 2.0 client credentials flow.)

Deletes terms. Deleting scheduled terms leaves the active terms open-ended, and deleting the active terms falls back to the default terms. Deleting terms that don't exist also returns 204. Requires `terms:delete`.

## Parameters

| Name | In | Required | Schema | Description |
| --- | --- | --- | --- | --- |
| `id` | path | yes | string (uuid); example `0195fc07-17e7-71e7-b127-70c0a81db35a` | The unique identifier of the terms |

Full schemas:

- `id` (path): `{"type":"string","format":"uuid"}`

## Example request

```bash
curl --request DELETE \
  --url https://your-tenant.fuse.server.test.neobits.ai/v2/terms/0195fc07-17e7-71e7-b127-70c0a81db35a \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'
```

## Responses

### 204 No Content

| Header | Description |
| --- | --- |
| `X-Request-ID` | UUID generated on each request. Provide this id to customer support if an error occurs. |

## Error responses

Error bodies follow the format in the [error reference](https://docs.neobits.ai/api-reference/errors.md), which lists every error code.

| Status | Meaning | Example body |
| --- | --- | --- |
| 400 | Bad Request | `{"timestamp":"2019-09-16T22:14:45.624Z","moreInfo":"https://docs.neobits.ai/","errors":[{"name":"BadRequest","code":"400-001","message":"Field 'ssn' is required"}]}` |
| 401 | Unauthorized | `{"timestamp":"2019-09-16T22:14:45.624Z","moreInfo":"https://docs.neobits.ai/","errors":[{"name":"Unauthorized","code":"401-000","message":"Client is not authenticated"}]}` |
| 403 | Forbidden | `{"timestamp":"2019-09-16T22:14:45.624Z","moreInfo":"https://docs.neobits.ai/","errors":[{"name":"Forbidden","code":"403-000","message":"Client does not have access to this resource"}]}` |
| 429 | Too Many Requests. When the rate limit rejects a request, the response carries `Retry-After` and only the `errors` field: no `timestamp`, `moreInfo` or `X-Request-ID`, as the request never reached the API. | `{"errors":[{"name":"TooManyRequests","code":"429-000","message":"Too many requests. Please try again later."}]}` |
| 500 | Internal Server Error | `{"timestamp":"2019-09-16T22:14:45.624Z","moreInfo":"https://docs.neobits.ai/","errors":[{"name":"InternalServerError","code":"500-000","message":"An unexpected internal error occurred"}]}` |
| 503 | Service Unavailable | `{"timestamp":"2019-09-16T22:14:45.624Z","moreInfo":"https://docs.neobits.ai/","errors":[{"name":"ServiceUnavailable","code":"503-000","message":"An error occurred while interacting with a third party service"}]}` |
| 504 | Gateway Timeout | `{"timestamp":"2019-09-16T22:14:45.624Z","moreInfo":"https://docs.neobits.ai/","errors":[{"name":"GatewayTimeout","code":"504-000","message":"The request timed out"}]}` |