Error Handling

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"
}

Field	Type	Description
`error`	string	Machine-readable error code
`message`	string	Human-readable description

For validation errors (400), the message field contains an array of issues:

{
  "error": "BAD_REQUEST",
  "message": [
    {
      "code": "invalid_type",
      "path": ["projectId"],
      "message": "Required"
    }
  ]
}

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

Message	Solution
API token is required	Add Authorization header

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

All validation errors return BAD_REQUEST with a message array containing issue objects:

Message	Solution
Too many requests	Wait and retry(see)

Error Code	Message	Solution
`INTERNAL_SERVER_ERROR`	(varies)	Retry or contact support