Get Role - Confidence Documentation

GET

/

v1

/

roles

/

{role}

Get Role

curl --request GET \
  --url https://iam.eu.confidence.dev/v1/roles/{role} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://iam.eu.confidence.dev/v1/roles/{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://iam.eu.confidence.dev/v1/roles/{role}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://iam.eu.confidence.dev/v1/roles/{role}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://iam.eu.confidence.dev/v1/roles/{role}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "displayName": "<string>",
  "permissions": [
    {
      "category": "CATEGORY_UNSPECIFIED",
      "type": "TYPE_UNSPECIFIED",
      "description": "<string>"
    }
  ],
  "creator": "<string>",
  "updater": "<string>",
  "createTime": {},
  "updateTime": {},
  "name": "<string>",
  "builtin": true,
  "labels": [
    {}
  ],
  "owner": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

role

string

required

Response

200 - application/json

Returns a Role.

A role is a named set of permissions, like Admin or Flag Editor.

displayName

string

required

Human friendly name of the role.

permissions

object[]

required

List of permissions that this role has, needs to have at least one.

Show child attributes

creator

string

required

Reference to the identity that created this OAuthApp.

updater

string

required

Reference to the identity that last updated this OAuthApp.

createTime

object

required

Time when the role was first created.

updateTime

object

required

Time when the role was last updated.

name

string

Name of the role on the form roles/{"<"}id{">"}.

builtin

boolean

If this role is automatically built in or not

labels

object[]

General labels for this resource.

Show child attributes

owner

string

The owner of the resource. If not set will default to the creator.

⌘I

Get Role

curl --request GET \
  --url https://iam.eu.confidence.dev/v1/roles/{role} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://iam.eu.confidence.dev/v1/roles/{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://iam.eu.confidence.dev/v1/roles/{role}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://iam.eu.confidence.dev/v1/roles/{role}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://iam.eu.confidence.dev/v1/roles/{role}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "displayName": "<string>",
  "permissions": [
    {
      "category": "CATEGORY_UNSPECIFIED",
      "type": "TYPE_UNSPECIFIED",
      "description": "<string>"
    }
  ],
  "creator": "<string>",
  "updater": "<string>",
  "createTime": {},
  "updateTime": {},
  "name": "<string>",
  "builtin": true,
  "labels": [
    {}
  ],
  "owner": "<string>"
}