---
title: "Set the concurrent-call limit"
method: PUT
path: "/users/me/limits"
tags: ["calls"]
---

# Set the concurrent-call limit

`PUT /users/me/limits`

## Request

- Base URL: `https://api.voygr.tech`
- URL: `https://api.voygr.tech/users/me/limits`
- Auth: API key in header `X-API-Key`

Raise (or lower) how many calls this key may have in flight at once. A call over the limit is not refused: it is accepted and waits in the queue (status queued) until one of your calls ends. Read your ceiling from max_concurrent_calls_ceiling on GET /users/me, then PUT a value up to it. A value above the ceiling is refused with 403 (nothing is changed). A new key starts at 1, so raise it here when you need parallel dialing.

## Request body

- SetLimitsRequest: Body for PUT /users/me/limits. Raise (or lower) the number of calls this key may have in flight at once.
  - `max_concurrent_calls` integer, required: How many calls this key may have in flight simultaneously (scheduled / dialing / in_progress count as in-flight). Required, with no default. Must be at least 1, and no more than the admin-set ceiling on the key (max_concurrent_calls_ceiling on GET /users/me). A higher value is refused with 403.

## Response `200`

The new limit, echoed with the ceiling it was checked against.

- LimitsResponse: PUT /users/me/limits success body: the new in-flight cap and the admin ceiling it was checked against.
  - `max_concurrent_calls` integer, required: The value now in effect for this key.
  - `max_concurrent_calls_ceiling` integer: Admin-set upper bound for this key. max_concurrent_calls can never exceed it.

## Other responses

- `401`: Missing or invalid X-API-Key.
- `403`: Requested value exceeds the admin-set ceiling on this key. Nothing was changed.
- `422`: Body failed validation (e.g. max_concurrent_calls below 1, or above the service hard maximum).

## Changes

- **2026-10-30** `7199881ed19e`: 1 breaking, 1 warning, 1 info
  - the response property `max_concurrent_calls_ceiling` became optional for the status `200`
  - the `max_concurrent_calls` request property's max was set to `100.00`
  - the `max_concurrent_calls_ceiling` response's property default value `100` was added for the status `200`
- **2026-09-14** `106e2c3d326d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/voygr/apis/voygr-calls-api/changes/users/me/limits/put.md)

---

[API](https://skmtc.dev/voygr/apis/voygr-calls-api.md) - [All operations](https://skmtc.dev/voygr/apis/voygr-calls-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voygr/apis/voygr-calls-api/revisions/7199881ed19e?raw)