Skip to main content
POST
/
solar-inverter
/
{deviceId}
curl
curl --request POST \
  --url 'https://api.amps.ai/solar-inverter/device_abc123' \
  --header 'x-api-key: amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx'
{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API key is required"
  },
  "meta": {
    "requestId": "req_8sW2dRtX",
    "timestamp": "2026-04-29T12:00:00.000Z",
    "path": "/solar-inverter/device_inverter_001",
    "latencyMs": 2
  }
}

Authorizations

x-api-key
string
header
required

Path Parameters

deviceId
string
required

The unique identifier for the solar inverter device.

Example:

"device_abc123"

Response

Invalid or missing API key

Uniform error response. The error.code identifies the failure, error.message carries a human-readable explanation, and error.details carries structured context (failed fields, conflicting action IDs, supported capabilities) where relevant.

success
boolean
required

Always false for error responses.

error
object
required

Error envelope.

meta
object
required

Request metadata.