---
title: "Issue a compatibility credit batch for a managed runtime"
method: POST
path: "/v1/credits/refresh"
tags: ["credits"]
---

# Issue a compatibility credit batch for a managed runtime

`POST /v1/credits/refresh`

## Request

- Base URL: `https://api.sqai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sqai.com/v1/credits/refresh`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Compatibility endpoint for quota-governed managed runtimes. Algenta editions are unmetered and do not need execution credits; non-Algenta plans can return HTTP 429.

## Request body

- CreditRefreshRequest
  - `device_id` string, required
  - `billing_period` string, required
  - `credits_used` integer

## Response `200`

Successful Response

- CreditRefreshResponse
  - `credits_granted` integer, required
  - `credits_issued_this_month` integer, required
  - `monthly_limit` integer, required
  - `monthly_remaining` integer, required
  - `billing_period` string, required
  - `expires_at` number, required
  - `refresh_after` number, required
  - `server_time` number, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sqai/apis/algenta-control-plane.md) · [All operations](https://skmtc.dev/sqai/apis/algenta-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/sqai/apis/algenta-control-plane/revisions/f30391a81130?raw)