Docs
Introduction

Palpable Developer API

Welcome to the Palpable Developer API documentation. This API allows you to programmatically control your IoT devices, create automations, and integrate Palpable into your applications.

Base URL

https://palpable.technology/api

Authentication

All API requests require authentication using an API key. You can create API keys in the Palpable mobile app under Settings > Developer > API Keys.

Include your API key in the Authorization header:

curl -H "Authorization: Bearer pk_your_api_key_here" \
      https://palpable.technology/api/devices

Rate Limits

  • Standard tier: 100 requests per minute
  • Pro tier: 1,000 requests per minute
  • Enterprise: Custom limits

Rate limit headers are included in all responses:

  • X-RateLimit-Limit: Maximum requests per minute
  • X-RateLimit-Remaining: Requests remaining in current window
  • X-RateLimit-Reset: Unix timestamp when the limit resets

Response Format

All responses are JSON. Successful responses include the requested data:

{
  "devices": [...],
  "success": true
}

Error responses include an error message:

{
  "error": "Device not found",
  "status": 404
}

Quick Links

SDKs & Libraries

Official SDKs coming soon:

  • JavaScript/TypeScript
  • Python
  • Go

Support

Devices API