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

# Confirm quick link passkey

> The complete HTTP body is limited to 1048576 UTF-8 bytes before JSON parsing.



## OpenAPI

````yaml api-reference/features/integrations.json POST /quicklink/{token}/passkey/confirmation
openapi: 3.0.3
info:
  title: Integrations API methods
  version: 1.0.0
  description: >-
    Task-focused integrations methods across supported Polymorfa connection
    types.
servers: []
security: []
paths:
  /quicklink/{token}/passkey/confirmation:
    post:
      tags:
        - Quicklink
      summary: Confirm quick link passkey
      description: >-
        The complete HTTP body is limited to 1048576 UTF-8 bytes before JSON
        parsing.
      operationId: nativeConfirmQuickLinkPasskey
      parameters:
        - schema:
            type: string
            description: Opaque QuickLink token from the hosted URL.
          required: true
          name: token
          in: path
          description: Opaque token required by the target operation.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                ticketId:
                  type: string
                  minLength: 1
                  description: |-
                    Identifier for the ticket.

                    <!-- polymorfa-input-table -->
                    **Value constraints**
                    | Constraint | Accepted input |
                    | --- | --- |
                    | String length | At least `1` characters |
                code:
                  type: string
                  pattern: ^[A-Z0-9]{4}-[A-Z0-9]{4}$
                  description: |-
                    Stable machine-readable code for this result.

                    <!-- polymorfa-input-table -->
                    **Value constraints**
                    | Constraint | Accepted input |
                    | --- | --- |
                    | Pattern | `^[A-Z0-9]{4}-[A-Z0-9]{4}$` |
                browserContext:
                  type: string
                  pattern: ^[A-Za-z0-9_-]{43}$
                  description: >-
                    The same in-memory browser context used to submit this
                    assertion. Required even for skip-handoff and completed
                    retries.


                    <!-- polymorfa-input-table -->

                    **Value constraints**

                    | Constraint | Accepted input |

                    | --- | --- |

                    | Pattern | `^[A-Za-z0-9_-]{43}$` |
              required:
                - ticketId
                - browserContext
              additionalProperties: false
      responses:
        '200':
          description: Current passkey state; pairing may still be pending
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - none
                          - challenge_pending
                          - assertion_sending
                          - assertion_submitted
                          - code_available
                          - confirmation_sending
                          - waiting_for_pairing
                          - completed
                          - failed
                        description: |-
                          Current status of this resource or operation.

                          <!-- polymorfa-input-table -->
                          **Allowed values**
                          | Value | Meaning |
                          | --- | --- |
                          | `none` | None. |
                          | `challenge_pending` | Challenge pending. |
                          | `assertion_sending` | Assertion sending. |
                          | `assertion_submitted` | Assertion submitted. |
                          | `code_available` | Code available. |
                          | `confirmation_sending` | Confirmation sending. |
                          | `waiting_for_pairing` | Waiting for pairing. |
                          | `completed` | Completed. |
                          | `failed` | Failed. |
                      ticketId:
                        type: string
                        description: Identifier for the ticket.
                      code:
                        type: string
                        description: Stable machine-readable code for this result.
                      skipHandoffUX:
                        type: boolean
                        description: Whether skip handoff ux.
                      error:
                        type: string
                        description: Error details returned when the operation fails.
                    required:
                      - status
                    description: Structured data carried by this object.
                required:
                  - data
        '400':
          description: QuickLink request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
        '403':
          description: QuickLink request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
        '404':
          description: QuickLink request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
        '409':
          description: Confirmation is unavailable for this attempt
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
        '413':
          description: Passkey request body exceeds 1048576 bytes
        '422':
          description: QuickLink request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
        '429':
          description: QuickLink request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
        '500':
          description: QuickLink request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
        '503':
          description: >-
            Confirmation is temporarily unavailable or its request deadline was
            exhausted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
      security: []
      servers:
        - url: https://api.polymorfa.com
components:
  schemas:
    native__PublicQuickLinkError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Stable machine-readable code for this result.
            message:
              type: string
              description: Human-readable message associated with this result.
          required:
            - code
            - message
          description: Error details returned when the operation fails.
        data:
          type: object
          properties:
            candidates:
              type: array
              items:
                type: object
                properties:
                  phone:
                    type: string
                    description: Phone number in international format.
                  whatsappPhone:
                    type: string
                    description: Specifies whatsapp phone for this candidate.
                  registered:
                    type: boolean
                    nullable: true
                    description: >-
                      Whether WhatsApp registration was confirmed. Null means
                      the result is unknown.


                      <!-- polymorfa-input-table -->

                      **Accepted alternatives**

                      | Alternative | Accepted input |

                      | --- | --- |

                      | Alternative 1 | Type: `boolean` |

                      | Alternative 2 | `null` |
                  pushName:
                    type: string
                    nullable: true
                    description: |-
                      WhatsApp display name reported by the sender's client.

                      <!-- polymorfa-input-table -->
                      **Accepted alternatives**
                      | Alternative | Accepted input |
                      | --- | --- |
                      | Alternative 1 | Type: `string` |
                      | Alternative 2 | `null` |
                  pictureUrl:
                    type: string
                    nullable: true
                    description: |-
                      URL for the picture.

                      <!-- polymorfa-input-table -->
                      **Accepted alternatives**
                      | Alternative | Accepted input |
                      | --- | --- |
                      | Alternative 1 | Type: `string` |
                      | Alternative 2 | `null` |
                  accountType:
                    type: string
                    enum:
                      - whatsapp
                      - business_app
                      - cloud_api
                      - coexistence
                      - unknown
                      - unregistered
                    description: |-
                      Category assigned to account.

                      <!-- polymorfa-input-table -->
                      **Allowed values**
                      | Value | Meaning |
                      | --- | --- |
                      | `whatsapp` | Whatsapp. |
                      | `business_app` | Business app. |
                      | `cloud_api` | Cloud api. |
                      | `coexistence` | Coexistence. |
                      | `unknown` | Unknown. |
                      | `unregistered` | Unregistered. |
                required:
                  - phone
                  - registered
                  - pushName
                  - pictureUrl
              description: Candidates associated with this data.
          required:
            - candidates
          description: Structured data carried by this object.
      required:
        - error

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.