---
title: "Renouveler la période d’essai"
description: "Renouvelle la période d’essai jusqu’à `endDate`. Par défaut et au plus, le renouvellement dure autant que la période initiale (`renewal.maxEndDate` de [Consulter la période d’essai](/reference/contrats/get-contract-trial-period)). Les absences validées pendant le renouvellement le prolongent ensuite.\n\nUne seule fois, pendant la période initiale (de son premier à son dernier jour). Refusé pour un CDD (art. L1242-10), un apprenti (art. L6222-18), un contrat clôturé ou une période déjà validée.\n\n`renewalProvidedInContract: true` atteste que le contrat de travail prévoit le renouvellement. Puncto ne vérifie ni cette clause ni l’accord écrit du salarié, à recueillir pendant la période initiale (un accord donné à l’embauche ne vaut pas)."
---

> 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 › Contrats

`POST /public/v1/contracts/{contractId}/trial-period/actions/renew`

Renouvelle la période d’essai jusqu’à `endDate`. Par défaut et au plus, le renouvellement dure autant que la période initiale (`renewal.maxEndDate` de [Consulter la période d’essai](/reference/contrats/get-contract-trial-period)). Les absences validées pendant le renouvellement le prolongent ensuite.

Une seule fois, pendant la période initiale (de son premier à son dernier jour). Refusé pour un CDD (art. L1242-10), un apprenti (art. L6222-18), un contrat clôturé ou une période déjà validée.

`renewalProvidedInContract: true` atteste que le contrat de travail prévoit le renouvellement. Puncto ne vérifie ni cette clause ni l’accord écrit du salarié, à recueillir pendant la période initiale (un accord donné à l’embauche ne vaut pas).

## Authentication

- `bearerAuth`, http, header `Authorization`

## Path parameters

- `contractId` (`renewContractTrialPeriod.path.contractId`; string, required) — Identifiant Puncto du contrat. Pour partir de votre identifiant, retrouvez-le avec `GET /public/v1/contracts?collaboratorForeignErpId=…`.
  - example `"cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`

## Request body

_Required._

- `renewalProvidedInContract` (`renewContractTrialPeriod.renewalProvidedInContract`; boolean, required) — Atteste que le contrat de travail prévoit le renouvellement. Doit valoir `true`.
- `endDate` (`renewContractTrialPeriod.endDate`; string, optional) — Fin du renouvellement, avant prolongation par les absences. Par défaut et au plus, `renewal.maxEndDate`.
  - format `date`; example `"2026-10-01"`

## Example request

```json
{
  "renewalProvidedInContract": true
}
```

## Code samples

### cURL

```bash
curl --request POST \
  --url https://api.puncto.fr/public/v1/contracts/cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY/trial-period/actions/renew \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "renewalProvidedInContract": true
}
'
```

### TypeScript

```typescript
const url = 'https://api.puncto.fr/public/v1/contracts/cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY/trial-period/actions/renew';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({renewalProvidedInContract: true})
};

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/contracts/cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY/trial-period/actions/renew"

payload = { "renewalProvidedInContract": True }
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
```

## Responses

### 200

Période d’essai du contrat après le renouvellement

#### Example

```json
{
  "contractId": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
  "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
  "collaboratorForeignErpId": "string",
  "workerType": "EMPLOYEE_CDI",
  "contractStartDate": "2019-08-24",
  "trialPeriods": [
    {
      "id": "ctpe_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "type": "initial",
      "initialEndDate": "2019-08-24",
      "recalculatedEndDate": "2019-08-24",
      "recalculationDate": "2019-08-24T14:15:22Z",
      "validationDate": "2019-08-24",
      "notificationSentAt": "2019-08-24T14:15:22Z",
      "createdAt": "2019-08-24T14:15:22Z"
    }
  ],
  "endDate": "2019-08-24",
  "validationDate": "2019-08-24",
  "isRenewed": true,
  "isOver": true,
  "renewal": {
    "isPossible": true,
    "refusalReason": "string",
    "maxEndDate": "2019-08-24",
    "projectedEndDate": "2019-08-24"
  }
}
```

- `contractId` (`renewContractTrialPeriod.response.200.contractId`; string, required) — Identifiant Puncto du contrat
- `collaboratorId` (`renewContractTrialPeriod.response.200.collaboratorId`; string, required) — Identifiant Puncto du collaborateur
- `collaboratorForeignErpId` (`renewContractTrialPeriod.response.200.collaboratorForeignErpId`; string | null, required) — Identifiant du collaborateur dans votre système, null s'il n'a pas été renseigné
- `workerType` (`renewContractTrialPeriod.response.200.workerType`; any of, required) — Type de contrat, null pour un contrat en cours de création
  - any of: `WorkerType`, `null`
- `contractStartDate` (`renewContractTrialPeriod.response.200.contractStartDate`; any of, required) — Date de début du contrat, null pour un contrat en cours de création
  - any of: `string`, `null`
