---
title: "Save Room Draft"
slug: "save-room-draft"
updated: 2026-09-03T14:50:33Z
published: 2026-09-03T14:50:33Z
canonical: "developer.rocket.chat/save-room-draft"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Save Room Draft

Post/api/v1/rooms.saveDraft

Save or clear the authenticated user's message draft for a room or an existing thread. The user must have a subscription to the room.

To save a room draft, omit `tmid`. To save a thread draft, provide the ID of the thread's main message in `tmid`. Send an empty `draft` to clear the corresponding room or thread draft. The draft cannot exceed the workspace's `Message_MaxAllowedSize` setting.

### Changelog

| Version | Description |
| --- | --- |
| 8.8.0 | Added the optional `tmid` parameter to save thread drafts |
| 8.5.0 | Added |

Header parametersX-Auth-TokenstringRequired

The `authToken` of the authenticated user.

ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-IdstringRequired

The `userId` of the authenticated user.

ExamplerbAXPnMktTFbNpwtJ

Body parameters<select class='api-response-data' aria-label='Media type'><option value='7595d671-cdff-4e3c-98b5-66bf5d88a7b2'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='4692e76d-25bf-4422-92be-033b036e648b'>Save room draft</option>
<option value='bf6ef205-a60c-41bb-9b57-f47e7c9f1114'>Save thread draft</option>
<option value='e70b55d1-6111-4129-81b3-e9cd4ef3197c'>Clear thread draft</option>
</select>Save room draft

```json
{
  "rid": "GENERAL",
  "draft": "Remember to share the report"
}
```

Save thread draft

```json
{
  "rid": "GENERAL",
  "draft": "I will check this and reply",
  "tmid": "7aDSXtjMA3KPLxLjt"
}
```

Clear thread draft

```json
{
  "rid": "GENERAL",
  "draft": "",
  "tmid": "7aDSXtjMA3KPLxLjt"
}
```

object  ridstring    Required

The room ID.

Min length1
draftstring    Required

The draft text. Send an empty string to clear the draft.

tmidstring    

The ID of the thread's main message. Omit this parameter to save or clear the main room draft.

Min length1Pattern^[^.$]+$

Responses200

OK

<select class='api-response-data' aria-label='Media type'><option value='e5406fb3-1fce-4832-8c7c-9c272d0a8fee'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='249de92c-bef5-4e3c-944b-04fa3587a18e'>Success</option>
</select>Success

```json
{
  "success": true
}
```

object  successboolean    

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='230acf7d-60f4-4396-ac2e-3e5e76275b35'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='e57ee0ae-37df-4d5c-94ae-a32bd61cc42c'>Invalid subscription</option>
<option value='29f654fd-cce2-4b0c-a613-43da6b3dea10'>Draft exceeds maximum size</option>
</select>Invalid subscription

```json
{
  "success": false,
  "error": "Invalid subscription [error-invalid-subscription]",
  "errorType": "error-invalid-subscription"
}
```

Draft exceeds maximum size

```json
{
  "success": false,
  "error": "error-message-size-exceeded"
}
```

object  successboolean    
errorstring    
errorTypestring    

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='c8cc57f3-ca85-434f-90a3-61d5dfc7a812'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='7d058745-a2f7-4ba9-8938-758c9a91f626'>Authorization Error</option>
</select>Authorization Error

```json
{
  "status": "error",
  "message": "You must be logged in to do this."
}
```

object  statusstring    
messagestring