Rename a developer key as an admin
curl --request PUT \
--url https://api.deepl.com/v2/admin/developer-keys/label \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"key_id": "ca7d5694-96eb-4263-a9a4-7f7e4211529e:20c2abcf-4c3c-4cd6-8ae8-8bd2a7d4da38",
"label": "developer key prod"
}
'{
"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"
}Managing Developer Keys
Rename a developer key
Change the label on an existing DeepL API key as an admin, using the Admin API.
PUT
/
v2
/
admin
/
developer-keys
/
label
Rename a developer key as an admin
curl --request PUT \
--url https://api.deepl.com/v2/admin/developer-keys/label \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"key_id": "ca7d5694-96eb-4263-a9a4-7f7e4211529e:20c2abcf-4c3c-4cd6-8ae8-8bd2a7d4da38",
"label": "developer key prod"
}
'{
"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
application/json
Response
The set label function returns a JSON representation of the renamed API key.
The API key.