> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plaud.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bind Device

> Registers the device/owner association in the Plaud registry. Re-binding a device to the same owner is idempotent, so multiple calls will not have side effects.



## OpenAPI

````yaml /openapi/binding.json post /open/partner/sdk/bind
openapi: 3.0.4
info:
  title: Device Binding APIs
  description: >-
    APIs that track device state remotely. Binding a Plaud device involves two
    steps:

    1. **Cloud bind**: registers the device/owner association in the Plaud
    registry so you can track Connected Device state remotely

    2. **Local device bind**: triggered over BLE by the Embedded SDK, which
    verifies and generates the key pair on-device
  version: 0.0.1
servers:
  - url: https://platform-us.plaud.ai/developer/api
    description: US partner endpoint
  - url: https://platform-jp.plaud.ai/developer/api
    description: Japan partner endpoint
security:
  - bearerAuth: []
paths:
  /open/partner/sdk/bind:
    post:
      tags:
        - Device Binding API
      summary: Bind Device
      description: >-
        Registers the device/owner association in the Plaud registry. Re-binding
        a device to the same owner is idempotent, so multiple calls will not
        have side effects.
      operationId: bindDevice
      parameters:
        - $ref: '#/components/parameters/jsonContentType'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeviceRef'
            example:
              type: notepro
              sn: '8810000000000001'
      responses:
        '200':
          description: Device bound to the user of the supplied User Token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BindResponse'
              example:
                type: notepro
                sn: '8810000000000001'
                is_bind: true
        '403':
          description: >-
            The device is already bound to **another** account. That owner must
            unbind it before it can be bound here.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Unknown device — the serial number is not in the Plaud registry.
components:
  parameters:
    jsonContentType:
      in: header
      name: Content-Type
      schema:
        type: string
        default: application/json
      required: true
  schemas:
    DeviceRef:
      type: object
      required:
        - type
        - sn
      properties:
        type:
          type: string
          description: >-
            Device type string derived from the SN prefix (`881` → `notepro`,
            `882` → `notepins`).
          example: notepro
        sn:
          type: string
          description: Device serial number.
          example: '8810000000000001'
    BindResponse:
      type: object
      properties:
        type:
          type: string
          description: Device type string.
          example: notepro
        sn:
          type: string
          description: Device serial number.
          example: '8810000000000001'
        is_bind:
          type: boolean
          description: Remote binding state of the device after the call.
          example: true
    Error:
      type: object
      properties:
        code:
          type: integer
          description: Plaud error code.
          example: 403
        message:
          type: string
          description: Human-readable description of the error.
          example: device already bound to another account
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer authentication using a **User Token**. See the [Authentication
        API reference](/plaud-embedded/auth-api-overview) for how to mint one.

````