---
title: "HTTP Response Codes"
slug: "http-response-codes"
updated: 2025-11-13T06:49:57Z
published: 2025-11-13T06:49:57Z
canonical: "developer.rocket.chat/http-response-codes"
---

> ## 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.

# HTTP Response Codes

The Rocket.Chat REST API uses standard HTTP response codes to indicate whether an API request was successful or if an error occurred. Each response includes a status code and, in most cases, a message that provides additional context to help you troubleshoot.

The following table summarizes the most common response codes and their meanings:

| Status codes | Description |
| --- | --- |
| `200 OK` | The API request is successfully processed. |
| `201 Created` | The request was successful, and a new resource has been created. |
| `204 No Content` | The request was successful, but there is no response body. Commonly returned after a successful `DELETE` operation. |
| `400 Bad Request` | The request could not be processed due to missing or invalid parameters. Check the request format and required fields. |
| `401 Unauthorized` | Authentication failed because the user ID or token is invalid or expired. Obtain a valid token using the authentication endpoint. |
| `403 Forbidden` | The authenticated user does not have permission to perform this action. Verify the assigned roles and permissions. |
| `404 Not Found` | The requested resource could not be found. Check the endpoint URL or resource identifier. |
| `409 Conflict ` | The request could not be completed due to a conflict with the current resource state (for example, trying to create a duplicate record). |
| `429 Too Many Requests` | The client has sent too many requests in a given period. Wait or reduce the request rate before retrying. |
| `500 Internal Server Error` | The server encountered an unexpected condition. Try again later or check the server logs for more information. |
| `503 Service Unavailable` | The server is temporarily unavailable or undergoing maintenance. Retry the request after some time. |

**Example error response:**

```json
{
"success": false,
"error": "The field 'username' is required",
"errorType": "error-invalid-params"
}
```

This structure helps you identify whether a request failed due to invalid input, authentication issues, or temporary server conditions.