---
title: "Attach the exchanged grant with the confirmation from the provider callback"
method: POST
path: "/api/plugin_connection_attempts/{id}/confirmation"
tags: ["Provider authorization"]
---

# Attach the exchanged grant with the confirmation from the provider callback

`POST /api/plugin_connection_attempts/{id}/confirmation`

## Request

- Base URL: `https://trmnl.com`
- URL: `https://trmnl.com/api/plugin_connection_attempts/{id}/confirmation`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `confirmation` string, required

## Response `200`

Connected; the callback confirmation works once and only for the user who started the attempt

- object
  - `data` PluginConnectionAttempt
    - `id` string, uuid, required
    - `state` 'pending' | 'exchanging' | 'exchanged' | 'connected' | 'denied' | 'failed' | 'expired' | 'cancelled', required
    - `expires_at` string, date-time, required
    - `connection_id` string, required
    - `launch_url` string, uri
    - `target` object, required
      - `kind` 'instance' | 'installation', required
      - `id` union, required
        - integer
        - string, uuid

---

[API](https://skmtc.dev/trmnl/apis/trmnl-api.md) · [All operations](https://skmtc.dev/trmnl/apis/trmnl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trmnl/apis/trmnl-api/revisions/66179e6d663b?raw)