Create Seat Assignment

post

https://{subdomain}.maptician.com/ext/v1/assignments/seats/

This endpoint allows the creation of a permanent seat assignment, ensuring efficient space management within the organization. To create a seat assignment, the following conditions must be met:

The seat must be in an "active" state.
The seat must be designated with a usage type that is "assignable".
There must not be any pre-existing assignments for the seat.

Seat assignments are strictly for resources of the type "seat". The seatID of the seat is required to proceed with the assignment. When creating an assignment, only a single user identifier needs to be provided (email, userID, employeeID, externalId, or name). This identifier will be used to look up the Occupant in Maptician.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

seatID

uuid

The seatID of the seat to create the seating assignment for. This seat has to be a assignable seat that is not already assigned to a user.

userID

uuid

The unique identifier that Maptician assigns to each Occupant and User. This can be obtained through Maptician's API. This is the highest priority item in identifying a target for the presence operation.

string

The email (case insensitive) of the Occupant or User subject to the presence operation. This must match their email within the Maptician environment. This is the second highest priority in identifying an individual.

employeeID

string

A string representing the individual's employee ID or other organization specific identifier. This values must match (case sensitive) the value of Employee ID in the Maptician environment for this individual. This is the the third highest priority for identifying an individual.

externalId

string

A string representing an identifier set by the SCIM provisioner or otherwise set within Maptician to represent a specific individual. This is an infrequently used method and will not be applicable to most environments. This has the fourth highest priority for identifying an individual.

name

string

A strong representing the concatenated first and last name of the individual. These values must match the first and last names found within Maptician (case insensitive). There is a potential for multiple matching users being found - the action will apply to the first matched individual only. This method is not recommended due to this potential ambiguity if any other matching mode is possible.

first

string

The first/given name of an individual. Must be used in conjunction with 'last' and will result in the same outcome as using the concatenated value in 'name'

last

string

The last/family name of an individual. Must be used in conjunction with 'first' and will result in the same outcome as using the concatenated value in 'name'

Headers

mapticianauth

string

required

Authorization token to access the API.

Responses

401

Access token is missing or invalid

500

An unexpected server error occurred. Please try again later.

200Successfully created the seat assignment.

400Invalid Request