HTTP status codes

CONNECT services use standard HTTP status codes consistently across all APIs to indicate the outcome of requests:

2xx Success

These codes indicate that the client's request was successfully received, understood, and accepted. Your application can proceed as expected when receiving these responses:

• 200 OK: The request succeeded for GET, PUT, and DELETE operations.

• 201 Created: A new resource was successfully created from a POST request.

• 202 Accepted: The request has been accepted for processing but may not be complete.

• 204 No Content: The request succeeded but returns no response body (common for DELETE operations).

• 207 Multi-Status: The request resulted in multiple status codes (used for batch operations).

3xx Redirection

These codes indicate that further action needs to be taken by the client to complete the request. The action required is typically provided in the response:

• 301 Moved Permanently: The requested resource has been permanently moved to a new location.

• 302 Found: The requested resource temporarily resides at another location.

• 303 See Other: The response to the request can be found at another URI using a GET method.

• 307 Temporary Redirect: The request should be repeated with the same method at the specified location.

4xx Client Errors

These codes indicate that the client appears to have made an error. Your application should address the issue before retrying the request:

• 400 Bad Request: The request contains invalid parameters or formatting.

• 401 Unauthorized: Authentication is required or credentials are invalid.

• 403 Forbidden: The authenticated user lacks permission for the requested operation.

• 404 Not Found: The requested resource does not exist.

• 409 Conflict: The request conflicts with the current state of the resource.

• 413 Payload Too Large: The request exceeds size limits (common in batch operations).

• 429 Too Many Requests: The client has exceeded rate limits.

5xx Server Errors

These codes indicate that the server failed to fulfill a valid request. These errors should be treated as temporary conditions that may resolve without client changes:

• 500 Internal Server Error: An unexpected error occurred on the server.

• 503 Service Unavailable: The service is temporarily unavailable (during maintenance or overload).