Create a configuration
POST/agent/configs
own: receive payments on your own address (address required). generated: we issue a dedicated address (omit address); payments to it are added to your balance, and it can be paused but never deleted. Requires the program enabled (403 program_disabled) and the activation balance (422 below_min_balance). Limits come from GET /agent/summary: max_units from 1 to max_units_cap; energy_per_unit at least energy_min and energy_per_unit × max_units at most energy_max. base_payment_sun must be a multiple of 1,000 SUN and at least cost_max_sun from GET /agent/quote?energy=<energy_per_unit>. Unknown fields are a 422.
Request
Responses
- 201
- 403
- 409
- 422
- 503
Successful Response
program_disabled: the program is not accepting changes right now.
address_taken: the address already belongs to an active configuration.
Request validation error (a detail array) or a business refusal.
service_unavailable: prices are temporarily unavailable; retry later.