---
search:
  tags:
    - Operations
    - POST
seo:
  description: >-
    Returns a device_code (agent-private) and a user_code (CHRM-XXXXXX,
    displayed to the… Reference for the POST /api/pair/start endpoint in the
    Charming API API.
sidebar:
  badge: POST
  label: Mint a device_code for an unauthenticated agent (RFC 8628-shaped)
title: Mint a device_code for an unauthenticated agent (RFC 8628-shaped)
type: openapi-operation
---
Returns a `device_code` (agent-private) and a `user_code` (`CHRM-XXXXXX`, displayed to the user). Codes expire after 10 minutes. Agent then polls `POST /api/pair/poll` until status flips to `approved`. The legacy `/pair/start` path 308s here.

<Operation source="reference" id="start-pairing" />

Found a bug or need a feature? [Tell us](/docs/capabilities/feedback) with `submit_feedback` or `POST /app/{id}/feedback`. Your feedback shapes what we build next.