---
title: "seat guests at specified floor elements in a diagram"
method: PATCH
path: "/4.0/diagrams/{id}/seat"
tags: ["Diagrams"]
---

# seat guests at specified floor elements in a diagram

`PATCH /4.0/diagrams/{id}/seat`

## Path parameters

- `id` string, required

## Request body

- DiagramsSeatDiagramService
  - `guest_seats` GuestsSeatDiagramService[], required
    - `floor_element_id` string, required
    - `chair_id` string, required
    - `guest_id` string
  - `update_id` string

## Response `200`

OK

- DiagramsDiagramResponseDiagramService
  - `id` string
  - `updated_at` string
  - `created_at` string
  - `chair_count` integer
  - `space_id` integer
  - `session_id` string
  - `event_id` string
  - `legacy_event_id` integer
  - `team_id` string — A legacy (v2) team id.
  - `floor_elements` object
  - `groups` object
  - `sections` object
  - `boundary_visibility` DiagramsComponents1boundaryVisibilityDiagramService — unresolved $ref
  - `deleted` boolean
  - `external_diagram_id` string
  - `external_event_id` string
  - `floorPlan` FloorPlansFloorPlanDiagramService
    - `type` 'bookableRoom' | 'spaceTemplate' | 'image' | 'background'
    - `id` integer
    - `url` string
    - `background_type` string
  - `guestlist_id` string
  - `length` number
  - `name` string
  - `notes` string
  - `prefunction_perimeter` number
  - `rotation` number
  - `service_perimeter` number
  - `sort_order` number
  - `table_numbering` DiagramsTableNumberingDiagramService
    - `allowRepeats` boolean
    - `evenOnly` boolean
    - `oddOnly` boolean
    - `skipNumbers` integer[]
    - `skipNumbersWith` integer[]
    - `startingNumber` integer
  - `team_uploads_id` string
  - `update_id` string
  - `width` number
  - `start_datetime` string, date-time
  - `end_datetime` string, date-time

## Other responses

- `400` — seating data is not valid
- `401` — unauthorized
- `404` — diagram does not exist

---

[API](https://skmtc.net/socialtables/apis/social-tables-api-gateway.md) · [All operations](https://skmtc.net/socialtables/apis/social-tables-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/socialtables/social-tables-api-gateway/revisions/b8bbb74a1212/schema)