Skip to main content
POST
/
apartments
Create apartment
curl --request POST \
  --url https://str.keroshospitality.com/api/v1/apartments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Seaside Villa",
  "registryId": "00002087410",
  "ownerId": 42,
  "address": "123 Beach Road"
}
'
{
  "apartment": {
    "id": 42,
    "name": "Seaside Villa",
    "address": "123 Beach Road",
    "registryId": "00002087410",
    "ownerId": 42,
    "createdAt": "2025-01-01T12:00:00Z",
    "updatedAt": "2025-01-01T12:00:00Z"
  },
  "requestId": "a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890"
}

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Body

application/json
name
string
required
Example:

"Seaside Villa"

registryId
string
required
Example:

"00002087410"

ownerId
integer
required
Example:

42

address
string
Example:

"123 Beach Road"

Response

Apartment created successfully

apartment
object
requestId
string
Example:

"a1b2c3d4-e5f6-7890-a1b2-c3d4e5f67890"