---
title: "Confirm a SERVER link token (user must be authenticated)"
method: POST
path: "/api/platform-linking/tokens/{token}/confirm"
tags: ["platform-linking"]
---

# Confirm a SERVER link token (user must be authenticated)

`POST /api/platform-linking/tokens/{token}/confirm`

## Path parameters

- `token` string, required

## Request body

- ConfirmLinkRequest — Optional confirm payload. ``telegram_auth`` carries the signed identity Telegram appends when the user reached this page via a login_url button — when present it must verify, and the link token must belong to that same Telegram user.
  - `telegram_auth` object, nullable

## Response `200`

Successful Response

- ConfirmLinkResponse
  - `success` boolean, required
  - `link_type` 'SERVER' | 'USER'
  - `platform` string, required
  - `platform_server_id` string, required
  - `server_name` string, nullable, required
  - `return_url` string, nullable

## Other responses

- `401` — Authentication required
- `422` — Validation Error

## Changes

- **2026-08-12** `ad967de8dccc` — 1 info
  - added the optional property `return_url` to the response with the `200` status
- **2026-07-14** `44f4e8b5356c` — 1 info
  - added optional request body
- **2026-04-30** `8c84efcb3afb` — 1 breaking
  - removed the request body

[Change history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/platform-linking/tokens/:token/confirm/post.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/5f27fa9d6c03?raw)