---
updatedAt: 2026-03-11T14:35:40.000Z
---

Fetch the complete documentation index at: https://developer.connecteam.com/llms.txt. Use this file to discover all available pages before exploring further.

# Delete Pay Rate

The "Delete Pay Rate" endpoint removes a specific pay rate entry identified by user ID and effective date.

## Endpoint

`DELETE https://api.connecteam.com/pay-rates/v1/pay-rates/users/{userId}/{effectiveDate}`

## Authentication

* **API Key** or **OAuth 2.0**
* **OAuth Scope:** `pay_rates.delete`

## Path Parameters

| Parameter       | Type                | Required | Description                                  |
| --------------- | ------------------- | -------- | -------------------------------------------- |
| `userId`        | integer             | Yes      | The user ID                                  |
| `effectiveDate` | string (YYYY-MM-DD) | Yes      | The effective date of the pay rate to delete |

## Behavior

* This operation **cannot be undone**.
* Returns **404** if no pay rate exists for the given user and effective date combination — even if the user has pay rates on other dates.
* Returns **409** (`HAS_LOCKED_DAYS`) if the effective date conflicts with approved or locked timesheet days.
* Other pay rates for the same user are **not affected** — only the specific entry matching the effective date is removed.
* After deletion, the pay rate will **no longer appear** in GET responses.

> 🚧 Locked Days Protection
>
> **If the user has approved or locked timesheet days on or after the effective date, the delete request will be rejected with HTTP 409 and error code `HAS_LOCKED_DAYS`.**

## Response

```json
{
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "success": true
  }
}
```

## Error Codes

| HTTP Status | Error Code        | Description                                                     |
| ----------- | ----------------- | --------------------------------------------------------------- |
| 400         | —                 | Invalid date format (must be YYYY-MM-DD)                        |
| 401         | —                 | Missing authentication                                          |
| 403         | —                 | Invalid API key or insufficient OAuth scope                     |
| 404         | —                 | No pay rate found for the specified user ID and effective date  |
| 409         | HAS\_LOCKED\_DAYS | Effective date conflicts with approved or locked timesheet days |

[Pay Rates API Reference](https://developer.connecteam.com/reference)