Delete all sessions created from a given source

DELETE

/v1/sessions/{createdBy}

const url = 'https://api.aetherpush.com/v1/sessions/203.0.113.42';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://api.aetherpush.com/v1/sessions/203.0.113.42 \
  --header 'Authorization: Bearer <token>'

Revokes all access keys (sessions) on the current account whose createdBy field matches the path parameter. The createdBy value is typically the IP address from which the session was originally created.

Useful for “log out other devices” flows and for revoking a session originating from a suspicious IP.

Authorizations

accessKeyAuth

Parameters

Path Parameters

createdBy

required

string

The createdBy identifier (typically an IP address) of sessions to delete.

Example

203.0.113.42

Responses

204

Sessions revoked successfully.

401

Unauthenticated.

application/json

object

error

required

Human-readable error message.

string

requestId

Unique identifier for the request, also exposed as the X-Request-Id response header.

string

Example

{
  "error": "The requested resource was not found.",
  "requestId": "req_abc123"
}

403

API keys and named access keys cannot access this endpoint; a login session is required.

application/json

object

error

required

Human-readable error message.

string

requestId

Unique identifier for the request, also exposed as the X-Request-Id response header.

string

Example

{
  "error": "The requested resource was not found.",
  "requestId": "req_abc123"
}

404

No sessions matching the given createdBy exist on this account.

application/json

object

error

required

Human-readable error message.

string

requestId

Unique identifier for the request, also exposed as the X-Request-Id response header.

string

Example

{
  "error": "There are no sessions associated with \"203.0.113.42.\"",
  "requestId": "req_abc123"
}