Create a new role as a copy of an existing one.

curl --request POST \
  --url https://app.assetinfinity.ai/api/rpc/clone_role \
  --header 'Content-Type: application/json' \
  --data '
{
  "p_role_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "p_description": "<string>",
  "p_name": "<string>"
}
'

import requests

url = "https://app.assetinfinity.ai/api/rpc/clone_role"

payload = {
    "p_role_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "p_description": "<string>",
    "p_name": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    p_role_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    p_description: '<string>',
    p_name: '<string>'
  })
};

fetch('https://app.assetinfinity.ai/api/rpc/clone_role', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.assetinfinity.ai/api/rpc/clone_role",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'p_role_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'p_description' => '<string>',
    'p_name' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.assetinfinity.ai/api/rpc/clone_role"

	payload := strings.NewReader("{\n  \"p_role_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"p_description\": \"<string>\",\n  \"p_name\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.assetinfinity.ai/api/rpc/clone_role")
  .header("Content-Type", "application/json")
  .body("{\n  \"p_role_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"p_description\": \"<string>\",\n  \"p_name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.assetinfinity.ai/api/rpc/clone_role")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"p_role_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"p_description\": \"<string>\",\n  \"p_name\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Admin

Create a new role as a copy of an existing one.

The copy carries the role’s settings, its permissions, the sites, departments, asset categories, statuses and asset statuses it covers, and which fields it may edit or is kept from seeing. It does not carry where the role is named elsewhere — status moves, approval steps, workflows, work order types, subscriptions and shares — and it is held by nobody: assign people to it afterwards.

The name defaults to the original’s with “(copy)” after it, and the description to the original’s. The copy is always active. A copy of the System Administrator is an ordinary role holding today’s permissions; it does not receive permissions added by later releases.

Requires admin.role.create. Everything is copied in one transaction, so if any part is refused nothing is created. Where creating a role needs approval, the copy is refused; where only its permissions or grants do, those are counted as held rather than applied.

Returns the new role’s id and how many permissions, scope grants and field rules were copied.

POST

rpc

clone_role

Create a new role as a copy of an existing one.

curl --request POST \
  --url https://app.assetinfinity.ai/api/rpc/clone_role \
  --header 'Content-Type: application/json' \
  --data '
{
  "p_role_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "p_description": "<string>",
  "p_name": "<string>"
}
'

import requests

url = "https://app.assetinfinity.ai/api/rpc/clone_role"

payload = {
    "p_role_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "p_description": "<string>",
    "p_name": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    p_role_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    p_description: '<string>',
    p_name: '<string>'
  })
};

fetch('https://app.assetinfinity.ai/api/rpc/clone_role', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.assetinfinity.ai/api/rpc/clone_role",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'p_role_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'p_description' => '<string>',
    'p_name' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.assetinfinity.ai/api/rpc/clone_role"

	payload := strings.NewReader("{\n  \"p_role_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"p_description\": \"<string>\",\n  \"p_name\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.assetinfinity.ai/api/rpc/clone_role")
  .header("Content-Type", "application/json")
  .body("{\n  \"p_role_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"p_description\": \"<string>\",\n  \"p_name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.assetinfinity.ai/api/rpc/clone_role")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"p_role_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"p_description\": \"<string>\",\n  \"p_name\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Headers

Prefer

enum<string>

Preference

Available options:

params=single-object

Body

Create a new role as a copy of an existing one.

The copy carries the role's settings, its permissions, the sites, departments, asset categories, statuses and asset statuses it covers, and which fields it may edit or is kept from seeing. It does not carry where the role is named elsewhere — status moves, approval steps, workflows, work order types, subscriptions and shares — and it is held by nobody: assign people to it afterwards.

The name defaults to the original's with "(copy)" after it, and the description to the original's. The copy is always active. A copy of the System Administrator is an ordinary role holding today's permissions; it does not receive permissions added by later releases.

Returns the new role's id and how many permissions, scope grants and field rules were copied.

p_role_id

string<uuid>

required

p_description

string<text>

p_name

string<text>

Response

200

Overview

Endpoints

Create a new role as a copy of an existing one.

Headers

Body

Response