Response Codes

This section talks about the error codes that the Typesense Cloud Cluster Management API might return.

If you're looking for the Typesense Server API docs, see here.

The following table lists all the status codes that the Cluster Management API might return:

HTTP Code	Description
200 or 201	Resource creation or action was successful
400	An API parameter is missing or malformed
402	A payment method is required for this paid operation
403	The request was denied
404	The resource was not found
422	Validation failed for the requested action
429	Request was rate limited. Try again after 1 minute.
503	A temporary service outage prevented the operation

Error responses use this shape, with the message describing the request-specific failure:

{
  "success": false,
  "message": "..."
}

A free-tier cluster can be created without a payment method. HTTP 402 means the request (creating a cluster, cloning one, or a paid configuration change) needs a payment method on the account. Add one in Typesense Cloud, then retry the request.

HTTP 404 is also returned when the resource exists but is not visible to the management key you used. After HTTP 429, wait a minute before retrying. HTTP 503 is temporary; retry after a short wait.