---
title: "Authenticate User"
method: POST
path: "/v1/users/authenticate"
tags: ["Users"]
---

# Authenticate User

`POST /v1/users/authenticate`

Authenticate a user using a one-time token. Game Hub generates and sends this token
to the game client to process the user's authentication flow with the game server.

The token is valid for a single use and expires after a short period.

## Request body

- AuthenticateRequest
  - `token` string, required — The token to authenticate the user.

## Response `200`

Successful Response

- UserRead
  - `id` string, required — The unique identifier of the user.
  - `name` string — The name of the user.
  - `avatar_url` string — The avatar URL of the user.
  - `player_id` string — The unique player ID of the user. If the user is not linked to a player, this field will be null.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/aghanim/apis/aghanim-server-to-server-api.md) · [All operations](https://skmtc.net/aghanim/apis/aghanim-server-to-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aghanim/aghanim-server-to-server-api/versions/f8569ba0d776/schema)