Skip to main content

Public API

The SolidPixels Public API lets you manage your account, release app versions, control devices, and push images from your own software.

Authentication​

All public API endpoints use Bearer authentication. Include your API key in the Authorization header of every request:

Authorization header
Authorization: Bearer <API key>
Keep your API key private

Create and revoke named keys in the SolidPixels app under Development Resources → API keys. A key is displayed only once when it is created, so copy it immediately and store it securely. You must own at least one device before you can create a key.

Your account​

GET/v1/account/

Return the email address and creation time for the authenticated account.

Request
GET /v1/account/
Authorization: Bearer <API key>
200 response
{
"email": "[email protected]",
"createdAt": "2025-01-15T12:30:00.000Z"
}

Explore the API​

  • Apps — discover available apps, submit immutable versions for review, and deploy or roll back an approved release.
  • Devices — list devices, inspect their state, update settings, and manage installations.
  • Push images — send a transient image to a device or create a persistent rotation entry.

Every list endpoint returns a bare JSON array. Unless an endpoint says otherwise, invalid bodies return 400, missing resources return 404, and requests without permission to access a resource return 403.