/ Docs
APIWallet

Allocate

Move EUR from the wallet into the org's OpenRouter key limit. Owner only.

POST
/v1/orgs/{org_id}/wallet/allocate

Authorization

BearerAuth
AuthorizationBearer <token>

Botyard API key — see /docs/authentication.

In: header

Path Parameters

org_id*Org Id

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Allocate EUR from the wallet to the org's OpenRouter key limit.

Response Body

application/json

curl -X POST "https://example.com/v1/orgs/string/wallet/allocate" \  -H "Content-Type: application/json" \  -d '{    "amount_eur": 1,    "idempotency_key": "string"  }'
{
  "balance_eur": "string"
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "error_code": "string",
  "errors": [
    {
      "pointer": "string",
      "detail": "string",
      "type": "string"
    }
  ],
  "trace_id": "string"
}

Topup Checkout

Open a pay-what-you-want Polar checkout that funds the wallet. Owner only. Returns a hosted checkout URL; the resulting ``order.paid`` webhook credits the wallet. 503 when billing or the top-up product isn't provisioned.

Upload Task Files

Request presigned upload URLs for task files. Creates file metadata rows immediately. Client uploads directly to S3. When ``allow_overwrite`` is false (default), rejects uploads if a file with the same filename already exists. Set to true for re-uploading edited text file content.