---
updatedAt: 2026-04-24T16:38:27.000Z
agentTools:
projectIndex: https://developers.cloudbeds.com/llms.txt
---
# postHousekeepingAssignment
Assign rooms (single or multiple) to an existing housekeeper
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Cloudbeds API",
"description": "\n Welcome to the documentation for Cloudbeds API Version v1.3!\n If you are looking to learn how to use the Cloudbeds API to access guest information, reservations, or similar data\n for your Cloudbeds customers, then you've come to the right place.\n
\n\n\n In this document you will find all the API methods we provide along with explanations for parameters and response\n examples.\n
\n\n\n If you have questions about different implementation steps (e.g. how to implement OAuth 2.0), please refer to our\n Integrations Portal.\n
\n\n\n Be sure to subscribe to the monthly\n Cloudbeds API announcement mailing list to receive information on new additions and improvements to the\n Cloudbeds API and related developer tools.\n
\n\n\n Endpoint: https://api.cloudbeds.com/api/v1.3/{method}\n
\n\n\n HTTPS: Our API requires HTTPS. We'll respond with an appropriate error if you're not using it.\n
\n\n\n Request Format: HTTP GET, POST and PUT (Content-Type: application/x-www-form-urlencoded)\n
\n\n\n Response Format: JSON\n
\n\n\n Response Header: X-Request-ID is added to response headers in all calls to help accelerate support\n and troubleshooting.\n
\n\n\n \n \n ![\"Run](\"https://run.pstmn.io/button.svg\")
\n \n use this link to access our Public collection in Postman.\n
",
"version": "v1.3"
},
"servers": [
{
"url": "https://api.cloudbeds.com/api/v1.3/"
}
],
"components": {
"securitySchemes": {
"api_key": {
"type": "apiKey",
"name": "x-api-key",
"in": "header"
},
"OAuth2": {
"type": "oauth2",
"flows": {
"authorizationCode": {
"authorizationUrl": "",
"tokenUrl": "",
"scopes": {
"delete:adjustment": "delete:adjustment",
"delete:appPropertySettings": "delete:appPropertySettings",
"delete:roomblock": "delete:roomblock",
"read:allotmentBlock": "read:allotmentBlock",
"read:appPropertySettings": "read:appPropertySettings",
"read:communication": "read:communication",
"read:currency": "read:currency",
"read:customFields": "read:customFields",
"read:dashboard": "read:dashboard",
"read:group": "read:group",
"read:guest": "read:guest",
"read:hotel": "read:hotel",
"read:houseAccount": "read:houseAccount",
"read:housekeeping": "read:housekeeping",
"read:item": "read:item",
"read:package": "read:package",
"read:payment": "read:payment",
"read:rate": "read:rate",
"read:reservation": "read:reservation",
"read:room": "read:room",
"read:roomblock": "read:roomblock",
"read:taxesAndFees": "read:taxesAndFees",
"read:user": "read:user",
"write:adjustment": "write:adjustment",
"write:allotmentBlock": "write:allotmentBlock",
"write:appError": "write:appError",
"write:appPropertySettings": "write:appPropertySettings",
"write:communication": "write:communication",
"write:customFields": "write:customFields",
"write:group": "write:group",
"write:guest": "write:guest",
"write:hotel": "write:hotel",
"write:houseAccount": "write:houseAccount",
"write:housekeeping": "write:housekeeping",
"write:item": "write:item",
"write:payment": "write:payment",
"write:rate": "write:rate",
"write:reservation": "write:reservation",
"write:room": "write:room",
"write:roomblock": "write:roomblock"
}
}
}
}
},
"schemas": {
"PostHousekeepingAssignmentRequest": {
"type": "object",
"properties": {
"propertyID": {
"description": "Property ID",
"type": "string",
"nullable": true
},
"roomIDs": {
"description": "List of room IDs comma-separated, i.e. 101-0,101-3",
"type": "string"
},
"housekeeperID": {
"description": "Housekeeper ID. To designate a room as unassigned, simply set the value to 0.",
"type": "string"
}
}
},
"PostHousekeepingAssignmentResponse": {
"type": "object",
"properties": {
"success": {
"description": "Returns if the request could be completed",
"type": "boolean"
},
"message": {
"description": "To be used in case any error occurs (if success = false). If success = true, it does not exist.",
"type": "string",
"nullable": true
}
}
}
}
},
"paths": {
"/postHousekeepingAssignment": {
"post": {
"tags": [
"Housekeeping"
],
"summary": "postHousekeepingAssignment",
"description": "Assign rooms (single or multiple) to an existing housekeeper",
"responses": {
"200": {
"description": "200 Response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PostHousekeepingAssignmentResponse"
}
}
}
}
},
"security": [
{
"api_key": [
"write:housekeeping"
]
},
{
"OAuth2": [
"write:housekeeping"
]
}
],
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"$ref": "#/components/schemas/PostHousekeepingAssignmentRequest"
}
}
}
}
}
}
}
}
```