# Delete a signature request (/docs/api-reference/signature-requests/delete-sign-request)

Deletes a request that isn't `sent` (cancel it first) with its signers, fields, audit trail, signatures and signed document, for good. Its documents stay (delete them on their own). Keep the signed document first if you need it: it is your record.

`DELETE https://api.coss.com/v1/sign/requests/{id}`

Authenticate with your API key as a bearer token (`Authorization: Bearer coss_test_…`). Responses are JSON with snake_case fields; errors are `{ error: { type, code, message, param?, issues?, request_id } }` (https://coss.com/docs/api-reference/errors.md).

## Path parameters

- `id` (string, required): The signature request's id.

## Example request

TypeScript (the `coss` package):

```ts
import { Coss } from "coss";

const coss = new Coss({
  apiKey: process.env.COSS_API_KEY,
  baseUrl: "https://api.coss.com",
});

const { data, error } = await coss.sign.requests.remove("sreq_01k7c8m4q2f3e9v6t5r1n0p8yz");
```

HTTP:

```sh
curl -X DELETE "https://api.coss.com/v1/sign/requests/sreq_01k7c8m4q2f3e9v6t5r1n0p8yz" \
  -H "Authorization: Bearer $COSS_API_KEY"
```

## Response 200

The deleted request.

- `object` ("sign_request", required)
- `id` (string, required)
- `deleted` (true, required)

Example:

```json
{
  "object": "sign_request",
  "id": "sreq_01k7c8m4q2f3e9v6t5r1n0p8yz",
  "deleted": true
}
```

## Errors

- `400`: The `Coss-Version` header names an unknown API version (`invalid_api_version`).
- `401`: The API key is missing, invalid, revoked or expired (`authentication_error`).
- `403`: The API key lacks the permission this endpoint needs (`permission_error`), or its organization is suspended (`organization_suspended`).
- `404`: No signature request with this id exists in the API key's environment (`not_found`).
- `422`: The request is `sent`: cancel it first (`request_not_deletable`).
- `429`: Too many requests with this API key (`rate_limited`), or too many requests with invalid keys from this address (`too_many_failed_authentications`). Retry after `Retry-After` seconds. Successful responses carry `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset` (seconds until the limit is fully restored).
- `500`: Unexpected server error (`api_error` / `internal_error`).
- `503`: Sign isn't available in this deployment yet (`sign_unavailable`).