---
title: "Reject Authorization"
method: POST
path: "/v1/users/authorize/reject"
tags: ["Users"]
---

# Reject Authorization

`POST /v1/users/authorize/reject`

Reject a game hub login attempt that cannot proceed and return a URL to show the error.

The waiting Game Hub page, identified by the nonce from the authorization deep link,
cancels its waiter and shows the error to the player, so the login flow ends instead of
hanging.

Opening the returned URL is optional: the game client may open it to show the error
itself, and the flow still resolves if it never does.

## Request body

- RejectAuthorizationRequest
  - `nonce` string, required — The nonce from the authorization deep link, used to notify the waiting hub session.
  - `reason` 'not_eligible' | 'banned' | 'rejected', required — Reason a game hub login cannot proceed. - `not_eligible`: the player has not unlocked hub access yet - `banned`: the player's game account is suspended - `rejected`: the game server declined the login for any other reason

## Response `200`

Successful Response

- RejectAuthorizationResponse
  - `error_url` string, uri, required — The game hub URL that shows the error to the player. Opening it is purely optional and the login is already rejected either way.

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-31** `b06feb9e1630` — 1 breaking
  - the request property `nonce` became required
- **2026-08-27** `d8b885323f9e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/changes/v1/users/authorize/reject/post.md)

---

[API](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api.md) · [All operations](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/revisions/6d6269f8cab6?raw)