---
title: "Supprimer une variable récurrente"
description: "Supprime une variable récurrente et ses justificatifs, et recalcule les brouillons des mois qu’elle versait. Refusé si elle est validée et déjà versée par un mois verrouillé (paie clôturée ou bulletin validé) : fixez plutôt son dernier mois de versement."
---

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

Path: API Puncto › Variables récurrentes

`DELETE /public/v1/recurring-variables/{recurringVariableId}`

Supprime une variable récurrente et ses justificatifs, et recalcule les brouillons des mois qu’elle versait. Refusé si elle est validée et déjà versée par un mois verrouillé (paie clôturée ou bulletin validé) : fixez plutôt son dernier mois de versement.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Path parameters

- `recurringVariableId` (`deleteRecurringVariable.path.recurringVariableId`; string, required) — Identifiant Puncto de la variable récurrente. Depuis votre `foreignErpId`, retrouvez-le avec `GET /public/v1/recurring-variables/{recurringVariableId}?matchingBy=BY_FOREIGN_ERP_ID`.
  - example `"rvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`

## Code samples

### cURL

```bash
curl --request DELETE \
  --url https://api.puncto.fr/public/v1/recurring-variables/rvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY \
  --header 'Authorization: Bearer <token>'
```

### TypeScript

```typescript
const url = 'https://api.puncto.fr/public/v1/recurring-variables/rvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.puncto.fr/public/v1/recurring-variables/rvar_01JB7Q6ZC8V3K9N2M4R5T7W8XY"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)
```

## Responses

### 204

Variable récurrente supprimée

### 400

Variable déjà versée par un mois verrouillé

#### Example

```json
{
  "error": "Un mois de cette variable récurrente est déjà clôturé : elle ne peut plus être supprimée, renseignez plutôt son dernier mois de versement."
}
```

- `error` (`deleteRecurringVariable.response.400.error`; string, required) — Message lisible, en français.
- `errorCode` (`deleteRecurringVariable.response.400.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 401

Clé d’API absente, invalide ou révoquée

#### Example

```json
{
  "error": "Les endpoints de l’API publique sont réservés aux comptes application."
}
```

- `error` (`deleteRecurringVariable.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`deleteRecurringVariable.response.401.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 403

Opération hors de l’accès de la clé d’API

#### Example

```json
{
  "error": "Opération interdite"
}
```

- `error` (`deleteRecurringVariable.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`deleteRecurringVariable.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 404

Variable récurrente introuvable dans l’entreprise

#### Example

```json
{
  "error": "Variable récurrente non trouvée"
}
```

- `error` (`deleteRecurringVariable.response.404.error`; string, required) — Message lisible, en français.
- `errorCode` (`deleteRecurringVariable.response.404.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 422

Paramètres invalides

#### Example

```json
{
  "errors": [
    {
      "message": "Le champ statut de l’absence doit être une valeur autorisée",
      "rule": "enum",
      "field": "status"
    }
  ]
}
```

- `errors` (`deleteRecurringVariable.response.422.errors`; array<object>, required)
  - `message` (`deleteRecurringVariable.response.422.errors.message`; string, required)
  - `rule` (`deleteRecurringVariable.response.422.errors.rule`; string, required) — Règle de validation en échec.
  - `field` (`deleteRecurringVariable.response.422.errors.field`; string, required) — Chemin du champ, par exemple `absences.0.type`.


Source: https://docs.puncto.fr/reference/recurring-variables/delete/index.md
