Stream Deck Automation API
Stream Deck Automation API
POST /api/triggers/streamdeck
Trigger an automation via Stream Deck.
Authentication
| Parameter | Type | In | Required |
|---|---|---|---|
| x-eeko-api-key | string | header | Yes |
Request Body
{
"context": {
"deviceName": "string",
"triggeredAt": "string (ISO 8601)"
},
"payload": {
"automationId": "string"
}
}Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| context.deviceName | string | Yes | Stream Deck device identifier |
| context.triggeredAt | string | Yes | ISO 8601 timestamp |
| payload.automationId | string | Yes | ID of automation to trigger |
Responses
200 OK
{
"success": true,
"message": "Trigger processed successfully",
"automationId": "string",
"timestamp": "string"
}401 Unauthorized
{
"error": "Invalid API key",
"code": "AUTH_INVALID_KEY",
"status": 401
}404 Not Found
{
"error": "Automation not found",
"code": "AUTOMATION_NOT_FOUND",
"status": 404
}400 Bad Request
{
"error": "Invalid request body",
"code": "INVALID_REQUEST",
"status": 400
}Example Request
curl -X POST https://api.eeko.app/api/triggers/streamdeck \
-H "Content-Type: application/json" \
-H "x-eeko-api-key: eko_live_sk_..." \
-d '{
"context": {
"deviceName": "Stream Deck",
"triggeredAt": "2024-01-20T15:30:00.000Z"
},
"payload": {
"automationId": "auto_abc123"
}
}'