---
title: "PATCH period"
method: PATCH
path: "/v3/administrations/{administration_id}/periods/{id}"
tags: ["Periods"]
---

# PATCH period

`PATCH /v3/administrations/{administration_id}/periods/{id}`

## Request

- Base URL: `https://api.bookingexperts.com`
- URL: `https://api.bookingexperts.com/v3/administrations/{administration_id}/periods/{id}`
- Auth: one of:
  - API key in header `X-API-KEY`
  - OAuth 2
    - Authorization code: `/oauth/authorize`
    - Token URL: `/oauth/token`
- TypeScript: <https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/docs/v3/administrations/:administration_id/periods/:id/patch.ts> (a function with typed inputs; its response is checked against the schema)

Updates the period for the given ID

## Path parameters

- `administration_id` string, required
- `id` string, required

## Query parameters

- `fields[period]` string
- `include` string

## Headers

- `Accept-Language` string

## Request body

- object
  - `data` object: Periods are sets of date ranges. They can be used to define the validity of: * Costs * DiscountActions (when they can be booked and when the stay period is valid) * Packages (when they can be booked and when the stay period is valid)
    - `id` string: ID
    - `type` string: Type
    - `attributes` object: Attributes
      - `name` object
        - `cs` string
        - `da-DK` string
        - `de` string
        - `de-AT` string
        - `de-CH` string
        - `en-US` string
        - `en-GB` string
        - `es` string
        - `fr` string
        - `fr-BE` string
        - `fr-LU` string
        - `it` string
        - `nb` string
        - `nl` string
        - `nl-BE` string
        - `pl` string
        - `pt` string
        - `tr` string
        - `en` string
        - `da` string
    - `relationships` object: Relationships
      - `period_entries` object
        - `data` object[]
          - `id` string: period_entries ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
    - `meta` object: Metadata
      - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known.
  - `included` PeriodEntry[]
    - `id` string: ID
    - `type` string: Type
    - `attributes` object: Attributes
      - `start_date` string, date
      - `end_date` string, date
    - `meta` object: Metadata
      - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known.

## Response `200`

PeriodResponse

- object
  - `data` Period: Periods are sets of date ranges. They can be used to define the validity of: * Costs * DiscountActions (when they can be booked and when the stay period is valid) * Packages (when they can be booked and when the stay period is valid)
    - `id` string: ID
    - `type` string: Type
    - `attributes` object: Attributes
      - `name` object
        - `cs` string
        - `da-DK` string
        - `de` string
        - `de-AT` string
        - `de-CH` string
        - `en-US` string
        - `en-GB` string
        - `es` string
        - `fr` string
        - `fr-BE` string
        - `fr-LU` string
        - `it` string
        - `nb` string
        - `nl` string
        - `nl-BE` string
        - `pl` string
        - `pt` string
        - `tr` string
        - `en` string
        - `da` string
    - `relationships` object: Relationships
      - `period_entries` object
        - `data` object[]
          - `id` string: period_entries ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
    - `meta` object: Metadata
      - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known.
  - `included` PeriodEntry[]
    - `id` string: ID
    - `type` string: Type
    - `attributes` object: Attributes
      - `start_date` string, date
      - `end_date` string, date
    - `meta` object: Metadata
      - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known.

## Other responses

- `429`: Error
- `default`: Error

## Changes

- **2026-11-03** `ff81bc4fefa9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/changes/v3/administrations/:administration_id/periods/:id/patch.md)

---

[API](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3.md) - [All operations](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/revisions/ff81bc4fefa9?raw)