Axsync API v2

Current user

The authenticated user and their active sessions.

The current user object

FieldTypeDescription
idstringUnique identifier, prefixed with us_.
emailstringPrimary email address.
namestringDisplay name.
localestringBCP 47 language tag.
timezonestringIANA time zone.
created_attimestampCreation time, RFC 3339 in UTC.

Example

{
  "id": "us_8f3k2Q9xLm",
  "email": "alex@example.com",
  "name": "Alex Morgan",
  "locale": "en-US",
  "timezone": "Europe/Berlin",
  "created_at": "2026-09-14T08:21:07Z"
}

GET /me

Get the current user. Returns the user the access token belongs to.

Required scope: profile

Query parameters

FieldTypeDescription
limitintegerPage size, 1–100. Default 25.
cursorstringCursor from the previous page.
sortstringField to sort by, prefix - for descending.
filterstringFilter expression, see Filtering and sorting.

Request

curl -X GET "https://api.axnode.net/v2/me" \
  -H "Authorization: Bearer $AXSYNC_TOKEN"
const res = await fetch('https://api.axnode.net/v2/me', {
  method: 'GET',
  headers: { Authorization: `Bearer ${token}` }
});
const data = await res.json();
import requests

res = requests.get(
    'https://api.axnode.net/v2/me',
    headers={'Authorization': f'Bearer {token}'},
)
data = res.json()

Response 200

{
  "data": [
    {
      "id": "us_8f3k2Q9xLm",
      "email": "alex@example.com",
      "name": "Alex Morgan",
      "locale": "en-US",
      "timezone": "Europe/Berlin",
      "created_at": "2026-09-14T08:21:07Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

PATCH /me

Update the current user. Updates profile fields.

Required scope: profile

Body parameters

FieldTypeDescription
emailstringPrimary email address.
namestringDisplay name.
localestringBCP 47 language tag.
timezonestringIANA time zone.

Request

curl -X PATCH "https://api.axnode.net/v2/me" \
  -H "Authorization: Bearer $AXSYNC_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"email": "alex@example.com"}'
const res = await fetch('https://api.axnode.net/v2/me', {
  method: 'PATCH',
  headers: { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"email": "alex@example.com"})
});
const data = await res.json();
import requests

res = requests.patch(
    'https://api.axnode.net/v2/me',
    headers={'Authorization': f'Bearer {token}'}, json={"email": "alex@example.com"},
)
data = res.json()

Response 200

{
  "id": "us_8f3k2Q9xLm",
  "email": "alex@example.com",
  "name": "Alex Morgan",
  "locale": "en-US",
  "timezone": "Europe/Berlin",
  "created_at": "2026-09-14T08:21:07Z"
}

GET /me/sessions

List sessions. Active sign-ins with device and last activity.

Required scope: profile

Query parameters

FieldTypeDescription
limitintegerPage size, 1–100. Default 25.
cursorstringCursor from the previous page.
sortstringField to sort by, prefix - for descending.
filterstringFilter expression, see Filtering and sorting.

Request

curl -X GET "https://api.axnode.net/v2/me/sessions" \
  -H "Authorization: Bearer $AXSYNC_TOKEN"
const res = await fetch('https://api.axnode.net/v2/me/sessions', {
  method: 'GET',
  headers: { Authorization: `Bearer ${token}` }
});
const data = await res.json();
import requests

res = requests.get(
    'https://api.axnode.net/v2/me/sessions',
    headers={'Authorization': f'Bearer {token}'},
)
data = res.json()

Response 200

{
  "data": [
    {
      "id": "us_8f3k2Q9xLm",
      "email": "alex@example.com",
      "name": "Alex Morgan",
      "locale": "en-US",
      "timezone": "Europe/Berlin",
      "created_at": "2026-09-14T08:21:07Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

DELETE /me/sessions/{id}

Revoke a session. Signs the session out immediately.

Required scope: profile

Request

curl -X DELETE "https://api.axnode.net/v2/me/sessions/us_8f3k2Q9xLm" \
  -H "Authorization: Bearer $AXSYNC_TOKEN"
const res = await fetch('https://api.axnode.net/v2/me/sessions/us_8f3k2Q9xLm', {
  method: 'DELETE',
  headers: { Authorization: `Bearer ${token}` }
});
const data = await res.json();
import requests

res = requests.delete(
    'https://api.axnode.net/v2/me/sessions/us_8f3k2Q9xLm',
    headers={'Authorization': f'Bearer {token}'},
)
data = res.json()

Response 200

{
  "deleted": true,
  "id": "us_8f3k2Q9xLm"
}