---
title: "Update Event"
method: PUT
path: "/locations/{location_id}/events/{event_id}"
tags: ["Events"]
---

# Update Event

`PUT /locations/{location_id}/events/{event_id}`

## Request

- Base URL: `https://api.alteg.io/api/v2`
- URL: `https://api.alteg.io/api/v2/locations/{location_id}/events/{event_id}`
- Auth: HTTP bearer

Replace the mutable properties of an Event.

## Path parameters

- `location_id` integer, required
- `event_id` integer, required

## Query parameters

- `include` string[]

## Headers

- `Accept` string, required
- `Content-Type` 'application/json', required
- `Authorization` string, required

## Request body

- EventUpdateRequest
  - `team_member_id` integer, required: Team Member ID
  - `service_id` integer, required: Service ID
  - `resource_instance_ids` integer[], required: Resource Instance IDs; an empty array is allowed
  - `label_ids` integer[], required: Tag IDs; an empty array is allowed
  - `date` string, required: Event start in the Location timezone as `YYYY-MM-DD HH:MM:SS`
  - `length` integer, required: Total Event duration in seconds, including any technical break
  - `technical_break_duration` integer, nullable: Technical break in seconds; `null` keeps or derives the current value
  - `capacity` integer, required: Total number of available places
  - `comment` string, nullable: Event comment
  - `color` string, nullable: Event color including `#`
  - `instructions` string, nullable: Instructions for Booking Users
  - `stream_link` string, nullable: Online Event stream link
  - `force` boolean: Skip Team Member and Resource Instance availability conflicts

## Response `200`

Event updated successfully

- EventItemResponse
  - `data` EventResource, required
    - `type` 'activity', required: Literal JSON:API resource type returned for Events
    - `id` string, required: Event ID
    - `attributes` object, required
      - `master_id` integer, required: Deprecated wire field for Team Member ID; use `staff_id`
      - `staff_id` integer, required: Team Member ID
      - `service_id` integer, required: Service ID
      - `timestamp` integer, required: Event start as a Unix timestamp
      - `length` integer, required: Event duration in seconds
      - `capacity` integer, required: Total number of available places
      - `clients_count` integer, required: Number of Booking Users currently booked
      - `color` string, required: Event background color including `#`
      - `instructions` string, required: Instructions for Booking Users
      - `stream_link` string, required: Online Event stream link, or an empty string
      - `font_color` string, required: Event text color including `#`
      - `notified` boolean, required: Whether an Event notification was sent
      - `comment` string, nullable, required: Event comment
      - `deleted` boolean, required: Whether the Event is deleted (a deleted Event stays readable by ID)
      - `schedule_id` integer, nullable, required: Event Schedule ID
      - `schedule_till` object, nullable, required: Event Schedule end represented by the production DateTime wire object
        - `date` string, required
        - `timezone_type` integer, required
        - `timezone` string, required
      - `schedule_event_modified` boolean, nullable, required: Whether this scheduled Event differs from its Event Schedule
      - `date` string, required: Event start in the Location timezone with a numeric offset
    - `relationships` object: Present when related data is requested through `include`
      - `staff` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `master` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `service` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
      - `resource_instances` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
      - `labels` ToManyRelationship
        - `data` ResourceIdentifier[], required
          - `type` string, required
          - `id` string, required
      - `duration_details` ToOneRelationship
        - `data` ResourceIdentifier, required
          - `type` string, required
          - `id` string, required
  - `included` IncludedResource[]: Resources requested through `include`, when available
    - `type` string, required
    - `id` string, required
    - `attributes` object, required
    - `relationships` object
  - `meta` unknown[], required: Empty JSON array returned for an Event item
    - unknown

## Other responses

- `400`: Invalid request body
- `401`: Unauthorized
- `403`: Forbidden - No permission to update the Event
- `404`: Location, Event, Team Member, or Service not found
- `409`: Team Member or Resource Instance is unavailable
- `422`: Request validation failed

## Changes

- **2026-09-30** `0f9938a8b921`: 1 info
  - added the required property `data/attributes/deleted` to the response with the `200` status
- **2026-09-29** `a3a7f7158533`: 1 breaking, 1 warning, 1 info
  - added the new required request property `team_member_id`
  - removed the request property `staff_id`
  - response property `data/attributes/master_id` deprecated

[Operation history](https://skmtc.dev/alteg/apis/business-management/changes/locations/:location_id/events/:event_id/put.md)

---

[API](https://skmtc.dev/alteg/apis/business-management.md) - [All operations](https://skmtc.dev/alteg/apis/business-management/llms.txt) - [OpenAPI document](https://skmtc.dev/alteg/apis/business-management/revisions/a2d63320b944?raw)
