---
updatedAt: 2026-06-12T20:28:13.000Z
---

Fetch the complete documentation index at: https://developers.pismo.io/pismo-docs/llms.txt. Use this file to discover all available pages before exploring further.

# Update holiday (deprecated)

**DEPRECATED**. Call the new [Update holiday](ref:update-holiday) endpoint instead. 

This endpoint is deprecated starting April 30, 2026, and final removal from both test (EXT) and production environments on October 30, 2026.

Update some holiday information. Only parameters that are passed are updated.

**Note:** This endpoint is designed for transaction banking. For more information, refer to [Calendars and holidays in transaction banking](doc:calendars-and-holidays-in-transaction-banking).


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Platform setup - Holidays",
    "description": "Manage business and non-business days by organization",
    "version": "v1.0",
    "contact": {
      "name": "Pismo Support",
      "url": "https://developers.pismo.io/support/"
    },
    "license": {
      "name": "Copyright Pismo"
    }
  },
  "servers": [
    {
      "url": "https://sandbox.pismolabs.io/holidays-core",
      "description": "API sandbox server for testing"
    }
  ],
  "security": [
    {
      "S2SAuthentication": []
    }
  ],
  "tags": [
    {
      "name": "Holidays v2 - Transaction banking (deprecated)",
      "description": "View and manage business and non-business days configurations (for Transaction banking only)"
    }
  ],
  "components": {
    "parameters": {
      "HolidayIdPath": {
        "name": "holiday_id",
        "in": "path",
        "description": "Pismo-assigned holiday ID",
        "required": true,
        "schema": {
          "type": "string",
          "example": "8675309"
        }
      }
    },
    "schemas": {
      "handler.HTTPError": {
        "description": "Error",
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Error code"
          },
          "message": {
            "type": "string",
            "description": "Error message"
          }
        }
      },
      "HolidayDescription": {
        "type": "string",
        "description": "Holiday description",
        "maxLength": 500,
        "example": "Day to party like it's 1999"
      },
      "HolidayID": {
        "type": "integer",
        "description": "Holiday ID",
        "example": 8675309
      },
      "HolidayName": {
        "type": "string",
        "description": "Holiday name",
        "example": "New Year's Day",
        "maxLength": 80,
        "minLength": 1
      },
      "Metadata": {
        "type": "object",
        "description": "A valid JSON schema as specified in https://json-schema.org/specification.html. Used to register rules used to authorize the transaction.\n\n**Note**: This field must not be used to send Personally Identifiable Information (PII), Payment Card Industry (PCI) data, or any sensitive/regulated information. Metadata fields are intended for operational, non-sensitive data only. For sensitive data, use the specific parameters designed for that purpose. For more information, refer to [Get started with Pismo APIs](https://developers.pismo.io/pismo-docs/reference/get-started-with-pismo-apis#metadata).\n"
      },
      "presenter.UpdateHolidayV2Request": {
        "description": "Data to update a holiday",
        "type": "object",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "$ref": "#/components/schemas/HolidayName"
          },
          "description": {
            "$ref": "#/components/schemas/HolidayDescription"
          },
          "metadata": {
            "$ref": "#/components/schemas/Metadata"
          }
        }
      },
      "presenter.UpdateHolidayV2Response": {
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/HolidayID"
          },
          "name": {
            "$ref": "#/components/schemas/HolidayName"
          },
          "description": {
            "$ref": "#/components/schemas/HolidayDescription"
          },
          "metadata": {
            "$ref": "#/components/schemas/Metadata"
          }
        }
      }
    },
    "responses": {
      "400BadRequestUpdateHoliday": {
        "description": "Bad request",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/handler.HTTPError"
            },
            "examples": {
              "missing-x-tenant-header": {
                "$ref": "#/components/examples/BadRequestResponseMissingHeader"
              },
              "invalid-id-params": {
                "$ref": "#/components/examples/BadRequestResponseInvalidParams"
              },
              "holiday-not-found": {
                "$ref": "#/components/examples/BadRequestResponseNotFound"
              }
            }
          }
        }
      },
      "401UnauthorizedError": {
        "description": "Access token missing or invalid"
      },
      "404NotFound": {
        "description": "Not found",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/handler.HTTPError"
            },
            "examples": {
              "response-missing-tenant": {
                "$ref": "#/components/examples/NotFoundResponse"
              }
            }
          }
        }
      },
      "500InternalServerError": {
        "description": "Internal server error",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/handler.HTTPError"
            },
            "examples": {
              "generic-internal-error": {
                "$ref": "#/components/examples/InternalServerErrorResponse"
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "S2SAuthentication": {
        "type": "http",
        "scheme": "bearer",
        "description": "All requests must pass an [account-specific token](https://developers.pismo.io/pismo-docs/docs/account-specific-access-tokens).\n"
      }
    },
    "examples": {
      "InternalServerErrorResponse": {
        "value": {
          "code": "EHLD0001",
          "message": "Something went wrong - please try again"
        }
      },
      "BadRequestResponseMissingHeader": {
        "value": {
          "code": "EHLD0016",
          "message": "Missing x-tenant header"
        }
      },
      "BadRequestResponseNotFound": {
        "value": {
          "code": "EHLD0034",
          "message": "Holiday not found"
        }
      },
      "BadRequestResponseInvalidParams": {
        "value": {
          "code": "400",
          "message": "Invalid parameter value: {parameter name}"
        }
      },
      "NotFoundResponse": {
        "value": {
          "code": "404",
          "message": "{target name} not found"
        }
      }
    }
  },
  "paths": {
    "/holidays-core/v2/holiday/{holiday_id}": {
      "put": {
        "summary": "Update holiday (deprecated)",
        "description": "**DEPRECATED**. Call the new [Update holiday](https://developers.pismo.io/pismo-docs/reference/update-holiday) endpoint instead. \n\nThis endpoint is deprecated starting April 30, 2026, and final removal from both test (EXT) and production environments on October 30, 2026.\n\nUpdate some holiday information. Only parameters that are passed are updated.\n\n**Note:** This endpoint is designed for transaction banking. For more information, refer to [Calendars and holidays in transaction banking](https://developers.pismo.io/pismo-docs/docs/calendars-and-holidays-in-transaction-banking).\n",
        "operationId": "put-v2-holiday",
        "deprecated": true,
        "tags": [
          "Holidays v2 - Transaction banking (deprecated)"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/HolidayIdPath"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/presenter.UpdateHolidayV2Request"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Updated holiday",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/presenter.UpdateHolidayV2Response"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequestUpdateHoliday"
          },
          "401": {
            "$ref": "#/components/responses/401UnauthorizedError"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    }
  }
}
```