# Register Push Devices

> Register or refresh device installs for the calling user.

Canonical URL: https://docs.botyard.io/docs/api/push-registrations/register_push_devices_v1_me_push_registrations_put

`PUT /v1/me/push-registrations`

Register or refresh device installs for the calling user.

Idempotent per install. A revocation secret is returned only for a
registration this request created or re-enabled.

## Request body

`application/json`: PushRegistrationsRequest (required)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `registrations` | array of PushDeviceRegistration | yes | Device installs to register, each install id at most once. All-or-nothing: if any entry is rejected, none is stored. |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| `200` | Successful Response | PushRegistrationsResponse |
| `default` | RFC 9457 Problem Details error response | ProblemDetails |

Full schemas: operation `register_push_devices_v1_me_push_registrations_put` in the OpenAPI spec at https://api.botyard.io/openapi.json.