---
title: "Modifier une absence (route historique)"
description: "**Route historique** : utilisez `PUT /public/v1/absences/{absenceId}`. Même corps, mêmes règles et mêmes réponses."
---

> 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.

> **Deprecated.**

Path: API Puncto › Absences

`PATCH /public/v1/absences/{absenceId}`

**Route historique** : utilisez `PUT /public/v1/absences/{absenceId}`. Même corps, mêmes règles et mêmes réponses.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Path parameters

- `absenceId` (`updateAbsenceStatus.path.absenceId`; string, required) — Identifiant Puncto de l’absence.
  - example `"abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`

## Request body

_Required._

- `status` (`updateAbsenceStatus.status`; string, optional) — - `validated` : Accepté - `rejected` : Refusé - `canceled` : Annulé
  - one of `"validated"`, `"rejected"`, `"canceled"`
- `type` (`updateAbsenceStatus.type`; string, optional) — Les arrêts de travail (`SICK`, `SICK_AT`, `SICK_ATJ`, `SICK_MP`) et les congés parentaux (`PARENTAL`) sont refusés : saisissez-les dans Puncto. - `JNT` : Jours Non Travaillés (forfait jour) - `RTT` : RTT - `COR` : Contrepartie Obligatoire en Repos - `RCR` : Repos Compensateur - `PTO_N` : Congés payés - `PTO_N-1` : Congés payés N-1 - `PTO_N-2` : Congés payés N-2 - `UNPAID` : Congés sans solde - `FAMILY` : Congés familiaux - `REST` : Repos - `SENIORITY` : Ancienneté - `INTERN_CP` : Congé payé stage - `PREGNANCY_EXAM` : Examens obligatoires de grossesse
  - one of `"JNT"`, `"RTT"`, `"COR"`, `"RCR"`, `"PTO_N"`, `"PTO_N-1"`, `"PTO_N-2"`, `"UNPAID"`, `"FAMILY"`, `"REST"`, `"SENIORITY"`, `"INTERN_CP"`, `"PREGNANCY_EXAM"`
- `startDate` (`updateAbsenceStatus.startDate`; string, optional) — Premier jour d’absence.
  - format `date`; example `"2026-10-05"`
- `endDate` (`updateAbsenceStatus.endDate`; string, optional) — Dernier jour d’absence, inclus.
  - format `date`; example `"2026-10-05"`
- `onlyHalfDayAtStart` (`updateAbsenceStatus.onlyHalfDayAtStart`; boolean, optional) — Le premier jour, seul l’après-midi est pris.
- `onlyHalfDayAtEnd` (`updateAbsenceStatus.onlyHalfDayAtEnd`; boolean, optional) — Le dernier jour, seule la matinée est prise.
- `familyEventType` (`updateAbsenceStatus.familyEventType`; string, optional) — Événement familial. Requis quand `type` vaut `FAMILY`.
  - one of `"mariage_pacs_salarie"`, `"mariage_pacs_enfant"`, `"deces_conjoint_pacs"`, `"deces_enfant_moins_25_oui"`, `"deces_enfant_moins_25_non_parent_oui"`, `"deces_enfant_moins_25_non_parent_non"`, `"deces_personne_charge_moins_25"`, `"deces_parent"`, `"deces_beau_frere_belle_soeur"`, `"deces_frere_soeur"`, `"deces_beau_parent"`, `"deces_autre_ascendant"`, `"deuil_enfant_moins_25"`, `"naissance_adoption"`, `"handicap_enfant"`
- `childArrivalDate` (`updateAbsenceStatus.childArrivalDate`; string, optional) — Date de naissance de l’enfant, requise pour un congé de naissance. Pour `PREGNANCY_EXAM`, date présumée de l’accouchement, facultative.
  - format `date`
- `pregnancyExamBeneficiary` (`updateAbsenceStatus.pregnancyExamBeneficiary`; string, optional) — Requis quand `type` vaut `PREGNANCY_EXAM`. - `PREGNANT_EMPLOYEE` : Salariée enceinte ou en parcours de PMA - `PARTNER` : Conjoint, partenaire de PACS ou concubin
  - one of `"PREGNANT_EMPLOYEE"`, `"PARTNER"`

