> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wiseyield.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete recurring task

> Soft-delete a recurring task schedule. Already-generated tasks are unaffected.

```
DELETE https://www.wiseyield.co/api/v1/recurring-tasks/{id}
```

### Authentication

Requires a key with the `tasks:write` scope.

### Path parameters

<ParamField path="id" type="string" required>Recurring task UUID.</ParamField>

### Response

Returns `204 No Content` on success. Tasks that were already generated from this schedule remain in place — only the schedule is removed (no new tasks will generate).

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE 'https://www.wiseyield.co/api/v1/recurring-tasks/aaaaaaaa.../...' \
    -H "Authorization: Bearer $WISEYIELD_API_KEY"
  ```
</RequestExample>

## Errors

| Status                    | When                                                                            |
| ------------------------- | ------------------------------------------------------------------------------- |
| `400 INVALID_ID`          | `{id}` is not a valid UUID                                                      |
| `401`                     | Missing, malformed, expired, or revoked API key                                 |
| `403 INSUFFICIENT_SCOPE`  | Key lacks `tasks:write` scope                                                   |
| `404 NOT_FOUND`           | Schedule doesn't exist, is already soft-deleted, or was created by another user |
| `429 RATE_LIMIT_EXCEEDED` | Per-user rate limit reached                                                     |
| `5xx`                     | Server error                                                                    |