Errors, Limits & ReliabilityHTTP Status Codes

HTTP Status Codes

HTTP status codes used by Protecto APIs and what each means for your integration.

Protecto uses standard HTTP status codes to signal success and failure type.

Status code reference

Status codeMeaningWhen it happens
200OKRequest succeeded
201CreatedResource created successfully
400Bad RequestInvalid or incomplete payload
401UnauthorizedMissing, invalid, or expired auth token
404Not FoundIncorrect endpoint or route
405Method Not AllowedWrong HTTP method used
429Too Many RequestsRate limit exceeded
500Internal Server ErrorProcessing failure after retries

What to do for each code

Status codeRecommended action
400Fix the request payload — check required fields and data types
401Refresh or replace the auth token
404Verify the endpoint URL and path
405Check the HTTP method — most Protecto endpoints use PUT
429Retry with exponential backoff
500Safe to retry once — contact support if persistent

The HTTP status code always accompanies the JSON error body. Use the status code to decide how to respond and error.message to understand why it failed.