Grant quota directly

POST /api/v1/users/{id}/add-traffic prm_users_add_traffic

Adds bytes and/or seconds to the subscriber's remaining period quota without pricing or charging anything, and drops the hot-path quota cache so the grant applies on the next RADIUS request.

request_id is accepted here for your own tracing but is not enforced, because adding traffic is not naturally idempotent. Two calls add twice. Do not build a retry loop on this endpoint the way you would on deposit.

At a glance

Authentication: Staff token or session
Requires permission: prm_users_add_traffic Add traffic
Rate limit: t_mutate

Parameters

Parameter	Description
`id`required path · integer	Subscriber id.
`bytes` body · integer	Bytes to add. At least one of bytes or seconds must be present and positive.
`seconds` body · integer	Seconds to add.

Errors

Code	When it is returned
`ERR_VALIDATION`400	a negative value, or neither bytes nor seconds supplied
`ERR_NOT_FOUND`404	no such subscriber

Request

curl -X POST "$BASE/api/v1/users/{id}/add-traffic" \
  -H "Authorization: Bearer $XR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "bytes": 10737418240,
  "request_id": "7c2a0e91-6d44-4f9b-a1b7-0c5d3e8f2a10"
}'

BASE is your tenant host: the same address you sign in on.

Try it on your own network.

50 subscribers for 7 days. You pay nothing.

Try it free Talk to us