Tables

Table Management

The table endpoints manage the tables within each space.

Naming convention

JSON fields use camelCase (spaceId, orderId).

GET /tables

Retrieves all tables in the system.

Authorization: tables_read

cURL Example:

curl -X GET "http://127.0.0.1:9154/tables" \
  -H "Cookie: accessToken=$ACCESS_TOKEN" \
  -H "Cookie: refreshToken=$REFRESH_TOKEN"

Response Body (Success - 200 OK):

[
  {
    "id": "31c4a18d-a760-4d1f-a3ca-80b184c2d56c",
    "name": "Table 1",
    "status": "available",
    "spaceId": "7743646d-946a-4401-96ca-f970b617485c",
    "orderId": null
  },
  {
    "id": "605850d7-1c91-45dc-aabc-2e3055d8feae",
    "name": "Table 2",
    "status": "occupied",
    "spaceId": "ee5078dc-8829-4c91-af1d-2096089d4608",
    "orderId": "b9f9c8c7-180c-49e5-8a45-0cfca41d2dfa"
  }
]

Response Body (Empty list - 200 OK):

"No tables found"

GET /tables/by-space/{id}

Retrieves all tables of a specific space.

Authorization: tables_read

Path Parameters:

• id (string): Space ID.

cURL Example:

curl -X GET "http://127.0.0.1:9154/tables/by-space/9c9064f5-f389-4e32-b037-805a86827777" \
  -H "Cookie: accessToken=$ACCESS_TOKEN" \
  -H "Cookie: refreshToken=$REFRESH_TOKEN"

Response Body (Success - 200 OK):

[
  {
    "id": "9c9064f5-f389-4e32-b037-805a86827777",
    "name": "Table 1",
    "status": "available",
    "spaceId": "da787870-0cff-44a7-9179-ceeb49739292",
    "orderId": null
  }
]

Response Body (Empty list - 200 OK):

"No tables found for space ID: {id}"

GET /tables/{id}

Retrieves a specific table by its ID.

Authorization: tables_read

Path Parameters:

• id (string): ID of the table to retrieve.

cURL Example:

curl -X GET "http://127.0.0.1:9154/tables/8dacb80d-0694-4a11-bab0-01a877fea66d" \
  -H "Cookie: accessToken=$ACCESS_TOKEN" \
  -H "Cookie: refreshToken=$REFRESH_TOKEN"

Response Body (Success - 200 OK):

{
  "id": "2056766b-dcd7-4bb7-a3c7-40d953592195",
  "name": "Table 1",
  "status": "available",
  "spaceId": "ded606ff-2d0b-4f89-8352-9d34355043be",
  "orderId": null
}

POST /tables

Creates a new table.

Authorization: tables_create

Request Body:

{
  "name": "string",
  "status": "available",
  "spaceId": "string",
  "orderId": null
}

cURL Example:

curl -X POST "http://127.0.0.1:9154/tables" \
  -H "Cookie: accessToken=$ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Table 5",
    "status": "available",
    "spaceId": "1a1a67c9-15bf-4f18-aadd-896308ff51c2",
    "orderId": null
  }'

Response Body (Success - 201 Created):

{
  "id": "a77d20d1-49d2-4f6a-af3c-96eb89c5cfcb",
  "message": "Table added successfully"
}

PUT /tables/{id}

Updates an existing table.

Authorization: tables_update

Path Parameters:

• id (string): ID of the table to update.

Request Body:

{
  "name": "string",
  "status": "available|occupied|reserved",
  "spaceId": "string",
  "orderId": "string"
}

cURL Example:

curl -X PUT "http://127.0.0.1:9154/tables/7088369e-ad06-4ec6-8cc0-68465a395877" \
  -H "Cookie: accessToken=$ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Table 1 VIP",
    "status": "occupied",
    "spaceId": "c5a51221-851d-4b7e-b534-1847091fcc09",
    "orderId": "d7c7a43c-7884-48b1-82c4-a18e48aafef8"
  }'

Response Body (Success - 200 OK):

{
  "id": "a77d20d1-49d2-4f6a-af3c-96eb89c5cfcb",
  "message": "Table updated successfully"
}

DELETE /tables/{id}

Deletes a table from the system.

Authorization: tables_delete

Path Parameters:

• id (string): ID of the table to delete.

cURL Example:

curl -X DELETE "http://127.0.0.1:9154/tables/fc5566ef-6e4c-465f-a1ad-d9ff5dfbb92a" \
  -H "Cookie: accessToken=$ACCESS_TOKEN"

Response: 204 No Content (no body).

Notes

info

• Table IDs are UUIDs generated automatically.
• A table must be associated with a valid space (spaceId).
• Valid table statuses are: available, occupied, reserved.
• The orderId field is set when there is an active order at the table.