Atjaunināt lomu
Katrs lauks nav obligāts, un `permissions` aizstāj visu sarakstu.
Izpilda īstu izsaukumu pret jūsu darbvietu, ar jūsu paša atslēgu.
PATCH /roles/{id}
Katrs lauks nav obligāts, un permissions aizstāj visu sarakstu.
Piemērs
Nepieciešams roles:write. Izlaists lauks paliek neaiztikts — tieši to PATCH arī nozīmē.
curl -X PATCH "$OE/roles/role_2b81de079c1f0a4b7e05d386" -H "$AUTH" \ -H "Content-Type: application/json" \ -d '{ "permissions": ["emails:read", "threads:read", "labels:read", "contacts:read"] }'{ "object": "role", "id": "role_2b81de079c1f0a4b7e05d386", "name": "Support", "description": "Answers the shared inboxes and nothing else.", "permissions": ["emails:read", "threads:read", "labels:read", "contacts:read"], "builtin": null, "editable": true, "deletable": true, "members": 3, "apiKeys": 1, "createdAt": "2026-08-30T10:41:02.000Z", "updatedAt": "2026-08-30T13:02:19.000Z"}permissions AIZSTĀJ visu sarakstu. Izsaukuma, kas piešķir vienu atļauju, nav un nebūs: auditē tieši sarakstu, un pa indeksiem adresēta labošana ir zudis atjauninājums brīdī, kad atvērtas divas cilnes. Izlasiet lomu, izmainiet to ierakstu, ko domājāt, un nosūtiet atpakaļ visus. Vienas atļaujas nosūtīšana atļauju nepievieno. Tā atstāj lomu ar tieši šo vienu atļauju plus visu, ko tā ietver.
description ir gan nullable, gan neobligāts, un šī atšķirība ir visa labošanas jēga: tā izlaišana saglabā glabāto teikumu, bet null nosūtīšana to notīra. Bez nullable apraksta noņemšanai nebūtu cita ceļa kā aizstāt to ar atstarpi.
Īpašnieks ir vienīgā loma, kurai PATCH tiek atteikts, un tam tiek atteikts katrs lauks: role_immutable, 409 ar param: "roleId". Visas pārējās pieņem jaunu nosaukumu tikpat viegli kā jaunu atļauju sarakstu, ieskaitot sākotnēji izveidotās. builtin reģistrē, no kurienes loma nākusi, nevis to, ko ar to drīkst darīt. Nosaukums, kas jau ir citai lomai, dod role_name_taken, 409 ar param: "name".
Labojums stājas spēkā ar NĀKAMO pieprasījumu, ko veic jebkurš lomas turētājs, ieskaitot API atslēgas, jo griesti tiek izrēķināti katram pieprasījumam, nevis kešoti. Lomas sašaurināšana tādējādi ir tūlītēja atsaukšana, kas stājas spēkā bez zem tās esošo atslēgu rotācijas. Paplašināšana arī ir tūlītēja, un tā ir tā puse, ko ir vērts atcerēties.