---
updatedAt: 2025-11-10T23:17:45.000Z
agentTools:
  projectIndex: https://developer.deputy.com/llms.txt
---

# Add unavailability details for a employee

Example

``` json
{   
    "employee": 1,
    "start": {
        "timestamp": 1657001675
    },
    "end": {
        "timestamp": 1657001676
    },
    "strComment": "Here is a note for some unavailability",
    "recurrence": {
        "FREQ": "WEEKLY",
        "INTERVAL": 2,
        "BYDAY": "MO"
    }
}

```

# OpenAPI definition

````json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Deputy",
    "contact": {},
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://{install}.{geo}.deputy.com/api",
      "variables": {
        "install": {
          "default": ""
        },
        "geo": {
          "default": ""
        }
      }
    }
  ],
  "paths": {
    "/v1/supervise/unavail": {
      "post": {
        "tags": [
          "Management"
        ],
        "summary": "Add unavailability details for a employee",
        "description": "Example\n\n``` json\n{   \n    \"employee\": 1,\n    \"start\": {\n        \"timestamp\": 1657001675\n    },\n    \"end\": {\n        \"timestamp\": 1657001676\n    },\n    \"strComment\": \"Here is a note for some unavailability\",\n    \"recurrence\": {\n        \"FREQ\": \"WEEKLY\",\n        \"INTERVAL\": 2,\n        \"BYDAY\": \"MO\"\n    }\n}\n\n```",
        "operationId": "Addunavailabilitydetailsforaemployee",
        "parameters": [],
        "requestBody": {
          "description": "",
          "content": {
            "application/json": {
              "schema": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/AddunavailabilitydetailsforaemployeeRequest"
                  },
                  {
                    "example": {
                      "employee": 1,
                      "start": {
                        "timestamp": 1657001675
                      },
                      "end": {
                        "timestamp": 1657001676
                      },
                      "strComment": "Here is a note for some unavailability",
                      "recurrence": {
                        "FREQ": "WEEKLY",
                        "INTERVAL": 2,
                        "BYDAY": "MO"
                      }
                    }
                  }
                ]
              },
              "example": {
                "employee": 1,
                "start": {
                  "timestamp": 1657001675
                },
                "end": {
                  "timestamp": 1657001676
                },
                "strComment": "Here is a note for some unavailability",
                "recurrence": {
                  "FREQ": "WEEKLY",
                  "INTERVAL": 2,
                  "BYDAY": "MO"
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "",
            "headers": {},
            "content": {}
          }
        },
        "deprecated": false
      }
    }
  },
  "components": {
    "schemas": {
      "AddunavailabilitydetailsforaemployeeRequest": {
        "title": "AddunavailabilitydetailsforaemployeeRequest",
        "required": [
          "employee",
          "start",
          "end",
          "strComment",
          "recurrence"
        ],
        "type": "object",
        "properties": {
          "employee": {
            "type": "integer",
            "format": "int32"
          },
          "start": {
            "$ref": "#/components/schemas/Start"
          },
          "end": {
            "$ref": "#/components/schemas/End"
          },
          "strComment": {
            "type": "string"
          },
          "recurrence": {
            "$ref": "#/components/schemas/Recurrence"
          }
        }
      },
      "Start": {
        "title": "Start",
        "required": [
          "timestamp"
        ],
        "type": "object",
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "End": {
        "title": "End",
        "required": [
          "timestamp"
        ],
        "type": "object",
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "Recurrence": {
        "title": "Recurrence",
        "required": [
          "FREQ",
          "INTERVAL",
          "BYDAY"
        ],
        "type": "object",
        "properties": {
          "FREQ": {
            "type": "string"
          },
          "INTERVAL": {
            "type": "integer",
            "format": "int32"
          },
          "BYDAY": {
            "type": "string"
          }
        }
      }
    },
    "securitySchemes": {
      "httpBearer": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "security": [
    {
      "httpBearer": []
    }
  ],
  "tags": [
    {
      "name": "Management"
    }
  ],
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true,
    "samples-enabled": true
  }
}
````