---
title: "Revert User To Free"
method: POST
path: "/api/v1/admin/test/users/{user_id}/revert-to-free"
tags: ["Admin - Test Users", "Admin - Test Users"]
---

# Revert User To Free

`POST /api/v1/admin/test/users/{user_id}/revert-to-free`

## Request

- Base URL: `https://api.gemstoneaiapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gemstoneaiapp.com/api/v1/admin/test/users/{user_id}/revert-to-free`
- Auth: none declared

Revert user to free plan for testing.

**Testing endpoint** - This will:
1. Find or create free plan
2. Cancel any existing active subscriptions
3. Create new active free subscription
4. Apply free plan limits

## Path parameters

- `user_id` integer, required

## Headers

- `x-admin-key` string, nullable

## Response `200`

Successful Response

- UpdateSubscriptionResponse
  - `success` boolean, required
  - `message` string, required
  - `user_id` integer, required
  - `plan_name` string, required
  - `subscription_status` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api.md) · [All operations](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gemstoneaiapp/apis/gemstoneai-api/revisions/fcb441f55161?raw)