---
title: "Renew Creator Credits Endpoint"
method: POST
path: "/api/v1/remy/cron/creator-credits/renew"
tags: ["remy"]
---

# Renew Creator Credits Endpoint

`POST /api/v1/remy/cron/creator-credits/renew`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/remy/cron/creator-credits/renew`
- Auth: API key in header `X-Internal-Api-Key`

Grant the next month of credits to every Recognized/Elite creator whose billing month has closed.

Meant for a daily GCP Cloud Scheduler hit — it picks up whoever is due rather than assuming a
fixed day, so each creator renews on the anniversary of the day they joined. Running it more
than once a day is harmless: a subscription is only due while its current_period_end is in
the past, and renewing pushes that a month forward.

A gap in the schedule does not compound. If the job is down for three months, the creator
gets one month's credits and their renewal date is moved to the next future anniversary —
credits are an allowance, not a balance that accrues.

`limit` is for a cautious first run in a new environment; leave it off in the schedule.

## Query parameters

- `limit` integer, nullable: Cap how many subscriptions this run touches

## Response `200`

Successful Response

- CreatorCreditRenewalResponseDTO: What one run of the monthly credit renewal did. The cron only needs the counts; the two detail lists are there so a run can be read back without opening the database.
  - `ran_at` string, required
  - `due` integer, required
  - `renewed` integer, required
  - `skipped` integer, required
  - `details` object[]
  - `skipped_details` object[]

## Other responses

- `422`: Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-09-11** `163530d84bc1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/remy/cron/creator-credits/renew/post.md)

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) - [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/fastapi/revisions/8e8c18c2dc35?raw)