Register native push-notification token

POST

/api/v1/account/push-token

curl --request POST \
  --url http://localhost:3001/api/v1/account/push-token \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "app_version": "example", "device_id": "example", "platform": "example", "token": "example" }'

• Local development
• Production

Register a native FCM/APNs device token for the authenticated user. Distinct from /push/subscribe (WebPush/VAPID). SA-2026-ARCH P3-M1.

Authorizations

• BearerAuth

Request Body^required

Device token registration

Media typeapplication/json

object

app_version

string

device_id

string

platform

Fcm or apns

string

token

string

Example^generated

{
  "app_version": "example",
  "device_id": "example",
  "platform": "example",
  "token": "example"
}

Responses

200

Registered

Media typeapplication/json

object

key

additional properties

any

Example^generated

{}

400

Bad Request

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}

401

Unauthorized

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}

500

Internal Server Error

Media typeapplication/json

object

error

string

success

boolean

Example^generated

{
  "error": "example",
  "success": true
}