EekoDocs

Stream Deck Automation API

Stream Deck Automation API

POST /api/triggers/streamdeck

Trigger an automation via Stream Deck.

Authentication

ParameterTypeInRequired
x-eeko-api-keystringheaderYes

Request Body

{
  "context": {
    "deviceName": "string",
    "triggeredAt": "string (ISO 8601)"
  },
  "payload": {
    "automationId": "string"
  }
}

Parameters

FieldTypeRequiredDescription
context.deviceNamestringYesStream Deck device identifier
context.triggeredAtstringYesISO 8601 timestamp
payload.automationIdstringYesID 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"
    }
  }'