---
title: "Buy credit for the workspace wallet with your own saved card [write, owner or admin]"
method: POST
path: "/universes/{slug}/wallet/topups"
---

# Buy credit for the workspace wallet with your own saved card \[write, owner or admin\]

`POST /universes/{slug}/wallet/topups`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/universes/{slug}/wallet/topups`
- Auth: HTTP bearer

Charges the caller's own saved card the credit plus the card processing fee and adds the credit to the workspace wallet. The caller's own balance, card and auto top-up are not changed. amount is 1000, 2000, 5000 or 10000 cents. request_id makes a repeat of the same request charge once (200 instead of 201). 409 card_required when the caller has no saved card (add one to your own account first), 402 card_declined, 409 workspace_wallet_missing before the wallet exists, 503 payments_unavailable where card payments are not set up. A workspace key or a restricted credential cannot buy credit.

## Path parameters

- `slug` string, required

## Request body

- object
  - `amount` object, required
    - `amount` string, required: Whole US cents
    - `currency` 'USD', required
  - `request_id` string, required

## Response `201`

Bought

- object
  - `charged` boolean
  - `balance` object
    - `amount` string, required: Whole US cents
    - `currency` 'USD', required

## Other responses

- `default`: Error — { error: { code, message, request_id } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/universes/:slug/wallet/topups/post.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/0d435187cd55?raw)