## Example request

```json
{
  "status": "validated"
}
```

## Code samples

### cURL

```bash
curl --request PATCH \
  --url https://api.puncto.fr/public/v1/absences/abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "validated"
}
'
```

### TypeScript

```typescript
const url = 'https://api.puncto.fr/public/v1/absences/abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY';
const options = {
  method: 'PATCH',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({status: 'validated'})
};

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/absences/abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY"

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

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

print(response.text)
```

## Responses

### 200

Absence modifiée

#### Example

```json
{
  "startDate": "2019-08-24",
  "endDate": "2019-08-24",
  "duration": 0,
  "durationExplanation": "string",
  "familyEventType": "deces_enfant_moins_25_non_parent_oui",
  "parentalLeaveType": "BIRTH_ADDITIONAL_LEAVE",
  "childArrivalDate": "2019-08-24",
  "pregnancyExamBeneficiary": "PREGNANT_EMPLOYEE",
  "maternityLeaveSituation": "FIRST_OR_SECOND",
  "actualBirthDate": "2019-08-24",
  "hasPathologicalPrenatalState": true,
  "adoptionLeaveSituation": "ONE_CHILD",
  "childArrivalType": "BIRTH",
  "familyProofFile": {
    "id": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
    "displayFileName": "string",
    "fileType": "PAYSLIP",
    "file": {
      "key": "string",
      "mimeType": "image/jpeg"
    },
    "collaborator": {
      "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "firstName": "string",
      "lastName": "string",
      "imageKey": "string"
    },
    "generatedByUserAccount": {
      "userAccountId": "uacc_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "firstName": "string",
      "lastName": "string"
    },
    "createdAt": "2019-08-24T14:15:22Z"
  },
  "workStoppage": {
    "lastWorkedDay": "2019-08-24",
    "accidentDate": "2019-08-24",
    "diseaseObservationDate": "2019-08-24",
    "proofFile": {
      "id": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "displayFileName": "string",
      "fileType": "PAYSLIP",
      "file": {
        "key": "string",
        "mimeType": "image/jpeg"
      },
      "collaborator": {
        "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
        "firstName": "string",
        "lastName": "string",
        "imageKey": "string"
      },
      "generatedByUserAccount": {
        "userAccountId": "uacc_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
        "firstName": "string",
        "lastName": "string"
      },
      "createdAt": "2019-08-24T14:15:22Z"
    },
    "withSubrogation": true,
    "isProlongation": true
  },
  "workStoppageDsn": {
    "declaredForecastEndDate": "2019-08-24",
    "isDsnDeclared": true,
    "resumption": {
      "id": "wsre_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "resumptionDate": "2019-08-24",
      "resumptionMotive": "01",
      "signalementRequired": true,
      "trackingStatus": "queued"
    },
    "pendingDeclaration": {
      "kind": "scheduled",
      "scheduledAt": "2019-08-24T14:15:22Z"
    }
  },
  "foreignErpId": "string",
  "contractId": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
  "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
  "createdAt": "2019-08-24T14:15:22Z",
  "isLocked": true,
  "lockState": {
    "state": "OPEN"
  },
  "lateInputRegularisation": {
    "status": "PENDING",
    "carrierYear": 0,
    "carrierMonth": 0
  },
  "isDsnLocked": true,
  "id": "abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
  "type": "JNT",
  "status": "pending",
  "onlyHalfDayAtStart": true,
  "onlyHalfDayAtEnd": true,
  "collaboratorForeignErpId": "string",
  "isProlongation": true
}
```

- `startDate` (`updateAbsenceStatus.response.200.startDate`; string, required)
  - format `date`
- `endDate` (`updateAbsenceStatus.response.200.endDate`; string, required)
  - format `date`
