🚨 Error Codes
This section provides a comprehensive list of error codes returned by the Scriptix API. Each response includes an HTTP status code and, when applicable, a structured JSON error message to help you understand and debug your requests.
✅ Success Codes
| Code | Description |
|---|---|
200 | OK – Request processed successfully |
201 | Created – Resource successfully created |
204 | No Content – Action succeeded, no body |
🔁 Client Error Codes
| Code | Description |
|---|---|
400 | Bad Request – The request is invalid or missing required fields |
401 | Unauthorized – Your API key or token is missing or invalid |
403 | Forbidden – You don't have permission to perform this action |
404 | Not Found – The requested resource could not be found |
409 | Conflict – Resource already exists or conflicts with current state |
415 | Unsupported Media Type – Invalid content type (e.g., not text/plain) |
422 | Unprocessable Entity – Input data failed validation or was malformed |
429 | Too Many Requests – You have exceeded the rate limit for this endpoint |
🔧 Server Error Codes
| Code | Description |
|---|---|
500 | Internal Server Error – Something went wrong on our side |
503 | Service Unavailable – Server is temporarily overloaded or down |
📦 Example Error Response
{
"error": {
"code": 422,
"message": "Missing required field: language",
"details": {
"field": "language",
"issue": "This field cannot be null."
}
}
}
🧠 Tips for Handling Errors
- 400–422: Check your request body, headers, and query parameters
- 401/403: Ensure you are using a valid API key and have the right permissions
- 429: Implement backoff and retry logic
- 500+: Wait and retry; contact support if the issue persists