Revoke user consent - Amps AI Documentation

DELETE

users

{userId}

consent

curl

curl --request DELETE \
  --url 'https://api.amps.ai/users/user_abc123/consent' \
  --header 'x-api-key: amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx' \
  --header 'content-type: application/json' \
  --data '{}'

{
  "success": true,
  "data": {
    "success": true,
    "userId": "user_abc123",
    "revokedDeviceCount": 2,
    "revokedDeviceIds": [
      "device_abc123",
      "device_xyz789"
    ]
  },
  "meta": {
    "requestId": "req_8a2Bf3kP",
    "environment": "sandbox",
    "timestamp": "2026-06-02T12:00:00.000Z",
    "latencyMs": 12
  }
}

Authorizations

x-api-key

string

header

required

Path Parameters

userId

string

required

The unique identifier for the user.

Example:

"user_abc123"

Body

application/json

deviceIds

string[]

Response

Consent revoked successfully.

success

boolean

required

Always true for success responses.

data

Revoke Consent · object

required

Show child attributes

meta

Response Meta · object

required

Metadata attached to every response: the request identifier, the serving environment, the build timestamp, and the server-side latency.

Show child attributes

List schedulesReturn a paginated list of the schedules the API key can access, across every device, newest first. This is the lifted cross-device read of the schedules that are set on each device via `PUT /{type}/{id}/schedule`; it mirrors `GET /actions`. Filter by `deviceId`, lifecycle `state`, or end-user `userId`. The route is published ahead of the scheduler; every call returns 501 until it lands.

curl

curl --request DELETE \
  --url 'https://api.amps.ai/users/user_abc123/consent' \
  --header 'x-api-key: amps_sk_test_xxxxxxxxxxxxxxxxxxxxxxxx' \
  --header 'content-type: application/json' \
  --data '{}'

{
  "success": true,
  "data": {
    "success": true,
    "userId": "user_abc123",
    "revokedDeviceCount": 2,
    "revokedDeviceIds": [
      "device_abc123",
      "device_xyz789"
    ]
  },
  "meta": {
    "requestId": "req_8a2Bf3kP",
    "environment": "sandbox",
    "timestamp": "2026-06-02T12:00:00.000Z",
    "latencyMs": 12
  }
}