---
title: "Topup Child Workspace"
method: POST
path: "/api/v1/workspaces/{workspace_id}/credits"
tags: ["Workspaces"]
---

# Topup Child Workspace

`POST /api/v1/workspaces/{workspace_id}/credits`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/v1/workspaces/{workspace_id}/credits`
- Auth: none declared

Top up a customer workspace's balance. Returns 404 if not yours, 403 if suspended, 409 if parent has insufficient balance.

Requires Idempotency-Key header for retry safety.
amount_usd is parsed as a decimal and converted to microdollars (1 USD = 1,000,000 microdollars).
Non-positive or non-integral microdollars are rejected with 422.

## Path parameters

- `workspace_id` integer, required

## Headers

- `Idempotency-Key` string, nullable

## Request body

- TopupRequest: Request to top up a customer workspace's balance.
  - `amount_usd` string, required: Amount in USD as decimal string, e.g. '10.50'

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)