Add support for the request_id param in Actor.charge() #1193

Problem

Multi-tenant Server Actors serve many callers from one run. To charge the caller, the Actor has to send a raw HTTP request to /charge with the X-Apify-Request-ID header, which bypasses the SDK's charging bookkeeping.

What we want

An optional request_id param in Actor.charge() that maps the charge to the caller's account. Parity with apify/apify-sdk-js#776.

Requirements

P0

• Actor.charge(event_name, count, request_id=...) sends X-Apify-Request-ID to /charge.
• Calls without request_id behave as today.
• Document request_id on the Pay per event concept page, with a multi-tenant Server Actor example.

Out of scope

• maxChargeUsd for Standby runs. It can come later as another header and another Actor.charge() param.

Links

• Add support for the requestId param in Actor.charge() apify-sdk-js#776
• Multi-tenant Standby docs (Notion)

Nice-to-have by November 16, 2026 (Server Actors launch), must-have by end of Q4.