---
updatedAt: 2026-05-04T11:51:40.000Z
agentTools:
  projectIndex: https://dev.frontapp.com/llms.txt
---

# Update time off

Update a time off.

Required scope: `time_off:write`

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "x-api-id": "front",
  "x-explorer-enabled": false,
  "x-proxy-enabled": true,
  "x-samples-enabled": true,
  "info": {
    "version": "1.0.0",
    "title": "Core API",
    "contact": {
      "name": "Front Platform",
      "url": "https://community.front.com"
    }
  },
  "security": [
    {
      "http": []
    }
  ],
  "servers": [
    {
      "url": "https://api2.frontapp.com"
    }
  ],
  "components": {
    "schemas": {
      "ResourceID": {
        "type": "string"
      },
      "UpdateTimeOff": {
        "properties": {
          "name": {
            "type": "string",
            "description": "Name of the time off"
          },
          "start_at": {
            "type": "number",
            "description": "Timestamp when the time off starts (in seconds)"
          },
          "end_at": {
            "type": "number",
            "nullable": true,
            "description": "Timestamp when the time off ends (in seconds), or null to clear it"
          },
          "auto_responder": {
            "type": "object",
            "properties": {
              "body": {
                "type": "string",
                "description": "The auto-reply message body"
              },
              "is_enabled": {
                "type": "boolean",
                "description": "Whether the auto-responder is enabled"
              },
              "is_contacts_only": {
                "type": "boolean",
                "description": "Whether the auto-responder only replies to known contacts"
              },
              "channel_ids": {
                "type": "array",
                "description": "List of channel IDs the auto-responder applies to",
                "items": {
                  "$ref": "#/components/schemas/ResourceID"
                }
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "http": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "paths": {
    "/time_offs/{time_off_id}": {
      "patch": {
        "summary": "Update time off",
        "operationId": "update-time-off",
        "description": "Update a time off.\n\nRequired scope: `time_off:write`",
        "tags": [
          "Time Off"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "time_off_id",
            "required": true,
            "description": "The time off ID",
            "schema": {
              "type": "string",
              "default": "vcr_abc123"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTimeOff"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No content"
          }
        },
        "x-required-scopes": [
          "time_off:write"
        ]
      }
    }
  }
}
```