@PUT @ApiIgnore // until documented
  @Path("{permissionId}")
  @Produces("text/plain")
  public Response updatePermission(String body, @Context HttpHeaders headers, @Context UriInfo ui,
                             @PathParam("permissionId") String permissionId) {

    return handleRequest(headers, body, ui, Request.Type.PUT, createPermissionResource(permissionId));
  }
Handles: PUT /permissions/{permissionID}
Update a specific permission.

@param headers   http headers
@param ui        uri info
@param permissionId  permission id

@return information regarding the updated permission
ambari-server/src/main/java/org/apache/ambari/server/api/services/PermissionService.java