> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autocalls.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Renew user plan

> Run the pending renewal of a plan you gave, right away

When the owner's balance cannot cover a plan's renewal, the renewal waits and is tried again every hour (see [Renewals](/api-reference/white-label/update-user-plan#renewals)). After you top up, this endpoint runs it right away. It is the **Renew now** button in the **Plan** action of your administration panel, shown while a renewal is pending.

It is the same renewal as the hourly one. With monthly minutes, the user is topped back up to the plan's minutes and gets its chat credits again, and the owner's balance pays for the minutes they used. With yearly minutes, this month's share comes from the prepaid 12 months, or, once they are over, what is left goes back and the next 12 months are taken. The next renewal is a month after this one.

<Note>
  This endpoint is available to the **account owner** (with an active plan) and to team members with **Billing Access**. Other users receive a 403 Forbidden error. Only users of your platform can be renewed: any other ID, including the owner account, returns 404.
</Note>

### Path Parameters

<ParamField path="id" type="integer" required>
  The ID of the user. Administrators can list user IDs with [Get platform users](/api-reference/white-label/get-users).
</ParamField>

### Response

<ResponseField name="message" type="string">
  `Plan renewed.`
</ResponseField>

<ResponseField name="data" type="object">
  The user's plan, as in [Get user plan](/api-reference/white-label/get-user-plan)
</ResponseField>

<ResponseExample>
  ```json 200 Plan Renewed theme={null}
  {
    "message": "Plan renewed.",
    "data": {
      "plan_id": 5,
      "name": "Starter",
      "source": "manual",
      "billing": "monthly",
      "included_minutes": 100,
      "included_credits": 0,
      "minutes_renew_at": "2026-11-03T09:12:05+00:00",
      "ends_at": null,
      "minutes": "monthly",
      "when_short": "wait",
      "renewal": {
        "status": "ok",
        "next_at": "2026-11-03T09:12:05+00:00",
        "missing_minutes": 0,
        "last_renewed_at": "2026-10-03T09:12:05+00:00",
        "prepaid_minutes": null,
        "prepaid_until": null
      }
    }
  }
  ```

  ```json 401 Unauthenticated theme={null}
  {
    "message": "Unauthenticated."
  }
  ```

  ```json 403 Not Administrator theme={null}
  {
    "message": "You are not an administrator."
  }
  ```

  ```json 403 No Billing Access theme={null}
  {
    "message": "You do not have access to these settings."
  }
  ```

  ```json 404 User Not Found theme={null}
  {
    "message": "User not found."
  }
  ```

  ```json 422 Insufficient Balance theme={null}
  {
    "message": "Not enough balance to renew this plan: 11.17 more minutes are needed."
  }
  ```

  ```json 422 Not Due Yet theme={null}
  {
    "message": "Nothing to renew yet: the next renewal is on Nov 2, 2026."
  }
  ```

  ```json 422 No Plan Given theme={null}
  {
    "message": "This user has no plan given by you."
  }
  ```

  ```json 422 Plan Without Minutes theme={null}
  {
    "message": "This plan has no minutes to renew."
  }
  ```

  ```json 422 Plan Ends Before Renewal theme={null}
  {
    "message": "This plan ends on Nov 2, 2026, before its next renewal."
  }
  ```

  ```json 429 Too Many Requests theme={null}
  {
    "message": "Too Many Attempts."
  }
  ```
</ResponseExample>

### Rate limit

The platform settings, default limits, user settings and plan endpoints share a limit of 60 requests per minute for each account. Above it they return `429`, and the `Retry-After` response header tells you how many seconds to wait.

### Example

```bash theme={null}
curl -X POST https://app.autocalls.ai/api/white-label/users/123/plan/renew \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.