Extend a Temporary Room

POST

/api/v1/external/rooms/{room_id}/extend

Extends the room expiration for Personal Pro owners within plan limits. Available via webapp session or an API token with temporary-rooms:extend.

Authorizations

• default

Parameters

Path Parameters

room_id

required

string

The ID of the room.

Example

01kxb0t5c4ccf16vp1qt0y0mer

Request Body

object

extension_hours

Optional extension amount in hours. Defaults to the single-extension max.

integer

nullable

24

Responses

200

object

data

object

room_id

string

01HX...

expires_at

string

2026-06-13T12:00:00+00:00

max_expires_at

string

2026-07-12T12:00:00+00:00

extension_count

integer

1

{
  "data": {
    "room_id": "01HX...",
    "expires_at": "2026-06-13T12:00:00+00:00",
    "max_expires_at": "2026-07-12T12:00:00+00:00",
    "extension_count": 1
  }
}

403

Extension not allowed

object

message

string

Temporary Room extension is not allowed.

errors

object

code

Array<string>

[
  "temporary_room_extension_not_allowed"
]

{
  "message": "Temporary Room extension is not allowed.",
  "errors": {
    "code": [
      "temporary_room_extension_not_allowed"
    ]
  }
}

422

Extension exceeds max

object

message

string

The given data was invalid.

errors

object

extension_hours

Array<string>

[
  "extension_hours_exceeds_limit"
]

{
  "message": "The given data was invalid.",
  "errors": {
    "extension_hours": [
      "extension_hours_exceeds_limit"
    ]
  }
}