---
title: "PUT /v1/notification-devices"
method: PUT
path: "/v1/notification-devices"
tags: ["Notifications"]
---

# PUT /v1/notification-devices

`PUT /v1/notification-devices`

## Request

- Base URL: `https://api.arbital.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.arbital.xyz/v1/notification-devices`
- Auth: HTTP bearer

Registers or refreshes one authenticated app installation. The user is always derived from the bearer token.

## Request body

- NotificationDeviceRegistration
  - `installation_id` string, required
  - `platform` 'ios' | 'android', required
  - `push_token` string, required
  - `notification_contract` 2

## Response `204`

Installation registered

## Other responses

- `400`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `401`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `413`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `503`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.

---

[API](https://skmtc.dev/arbital/apis/arbital-api.md) - [All operations](https://skmtc.dev/arbital/apis/arbital-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arbital/apis/arbital-api/revisions/bb0185edf43a?raw)