> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Memperbarui nama peran

> Panggil API ini untuk memperbarui nama peran di DingTalk. Peran dalam grup Default, seperti pemilik, supervisor, Super Admin, dan Sub Admin, tidak dapat diubah.

Panggil API ini untuk memperbarui nama peran. API ini tidak mengizinkan Anda mengubah peran dalam grup "Default", termasuk Penanggung jawab, Supervisor, Super Admin, dan Sub Admin.

## Permintaan

| **Informasi dasar**         |                                                                                         |
| --------------------------- | --------------------------------------------------------------------------------------- |
| URL HTTP                    | [https://oapi.dingtalk.io/role/update\_role](https://oapi.dingtalk.io/role/update_role) |
| Metode HTTP                 | POST                                                                                    |
| Tipe aplikasi yang didukung | appType-Aplikasi internal                                                               |
| Izin yang diperlukan        | permission-qyapi\_manage\_addresslist-Izin pengelolaan data Kontak                      |

### Parameter query

| Nama          | Tipe   | Wajib | Contoh   | Deskripsi                                                                                                                                                                           |
| ------------- | ------ | ----- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| access\_token | String | Ya    | 6d1bxxxx | Kredensial aplikasi yang digunakan untuk memanggil API ini. Dapatkan melalui API untuk memperoleh [access\_token dari aplikasi internal](/id/open/development/obtain-orgapp-token). |

### Isi permintaan

| Nama     | Tipe   | Wajib | Contoh                | Deskripsi                                                                                                                                                                                                                                                                          |
| -------- | ------ | ----- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| roleId   | Number | Ya    | 1560985325            | ID peran yang akan diperbarui. Anda dapat memperolehnya dengan memanggil API [Dapatkan daftar peran](/id/open/development/obtains-a-list-of-enterprise-roles).  Peran dalam grup "Default" tidak dapat diubah, termasuk: Penanggung jawab, Supervisor, Super Admin, dan Sub Admin. |
| roleName | String | Ya    | Apparel manufacturing | Nama peran yang baru.                                                                                                                                                                                                                                                              |

### Contoh permintaan

```curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://oapi.dingtalk.io/role/update_role" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=bb0d689c-e415-4fa5-b5d8-e16741e12b87' \
-d 'roleId=1' \
-d 'roleName=11'
```

Java

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.io/role/update_role");
OapiRoleUpdateRoleRequest req = new OapiRoleUpdateRoleRequest();
req.setRoleId(1560985325L);
req.setRoleName("Apparel manufacturing");
OapiRoleUpdateRoleResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());
```

Python

```python theme={"theme":{"light":"github-light","dark":"github-dark"}}
import dingtalk.api

req=dingtalk.api.OapiRoleUpdateRoleRequest("https://oapi.dingtalk.io/role/update_role")

req.roleId=1
req.roleName="11"
try:
  resp= req.getResponse(access_token)
  print(resp)
except Exception,e:
  print(e)
```

PHP

```php theme={"theme":{"light":"github-light","dark":"github-dark"}}
include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new OapiRoleUpdateRoleRequest;
$req->setRoleId("1");
$req->setRoleName("11");
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.io/role/update_role");
```

C#

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.io/role/update_role");
OapiRoleUpdateRoleRequest req = new OapiRoleUpdateRoleRequest();
req.RoleId = 1L;
req.RoleName = "11";
OapiRoleUpdateRoleResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);
```

## Respons

### Isi respons

| Nama    | Tipe   | Contoh | Deskripsi                         |
| ------- | ------ | ------ | --------------------------------- |
| errcode | Number | 0      | Kode yang dikembalikan.           |
| errmsg  | String | ok     | Deskripsi kode yang dikembalikan. |

### Contoh isi respons

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "errcode":0,
  "errmsg":"ok"
}
```

### Kode error

Jika terjadi error saat memanggil API ini, lihat dokumen [Kode error global](/id/open/development/server-api-error-codes-1) untuk menemukan solusi berdasarkan pesan error.

| Kode error (errcode) | Pesan error (errmsg)   | Solusi                               |
| -------------------- | ---------------------- | ------------------------------------ |
| 660000               | The parameter is empty | Lengkapi parameter yang belum diisi. |
| 33011                | Invalid roleId         | Periksa apakah roleId sudah benar.   |
| -1                   | The system is busy     | Coba lagi nanti.                     |