Push vehicle action (unsupported) - Amps AI Documentation

POST

vehicle

{deviceId}

curl

curl --request POST \
  --url 'https://api.amps.ai/vehicle/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": "/vehicle/device_vehicle_001",
    "latencyMs": 2
  }
}

Authorizations

x-api-key

string

header

required

Path Parameters

deviceId

string

required

The unique identifier for the vehicle 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.

Show child attributes

meta

object

required

Request metadata.

Show child attributes

Revoke user consentRevoke consent for a user. Stored credentials are deleted and the affected devices stop receiving pulls and pushes. Pass a `deviceIds` array to scope the revocation; omit it to revoke every device under the user.

curl

curl --request POST \
  --url 'https://api.amps.ai/vehicle/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": "/vehicle/device_vehicle_001",
    "latencyMs": 2
  }
}