Pico & Senti API Reference

This documentation is specific to Pico and Senti controllers only.

Base URL: https://api.illumience.com:11443 Protocol: HTTPS (TLS required) Content-Type: application/json

---

Authentication

All endpoints require a valid API key passed via the Authorization header using the Bearer scheme.

Authorization: Bearer <api_key>

If the key is invalid, missing, or disabled, the server returns 401 Unauthorized.

Rate limiting: 60 requests per minute. The api_key_last_used_at timestamp is updated on each successful request.

---

Error Handling

All errors return a JSON object with a single error field:

{
  "error": "Description of what went wrong"
}

HTTP Status Codes

Code	Meaning
200	Success
400	Bad Request — invalid or missing parameters
401	Unauthorized — missing, invalid, or disabled API key
404	Not Found — resource does not exist or is not accessible
500	Internal Server Error — unexpected server-side failure