Gifted credits

The Preview route accepts a legacy calls_amount field, but the transferred unit is credits. It can be spent at the selected operation's published credit price; it is not a Free monthly call.

{
  "recipient_email": "developer@example.com",
  "calls_amount": 5
}

The recipient signs in with the matching email and claims the gift code.

Claims reject missing, expired, previously claimed or wrong-recipient invitations. The same gift can be credited only once, including when claim requests overlap.

Gifted credits belong to the recipient's current active balance period and remain separate from prepaid credits. No customer-facing send or claim interface is currently shipped.

Send a gift

const response = await fetch('/api/clawdbase/gifts', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${session.access_token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    recipient_email: 'developer@example.com',
    calls_amount: 5,
  }),
})

The Preview route accepts 1–100 credits through the legacy field name. A successful 201 response contains a gift code and expiration. Do not put the sender's session or credentials into an invitation URL.

Claim a gift

{
  "gift_code": "gift-code-from-invitation"
}

The authenticated recipient email must exactly match the normalized invitation recipient. Missing gifts return 404, another recipient returns 403, previously claimed gifts return 409, and expired gifts return 410.

Availability and accounting

Only eligible paid included credits can be transferred. Free monthly calls and prepaid credits are not giftable. A claim is applied once, and an expired unclaimed invitation releases its reservation. Gifted credits are consumed before included and prepaid credits.

Presentation

Any future customer UI must show recipient, credit amount, expiry and state without exposing unrelated account details. This describes the intended Preview presentation; it is not a claim that the UI is currently available.

Product boundary

Gift invitations transfer eligible Clawdbase operation credits, not money, prepaid packs, Page ownership or Access Keys.