Set per-user usage limits
const url = 'https://api.pitch2sale.com/api/v1/usage/users/limits';const options = { method: 'PUT', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"enabled":true,"apply_to_all":{"call_minutes":1,"stt_minutes":1,"sms_segments":1,"translation_minutes":1,"ai_tokens":1},"users":[{"user_id":"example","limits":{"call_minutes":1,"stt_minutes":1,"sms_segments":1,"translation_minutes":1,"ai_tokens":1}}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://api.pitch2sale.com/api/v1/usage/users/limits \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "enabled": true, "apply_to_all": { "call_minutes": 1, "stt_minutes": 1, "sms_segments": 1, "translation_minutes": 1, "ai_tokens": 1 }, "users": [ { "user_id": "example", "limits": { "call_minutes": 1, "stt_minutes": 1, "sms_segments": 1, "translation_minutes": 1, "ai_tokens": 1 } } ] }'Body: enabled (the switch), apply_to_all (one set of limits written to every active person; AI employees are skipped) and users ([{ user_id, limits }]). limits keys: call_minutes, stt_minutes, sms_segments, translation_minutes, ai_tokens; a whole number sets the limit, null removes it, a key left out is not changed. Any other meter, a user outside the organization or a meter the plan does not allow limits on is a 400 and nothing is saved. A person at their limit gets 402 USER_USAGE_LIMIT; they are notified at 80% and 100%, once per period each. Returns the same body as GET /usage/users. Requires settings.edit.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
Examplegenerated
{ "enabled": true, "apply_to_all": { "call_minutes": 1, "stt_minutes": 1, "sms_segments": 1, "translation_minutes": 1, "ai_tokens": 1 }, "users": [ { "user_id": "example", "limits": { "call_minutes": 1, "stt_minutes": 1, "sms_segments": 1, "translation_minutes": 1, "ai_tokens": 1 } } ]}Responses
Section titled “Responses”OK
Validation failed
object
object
Examplegenerated
{ "error": "example", "code": "example", "message": "example", "details": [ { "field": "example", "message": "example", "code": "example" } ]}Authentication required or token invalid
object
object
Examplegenerated
{ "error": "example", "code": "example", "message": "example", "details": [ { "field": "example", "message": "example", "code": "example" } ]}Role permission or token scope missing; OAuth app tokens are not accepted on this route
object
object
Examplegenerated
{ "error": "example", "code": "example", "message": "example", "details": [ { "field": "example", "message": "example", "code": "example" } ]}Rate limit exceeded
object
object
Examplegenerated
{ "error": "example", "code": "example", "message": "example", "details": [ { "field": "example", "message": "example", "code": "example" } ]}