- `trialPeriods` (`renewContractTrialPeriod.response.200.trialPeriods`; array<object>, required) — Périodes d'essai du contrat (initiale puis renouvellement), par date de fin croissante ; vide sans période d'essai
  - `id` (`renewContractTrialPeriod.response.200.trialPeriods.id`; string, required) — Identifiant Puncto de la période d'essai
  - `type` (`renewContractTrialPeriod.response.200.trialPeriods.type`; string, required) — Période initiale ou renouvellement
    - one of `"initial"`, `"renewal"`
  - `initialEndDate` (`renewContractTrialPeriod.response.200.trialPeriods.initialEndDate`; string, required) — Fin nominale : celle prévue au contrat, ou choisie au renouvellement
    - format `date`
  - `recalculatedEndDate` (`renewContractTrialPeriod.response.200.trialPeriods.recalculatedEndDate`; any of, required) — Fin prolongée des absences validées, ou date de la validation anticipée ; null avant le premier recalcul
    - any of: `string`, `null`
  - `recalculationDate` (`renewContractTrialPeriod.response.200.trialPeriods.recalculationDate`; any of, required) — Date du dernier recalcul de la fin
    - any of: `string`, `null`
  - `validationDate` (`renewContractTrialPeriod.response.200.trialPeriods.validationDate`; any of, required) — Date de validation anticipée par l'employeur, null tant que la période n'est pas validée.
    - any of: `string`, `null`
  - `notificationSentAt` (`renewContractTrialPeriod.response.200.trialPeriods.notificationSentAt`; any of, required) — Date d'envoi du rappel de fin de période d'essai à l'entreprise
    - any of: `string`, `null`
  - `createdAt` (`renewContractTrialPeriod.response.200.trialPeriods.createdAt`; string, required) — Date d'enregistrement de la période dans Puncto
    - format `date-time`
- `endDate` (`renewContractTrialPeriod.response.200.endDate`; any of, required) — Fin effective de la période d'essai : celle de la dernière période, prolongée des absences ou avancée par une validation anticipée. Null sans période d'essai.
  - any of: `string`, `null`
- `validationDate` (`renewContractTrialPeriod.response.200.validationDate`; any of, required) — Date de la validation anticipée de la dernière période, null si elle n'a pas été validée
  - any of: `string`, `null`
- `isRenewed` (`renewContractTrialPeriod.response.200.isRenewed`; boolean, required) — La période d'essai a été renouvelée
- `isOver` (`renewContractTrialPeriod.response.200.isOver`; boolean, required) — La période d'essai est terminée : `endDate` est passée (jour calendaire de Paris)
- `renewal` (`renewContractTrialPeriod.response.200.renewal`; object, required) — Renouvellement de la période d'essai
  - `isPossible` (`renewContractTrialPeriod.response.200.renewal.isPossible`; boolean, required) — La période d'essai peut être renouvelée maintenant
  - `refusalReason` (`renewContractTrialPeriod.response.200.renewal.refusalReason`; string | null, required) — Raison pour laquelle le renouvellement est impossible, en français ; null s'il est possible
  - `maxEndDate` (`renewContractTrialPeriod.response.200.renewal.maxEndDate`; any of, required) — Fin nominale la plus tardive du renouvellement, et sa valeur par défaut : même durée que la période initiale, comptée à partir du lendemain de la fin actuelle. Null si le renouvellement est impossible.
    - any of: `string`, `null`
  - `projectedEndDate` (`renewContractTrialPeriod.response.200.renewal.projectedEndDate`; any of, required) — Fin du renouvellement à `maxEndDate`, prolongée des absences validées déjà connues pendant le renouvellement. Null si le renouvellement est impossible.
    - any of: `string`, `null`

### 400

Renouvellement refusé : CDD, apprenti, déjà renouvelée ou validée, terminée, date au-delà du maximum…

#### Example

```json
{
  "error": "La date sélectionnée dépasse la durée maximale autorisée (01/10/2026)"
}
```

- `error` (`renewContractTrialPeriod.response.400.error`; string, required) — Message lisible, en français.
- `errorCode` (`renewContractTrialPeriod.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` (`renewContractTrialPeriod.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`renewContractTrialPeriod.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` (`renewContractTrialPeriod.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`renewContractTrialPeriod.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 404

Contrat introuvable dans l’entreprise

#### Example

```json
{
  "error": "Contrat non trouvé"
}
```

- `error` (`renewContractTrialPeriod.response.404.error`; string, required) — Message lisible, en français.
- `errorCode` (`renewContractTrialPeriod.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` (`renewContractTrialPeriod.response.422.errors`; array<object>, required)
  - `message` (`renewContractTrialPeriod.response.422.errors.message`; string, required)
  - `rule` (`renewContractTrialPeriod.response.422.errors.rule`; string, required) — Règle de validation en échec.
  - `field` (`renewContractTrialPeriod.response.422.errors.field`; string, required) — Chemin du champ, par exemple `absences.0.type`.


Source: https://docs.puncto.fr/reference/contracts/renew-trial-period/index.md
