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

# Approve or deny a leave request

> Approve or deny a single Leave Request by its unique identifier

Only the Leave Requests pending approval can be approved or denied.

A comment is required to deny a Leave Request.




## OpenAPI

````yaml /openapi-specs/timmi-absences-v3.yaml post /api/v3/leaveRequests/{id}/approvals
openapi: 3.1.0
info:
  title: Lucca Absences API
  version: '1.0'
  description: Welcome on the documentation for Lucca Absences API.
  contact:
    name: API Support
    url: https://support.lucca.fr
    email: contact@luccasoftware.com
  license:
    name: Unlicensed
    url: https://www.luccasoftware.com
servers:
  - url: https://{host}
    description: Your Lucca account URL.
    variables:
      host:
        default: example.ilucca.net
        description: >-
          The URL of your dedicated Lucca account: `{account}.{env}.{region}`.


          Account reflects your company name. Env indicates the environment.
          Region depends on your server location.


          **Please, use your test or sandbox environments (and not your
          production env.) for testing purposes.**


          Environments:

          - `ilucca`: production environment for customers.

          - `ilucca-test`: test environment for customers.

          - `ilucca-demo`: demo environment for prospects.


          Regions:

          - `.ch` for Swiss located accounts.

          - `.net` for the others.


          Regarding sandboxes, the pattern differs:
          `https://{account}-{sandboxName}.sandbox.{server}.luccasoftware.com`,
          where:

          - `{sandboxName}` is automatically generated upon creation.

          - `{server}` may be "eu1", "eu2" or "ch1".
security: []
tags:
  - name: Leaves
    description: Absences taken on a given day
  - name: Leave Requests
    description: Workflow object for submiting an absence.
  - name: Imports
    description: Absences imports
  - name: SickLeaveCertificates
    description: >-
      Complementary data for certain leave types in order to comply with French
      law.
paths:
  /api/v3/leaveRequests/{id}/approvals:
    parameters:
      - $ref: '#/components/parameters/Authorization'
      - schema:
          type: string
        name: id
        description: ID of the leave-request.
        in: path
        required: true
    post:
      tags:
        - Leave Requests
      summary: Approve or deny a leave request
      description: |
        Approve or deny a single Leave Request by its unique identifier

        Only the Leave Requests pending approval can be approved or denied.

        A comment is required to deny a Leave Request.
      operationId: post-api-v3-leaveRequests-leaveRequestId-approvals
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                approved:
                  type: boolean
                comment:
                  type:
                    - 'null'
                    - string
            examples:
              example:
                value:
                  approved: false
                  comment: your presence is required at the working meeting
      responses:
        '200':
          description: OK
        '400':
          $ref: '#/components/responses/Problem'
components:
  parameters:
    Authorization:
      name: Authorization
      required: true
      description: 'API key. Value must be formatted like so: `lucca application={api_key}`.'
      in: header
      schema:
        type: string
  responses:
    Problem:
      description: Problem
      content:
        application/json:
          schema:
            type: object
            properties:
              Status:
                type: integer
                description: HTTP status code.
                example: 401
              Message:
                type: string
                description: Human readable error message.
                example: Unauthorized

````