---
title: "Buy one unit pack with a Stripe shared payment token: 500 units for $10.00, paid once."
method: POST
path: "/api/agents/units"
tags: ["Account"]
---

# Buy one unit pack with a Stripe shared payment token: 500 units for $10.00, paid once.

`POST /api/agents/units`

## Request

- Base URL: `https://tomorrowlives.com`
- URL: `https://tomorrowlives.com/api/agents/units`
- Auth: HTTP bearer

More units: 500 for $10.00 a pack, spent after the included units and kept until used. Only while a pass or a card plan runs; the free plan is refused with 402 pass_required. Pack units are spent after the period's included units, Lab units included, and never expire while the account exists; GET /api/agents/usage shows what is left under unit_packs. One token pays one pack, once (409 payment_token_used otherwise). Not refunded except where the law requires.

## Request body

- object
  - `payment_token` string, required
  - `terms_version` '2026-10-12.5', required
  - `operator_country` string

## Response `201`

Bought: the purchase and the account's plan

- object

## Other responses

- `400`: The input is not valid
- `401`: No valid API key
- `402`: A pass or a payment is needed: a queued render on the free plan, a unit pack on the free plan (pass_required), a card plan's past-due renewal, or, on the free plan, an owner who has not confirmed their email yet (owner_unconfirmed; a pass needs no confirmation); or a payment did not go through (payment_failed, payment_token_unusable), and nothing was charged
- `403`: The account is suspended, the paying card is not from the United States (region_not_supported), or the address named as its owner said it is not theirs and costed runs are paused until a new owner is named (owner_removed)
- `409`: The request conflicts with the account's state
- `503`: Payment cannot be taken right now. Nothing was charged; try again after Retry-After.

---

[API](https://skmtc.dev/tomorrowlives/apis/tomorrow-lives-engines.md) · [All operations](https://skmtc.dev/tomorrowlives/apis/tomorrow-lives-engines/llms.txt) · [OpenAPI document](https://skmtc.dev/tomorrowlives/apis/tomorrow-lives-engines/revisions/afc3d67322ac?raw)