Errors, Limits & Types

Error handling, rate limits, and data type reference for the PortEden API.

Error Format

Simple errors:

{ 
  "error": "Error message description" 
} 

Structured errors (403 access denied, some 400 validation errors):

{ 
  "code": "ACCESS_DENIED", 
  "message": "Token does not allow this operation" 
} 

Error Codes

HTTP Status Codes

Authentication Errors

{ 
  "error": "API authentication required", 
  "message": "Missing Authorization header. Use: Authorization: Bearer <api_key>" 
} 

{ 
  "error": "API authentication failed", 
  "message": "Invalid or expired API key" 
} 

Rate Limits

All rate limits are IP-based. When exceeded, the API returns 429 Too Many Requests.

Token Auth Endpoints

/api/auth/token

Calendar Access Endpoints

/api/access/calendar

Data Types Reference

Enum Values Summary