curl --request PUT \
--url https://api.deepl.com/v2/admin/developer-keys/limits \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"key_id": "ca7d5694-96eb-4263-a9a4-7f7e4211529e:20c2abcf-4c3c-4cd6-8ae8-8bd2a7d4da38"
}
'{
"key_id": "ca7d5694-96eb-4263-a9a4-7f7e4211529e:20c2abcf-4c3c-4cd6-8ae8-8bd2a7d4da38",
"label": "developer key prod",
"creation_time": "2025-07-08T08:15:29.362Z",
"deactivated_time": "2025-07-09T08:15:29.362Z",
"is_deactivated": true,
"usage_limits": {
"characters": 5000,
"speech_to_text_milliseconds": 3600000,
"speech_to_speech_milliseconds": 3600000
}
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}Set developer key limits
Set or update the usage limit on an individual DeepL API key as an admin.
curl --request PUT \
--url https://api.deepl.com/v2/admin/developer-keys/limits \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"key_id": "ca7d5694-96eb-4263-a9a4-7f7e4211529e:20c2abcf-4c3c-4cd6-8ae8-8bd2a7d4da38"
}
'{
"key_id": "ca7d5694-96eb-4263-a9a4-7f7e4211529e:20c2abcf-4c3c-4cd6-8ae8-8bd2a7d4da38",
"label": "developer key prod",
"creation_time": "2025-07-08T08:15:29.362Z",
"deactivated_time": "2025-07-09T08:15:29.362Z",
"is_deactivated": true,
"usage_limits": {
"characters": 5000,
"speech_to_text_milliseconds": 3600000,
"speech_to_speech_milliseconds": 3600000
}
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}{
"message": "<string>",
"code": "invalid_content_type"
}Authorizations
Body
Restricts the number of total characters (across text translation, document translation, and text improvement) that can be consumed by an API key in a one-month usage period.
Setting the limit to 0 means the API key will not be able to consume characters.
Setting the limit to null disables the limit, effectively allowing unlimited usage.
5000
Restricts the number of milliseconds of speech-to-text that can be consumed by an API key in a one-month usage period.
Setting the limit to 0 means the API key will not be able to consume speech-to-text milliseconds.
Setting the limit to null disables the limit, effectively allowing unlimited usage.
3600000
Restricts the number of milliseconds of speech-to-speech that can be consumed by an API key in a one-month usage period.
Setting the limit to 0 means the API key will not be able to consume speech-to-speech milliseconds.
Setting the limit to null disables the limit, effectively allowing unlimited usage.
3600000
Response
The set usage limits function returns a JSON representation of the modified API key.
The API key.