Skip to content

Create credit ledger entry

POST
/teams/{teamId}/credits/entries

Create a new credit ledger entry (grant or adjustment). System admin only. This is an append-only operation.

teamId
required
string
object
entryType
required
string
Allowed values: grant adjustment
amountUsd
required

Amount in USD (positive = credits in, negative = credits out)

number
description
required
string
>= 1 characters
metadata
object
key
additional properties
nullable
idempotencyKey
string

Credit ledger entry created

object
teamCreditLedgerId
required
string
teamId
required
string
entryType
required
string
Allowed values: grant adjustment
amountNanodollars
required
number
amountUsd
required
number
description
required
string
metadata
required
object
key
additional properties
nullable
createdBy
required
string
nullable
createdAt
required
string format: date-time
idempotencyKey
required
string
nullable

Bad Request - Validation error or invalid input

object
error
required
string
code
string
details
nullable

Forbidden - Insufficient permissions

object
error
required
string
code
string
details
nullable

Not Found - Resource does not exist

object
error
required
string
code
string
details
nullable

Conflict - duplicate idempotency key

object
error
required
string
code
string
details
nullable