---
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.

When the nonce from the authorization deep link is provided, the waiting Game Hub page
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 — 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-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-service-production.skmtc.workers.dev/v1/apis/aghanim/aghanim-server-to-server-api/revisions/d8b885323f9e/schema)