---
title: "Link Discord and Minecraft Accounts"
method: POST
path: "/discord/user/link"
tags: ["Discord", "User Linking"]
---

# Link Discord and Minecraft Accounts

`POST /discord/user/link`

Links a Discord user's snowflake ID to a Minecraft UUID. Supports setting a primary account and updates existing links.

## Request body

- SprintDiscordMinecraftLink
  - `id` string
  - `is_primary` boolean
  - `snowflake` string

## Response `200`

Successfully linked/updated accounts

- SprintDiscordMinecraftLink
  - `id` string
  - `is_primary` boolean
  - `snowflake` string

## Other responses

- `400` — Bad request, e.g., invalid Minecraft UUID or invalid request body
- `401` — Unauthorized, not enough permissions
- `500` — Internal server error during database operations or external API calls

---

[API](https://skmtc.dev/seraph/apis/seraph-api.md) · [All operations](https://skmtc.dev/seraph/apis/seraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/seraph/seraph-api/revisions/82a1ec01c64d/schema)