> This is Payabli documentation. For a complete page index, fetch https://docs.payabli.com/llms.txt — append .md to any page URL for lightweight markdown. For section-level indexes, query parameters, and other AI-optimized access methods, see https://docs.payabli.com/ai-agents.md

# Documentation changes for November 16, 2026

As part of an ongoing effort to better align the documentation with the API, we've corrected the token requirements for payout subscription changes and the required fields on invoice line items. These changes affect the documentation only; the API already worked this way.

## Documented that payout subscription changes refuse temporary tokens

Requests to create, update, or delete a payout subscription refuse temporary API tokens. A request made with a temporary token returns HTTP `401` with response code `9001`, and Payabli doesn't create or change the subscription, vendor, or payment method. Organization API tokens, OAuth access tokens, and user sessions are accepted. This affects the following endpoints:

* [Create payout subscription](/developers/api-reference/payout-subscription/create-payout-subscription)
* [Update a payout subscription](/developers/api-reference/payout-subscription/update-payout-subscription)
* [Delete a payout subscription](/developers/api-reference/payout-subscription/delete-payout-subscription)

See [API tokens](/developers/api-tokens) to learn more.

## Corrected required fields on invoice line items

The docs said `itemMode` (integer) was required on invoice line items. It's optional, and the API has never required it. When you omit it, the invoice returns `itemMode` as `null`. We also clarified that `itemTotalAmount` (number) is required when a line item's `itemQty` and `itemCost` are greater than 0. If it's missing, 0, or less, invoice creation fails with `Invalid item data`. This affects the following endpoints:

* [Add invoice](/developers/api-reference/invoice/add-invoice)
* [Update invoice](/developers/api-reference/invoice/update-invoice)

See [Manage invoices with the API](/guides/pay-in-developer-invoices-manage) for an example.