- `duration` (`updateAbsenceStatus.response.200.duration`; number, required)
- `durationExplanation` (`updateAbsenceStatus.response.200.durationExplanation`; string, required)
- `parentalLeaveType` (`updateAbsenceStatus.response.200.parentalLeaveType`; any of, required) — Type de congé parental (congé de maternité, de paternité, d'adoption, supplémentaire de naissance), null pour toute autre absence.
  - any of: `ParentalLeaveType`, `null`
- `foreignErpId` (`updateAbsenceStatus.response.200.foreignErpId`; string | null, required)
- `contractId` (`updateAbsenceStatus.response.200.contractId`; string, required) — Identifiant Puncto
- `collaboratorId` (`updateAbsenceStatus.response.200.collaboratorId`; string, required) — Identifiant Puncto
- `createdAt` (`updateAbsenceStatus.response.200.createdAt`; string, required) — Date à laquelle la demande d'absence a été posée.
  - format `date-time`
- `isLocked` (`updateAbsenceStatus.response.200.isLocked`; boolean, required) — True when the absence can no longer be modified: one of its payroll months is closed and no open payslip can carry the regularisation (`lockState.state === 'BLOCKED'`).
- `lockState` (`updateAbsenceStatus.response.200.lockState`; any of, required) — État de saisie sur les mois couverts par l'absence (saisie tardive possible)
  - any of: `object`, `object`, `object`
- `isDsnLocked` (`updateAbsenceStatus.response.200.isDsnLocked`; boolean, required) — True when the DSN of the underlying work stoppage is being transmitted or already deposited. The absence can then no longer be edited, cancelled or deleted.
- `id` (`updateAbsenceStatus.response.200.id`; string, required) — Identifiant Puncto
- `type` (`updateAbsenceStatus.response.200.type`; string, required)
  - one of `"JNT"`, `"RTT"`, `"COR"`, `"RCR"`, `"PTO_N"`, `"PTO_N-1"`, `"PTO_N-2"`, `"UNPAID"`, `"FAMILY"`, `"PARENTAL"`, `"REST"`, `"SICK"`, `"SICK_AT"`, `"SICK_MP"`, `"SICK_ATJ"`, `"SENIORITY"`, `"INTERN_CP"`, `"PREGNANCY_EXAM"`
- `status` (`updateAbsenceStatus.response.200.status`; string, required)
  - one of `"pending"`, `"validated"`, `"rejected"`, `"canceled"`, `"technical-cancel"`
- `onlyHalfDayAtStart` (`updateAbsenceStatus.response.200.onlyHalfDayAtStart`; boolean, required)
- `onlyHalfDayAtEnd` (`updateAbsenceStatus.response.200.onlyHalfDayAtEnd`; boolean, required)
- `collaboratorForeignErpId` (`updateAbsenceStatus.response.200.collaboratorForeignErpId`; string | null, required)
- `isProlongation` (`updateAbsenceStatus.response.200.isProlongation`; boolean, required) — Prolongation d'un arrêt de travail : `workStoppage` est alors l'arrêt initial, avec l'avis de prolongation pour justificatif.
- `familyEventType` (`updateAbsenceStatus.response.200.familyEventType`; any of, optional)
  - any of: `FamilyEventType`, `null`
- `childArrivalDate` (`updateAbsenceStatus.response.200.childArrivalDate`; any of, optional)
  - any of: `string`, `null`
- `pregnancyExamBeneficiary` (`updateAbsenceStatus.response.200.pregnancyExamBeneficiary`; any of, optional) — Examens de grossesse : la salariée enceinte elle-même, ou son conjoint.
  - any of: `PregnancyExamBeneficiary`, `null`
- `maternityLeaveSituation` (`updateAbsenceStatus.response.200.maternityLeaveSituation`; any of, optional) — Congé de maternité : rang de l'enfant ou naissance multiple, qui fixe la durée légale.
  - any of: `MaternityLeaveSituation`, `null`
- `actualBirthDate` (`updateAbsenceStatus.response.200.actualBirthDate`; any of, optional) — Congé de maternité : date réelle de l'accouchement, une fois connue.
  - any of: `string`, `null`
- `hasPathologicalPrenatalState` (`updateAbsenceStatus.response.200.hasPathologicalPrenatalState`; boolean, optional) — Congé de maternité : état pathologique prénatal prescrit (14 jours de plus avant la naissance).
- `adoptionLeaveSituation` (`updateAbsenceStatus.response.200.adoptionLeaveSituation`; any of, optional) — Congé d'adoption : nombre d'enfants à charge ou adoption multiple, qui fixe la durée légale.
  - any of: `AdoptionLeaveSituation`, `null`
- `childArrivalType` (`updateAbsenceStatus.response.200.childArrivalType`; any of, optional) — Congé de naissance : naissance ou adoption de l'enfant, purement informatif.
  - any of: `ChildArrivalType`, `null`
- `familyProofFile` (`updateAbsenceStatus.response.200.familyProofFile`; any of, optional)
  - any of: `ApiCompanyFile`, `null`
- `workStoppage` (`updateAbsenceStatus.response.200.workStoppage`; object, optional)
  - `lastWorkedDay` (`updateAbsenceStatus.response.200.workStoppage.lastWorkedDay`; string, required)
    - format `date`
  - `accidentDate` (`updateAbsenceStatus.response.200.workStoppage.accidentDate`; any of, required)
    - any of: `string`, `null`
  - `diseaseObservationDate` (`updateAbsenceStatus.response.200.workStoppage.diseaseObservationDate`; any of, required)
    - any of: `string`, `null`
  - `proofFile` (`updateAbsenceStatus.response.200.workStoppage.proofFile`; any of, required)
    - any of: `ApiCompanyFile`, `null`
  - `withSubrogation` (`updateAbsenceStatus.response.200.workStoppage.withSubrogation`; boolean, required)
  - `isProlongation` (`updateAbsenceStatus.response.200.workStoppage.isProlongation`; boolean, required) — Nature de l'arrêt porté par cette absence : prolongation d'un arrêt initial ou arrêt initial.
- `workStoppageDsn` (`updateAbsenceStatus.response.200.workStoppageDsn`; object, optional) — État déclaratif de l'arrêt de travail porté par cette absence. Renseigné par les listes internes seulement : le calculer suppose de lire les suivis DSN et la reprise, ce que l'API publique ne fait pas. Son absence ne veut donc pas dire « rien à déclarer », mais « information non chargée ici ».
  - `declaredForecastEndDate` (`updateAbsenceStatus.response.200.workStoppageDsn.declaredForecastEndDate`; any of, required) — Date de fin prévisionnelle (S21.G00.60.003) telle que le signalement d'arrêt l'a déclarée. Null tant qu'aucun signalement n'a abouti : c'est elle qui dit si une reprise est anticipée.
    - any of: `string`, `null`
  - `isDsnDeclared` (`updateAbsenceStatus.response.200.workStoppageDsn.isDsnDeclared`; boolean, required) — Vrai quand un signalement d'arrêt a été déposé et validé (idFlux obtenu).
  - `resumption` (`updateAbsenceStatus.response.200.workStoppageDsn.resumption`; any of, required) — Reprise anticipée déclarée sur cet arrêt, le cas échéant.
    - any of: `ApiWorkStoppageResumption`, `null`
  - `pendingDeclaration` (`updateAbsenceStatus.response.200.workStoppageDsn.pendingDeclaration`; any of, required) — Signalement d'arrêt que l'automatisation doit encore déposer : aucune reprise ne peut être saisie avant lui. Null quand l'arrêt est déclaré, ou que l'automatisation ne le déclarera pas.
    - any of: `ApiPendingWorkStoppageDeclaration`, `null`
- `lateInputRegularisation` (`updateAbsenceStatus.response.200.lateInputRegularisation`; any of, optional) — Dernière saisie tardive faite sur cette entité, `null` s'il n'y en a pas. Renseigné par les listes internes seulement : son absence veut dire « information non chargée ici ».
  - any of: `ApiLateInputRegularisation`, `null`

### 400

Modification ou transition de statut refusée

#### Example

```json
{
  "error": "Statut invalide pour cette absence"
}
```

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

### 404

Absence introuvable

#### Example

```json
{
  "error": "Absence non trouvée"
}
```

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


Source: https://docs.puncto.fr/reference/absences/update-status/index.md
