Error Handling
Complete reference of error codes and responses from the Pluslide API. Includes HTTP status codes, error formats, and troubleshooting guides.
The Pluslide API uses standard HTTP status codes and returns detailed error information in JSON format.
Error Response Format
All error responses follow this structure:
{
"error": "ERROR_CODE",
"message": "Human-readable error description",
"requestId": "abc123"
}| Field | Type | Description |
|---|---|---|
error | string | Machine-readable error code |
message | string | Human-readable description |
requestId | string | Unique request ID for debugging (include in support requests) |
For validation errors (400), an additional issues field contains detailed validation problems:
{
"error": "BAD_REQUEST",
"message": "Validation failed",
"requestId": "abc123",
"issues": [
{
"code": "invalid_type",
"path": ["projectId"],
"message": "Required"
}
]
}HTTP Status Codes
| Status | Description |
|---|---|
200 | Request succeeded |
400 | Invalid request format or parameters |
401 | Missing authentication |
403 | Authentication valid but action not permitted |
404 | Requested resource doesn't exist |
429 | Rate limit exceeded |
500 | Unexpected server error |
Error Codes Reference
Authentication Errors (401)
| Message | Solution |
|---|---|
| API token is required | Add Authorization header |
Permission Errors (403)
| Message | Solution |
|---|---|
| Invalid or expired API token | Check your API key is correct |
| Slide limit reached for your current plan... | Upgrade plan or reduce slides |
| Free usage has been exceeded... | Upgrade plan or wait for next cycle |
| Project limit reached for your current plan... | Upgrade plan or delete projects |
| Template limit reached for your current plan... | Upgrade plan or reduce templates |
Validation Errors (400)
All validation errors return BAD_REQUEST with a message array containing issue objects:
| Message | Solution |
|---|---|
| Project version not found | Verify project ID |
| TemplateKey '...' does not exist | Check template key spelling |
| Required field '...' is missing | Add the required field |
| Schema validation errors | Fix request body format |
Rate Limit Errors (429)
| Message | Solution |
|---|---|
| Too many requests | Wait and retry(see) |
Server Errors (500)
| Error Code | Message | Solution |
|---|---|---|
INTERNAL_SERVER_ERROR | (varies) | Retry or contact support |
Handle Rate Limits
Best practices for handling rate limits in Pluslide API integrations. Implement exponential backoff, request queuing, and efficient retry strategies.
Rate Limits
Understanding rate limits in the Pluslide API. Learn about request quotas, response headers, and how to handle 429 Too Many Requests errors.