---
title: "Registro de novo dispositivo móvel"
method: PUT
path: "/devices"
tags: ["Gestão de dispositivos"]
---

# Registro de novo dispositivo móvel

`PUT /devices`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/devices`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Registre um novo dispositivo móvel para um cliente (proprietário).</p>
  <span class="bkly-ref-small-stable-tag">stable</span> 
  <span class="bkly-ref-scope-tag">scope: device.create</span>
</div>

## Headers

- `api-version` string, required
- `Authorization` string, required: <i>Token</i> de autorização do tipo Bearer.

## Request body

- DeviceRegistrationRequest
  - `device` Device
    - `owner` Owner
      - `document` Document
        - `value` string, nullable
        - `type` 'CPF' | 'CNPJ'
    - `uniqueId` string, nullable
    - `type` string, nullable
    - `model` string, nullable
    - `brand` string, nullable
    - `totalMemory` integer
    - `pushToken` string, nullable
    - `details` DeviceDetails
      - `system` SystemDetails
        - `name` string, nullable
        - `version` string, nullable
        - `country` string, nullable
        - `locale` string, nullable
        - `buildNumber` string, nullable
        - `fontScale` number, double, nullable
      - `storage` Storage
        - `totalDiskCapacity` integer, nullable
        - `freeDiskStorage` integer, nullable
      - `connection` Connection
        - `carrier` string, nullable
        - `network` Network
          - `ipAddress` string, nullable
          - `macAddress` string, nullable
        - `isAirPlaneMode` boolean, nullable
      - `battery` Battery
        - `level` number, double, nullable
        - `isCharging` boolean, nullable
      - `firstInstallTime` integer, nullable
      - `isPinOrFingerPrint` boolean, nullable

## Response `201`

Recurso criado com sucesso.

- DeviceResponseSuccessResponse
  - `data` DeviceResponse
    - `hash` string, nullable
    - `status` 'INACTIVE' | 'ENABLED' | 'DISABLED' | 'BLOCKED'
    - `createdAt` string, date-time
    - `updatedAt` string, date-time, nullable
    - `owner` Owner
      - `document` Document
        - `value` string, nullable
        - `type` 'CPF' | 'CNPJ'
    - `uniqueId` string, nullable
    - `type` string, nullable
    - `model` string, nullable
    - `brand` string, nullable
    - `totalMemory` integer
    - `pushToken` string, nullable
    - `details` DeviceDetails
      - `system` SystemDetails
        - `name` string, nullable
        - `version` string, nullable
        - `country` string, nullable
        - `locale` string, nullable
        - `buildNumber` string, nullable
        - `fontScale` number, double, nullable
      - `storage` Storage
        - `totalDiskCapacity` integer, nullable
        - `freeDiskStorage` integer, nullable
      - `connection` Connection
        - `carrier` string, nullable
        - `network` Network
          - `ipAddress` string, nullable
          - `macAddress` string, nullable
        - `isAirPlaneMode` boolean, nullable
      - `battery` Battery
        - `level` number, double, nullable
        - `isCharging` boolean, nullable
      - `firstInstallTime` integer, nullable
      - `isPinOrFingerPrint` boolean, nullable
  - `links` Link[], nullable
    - `url` string, nullable
    - `rel` string, nullable
    - `method` string, nullable
  - `meta` object, nullable

## Other responses

- `400`: Há algum problema com a sua requisição.
- `422`: A sintaxe da requisição está correta, mas não foi possível processá-la devido a uma regra de negócio.
- `500`: Ocorreu algum erro inexperado em nosso servidor.

---

[API](https://skmtc.dev/bankly/apis/id-one.md) - [All operations](https://skmtc.dev/bankly/apis/id-one/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/id-one/revisions/7cda227a76f4?raw)