curl --request GET \
--url https://devx.{environment}.oleria.io/v1/roles \
--header 'Authorization: Bearer <token>'import requests
url = "https://devx.{environment}.oleria.io/v1/roles"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://devx.{environment}.oleria.io/v1/roles', 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://devx.{environment}.oleria.io/v1/roles",
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://devx.{environment}.oleria.io/v1/roles"
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))
}HttpResponse<String> response = Unirest.get("https://devx.{environment}.oleria.io/v1/roles")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://devx.{environment}.oleria.io/v1/roles")
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{
"items": [
{
"applicationRoleType": "<string>",
"id": "0PSHu000003fo6tOAA (Salesforce based on permission set ids)",
"isCustom": false,
"name": "oleria Repo Maintainers",
"objectMetadata": {
"ApplicationInstanceId": "<string>",
"GeneratedTime": "2023-11-07T05:31:56Z",
"ObjectOrRelationshipType": "<string>"
},
"type": "Standard",
"globalId": "<string>",
"oleriaObjectMetadata": {
"enrichmentVersion": "<string>",
"generatedTime": "2023-11-07T05:31:56Z"
},
"authorizedLocations": {
"isInherited": true,
"policy": {
"allowAll": true,
"authorizedLocations": [
{
"typeSpecificData": {
"ipAddressExclusions": [
"<string>"
],
"ipAddressInclusions": [
"<string>"
],
"name": "<string>",
"supplementaryInformation": {
"geoLocation": {
"latitude": 123,
"longtitude": 123
},
"additionalLocationMetadata": [
{
"id": "<string>",
"name": "<string>",
"namespace": "<string>",
"value": {}
}
]
}
}
}
]
}
},
"createdBy": "user:U_kgDOB7P6Rg (GitHub based on node identifier), 838439349399 (Google Workspace based on user id), user:wiz-inc-4db1c46901 (GitHub based on app slug)",
"createdByFederation": {
"isFederated": true,
"authenticationKey": "<string>"
},
"createdDate": "2024-05-02T03:17:34.948Z",
"description": "oleria Repos Writers",
"lastModifiedBy": "user:U_kgDOB7P6Rg (GitHub based on node identifier), 838439349399 (Google Workspace based on user id), user:wiz-inc-4db1c46901 (GitHub based on app slug)",
"lastModifiedByFederation": {
"isFederated": true,
"authenticationKey": "<string>"
},
"lastModifiedDate": "2024-05-02T03:17:34.948Z",
"objectDirectoryContainerFederation": {
"isFederated": true,
"authenticationKey": "<string>"
},
"objectDirectoryContainerId": "repo:R_kgDOLL0doQ (GitHub based on repository node identifier), 1BUxdX4M-H7X8GKRgTjprJS8fjY_Ij1giE82lQlny2kc (Google Drive based on file id)",
"sourceTag": "oleria",
"globalAuthorizedLocations": {
"isInherited": true,
"policy": {
"allowAll": true,
"authorizedLocations": [
{
"typeSpecificData": {
"ipAddressExclusions": [
"<string>"
],
"ipAddressInclusions": [
"<string>"
],
"name": "<string>",
"supplementaryInformation": {
"geoLocation": {
"latitude": 123,
"longtitude": 123
},
"additionalLocationMetadata": [
{
"id": "<string>",
"name": "<string>",
"namespace": "<string>",
"value": {}
}
]
}
}
}
]
}
},
"globalCreatedBy": "<string>",
"globalLastModifiedBy": "<string>",
"globalObjectDirectoryContainerId": "<string>",
"analyticsAccessToResourceInstancesCount": 123,
"analyticsActiveMemberCount": 123,
"analyticsAssignedApplicationCount": 123,
"analyticsAssignedRoleCount": 123,
"analyticsAssignedUserGroupCount": 123,
"analyticsInactiveMemberCount": 123,
"analyticsMemberAccountsCount": 123,
"analyticsMemberCount": 123,
"analyticsOwners": [
"<string>"
],
"sorPrimaryStewardEmail": "<string>"
}
],
"nextPageToken": "<string>"
}{
"code": "BAD_REQUEST",
"message": "The request was malformed."
}{
"code": "UNAUTHORIZED",
"message": "Missing or invalid authentication token."
}{
"code": "FORBIDDEN",
"message": "The token lacks the required scope."
}{
"code": "TOO_MANY_REQUESTS",
"message": "Rate limit exceeded. Retry after the specified interval."
}{
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred."
}List
Returns a page of roles. Pass pageToken from the previous response’s nextPageToken to fetch the next page. A page can be empty while the results are still being prepared. Keep requesting pages until the response has no nextPageToken. Requires the https://devx.{environment}.oleria.io/read scope.
curl --request GET \
--url https://devx.{environment}.oleria.io/v1/roles \
--header 'Authorization: Bearer <token>'import requests
url = "https://devx.{environment}.oleria.io/v1/roles"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://devx.{environment}.oleria.io/v1/roles', 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://devx.{environment}.oleria.io/v1/roles",
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://devx.{environment}.oleria.io/v1/roles"
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))
}HttpResponse<String> response = Unirest.get("https://devx.{environment}.oleria.io/v1/roles")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://devx.{environment}.oleria.io/v1/roles")
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{
"items": [
{
"applicationRoleType": "<string>",
"id": "0PSHu000003fo6tOAA (Salesforce based on permission set ids)",
"isCustom": false,
"name": "oleria Repo Maintainers",
"objectMetadata": {
"ApplicationInstanceId": "<string>",
"GeneratedTime": "2023-11-07T05:31:56Z",
"ObjectOrRelationshipType": "<string>"
},
"type": "Standard",
"globalId": "<string>",
"oleriaObjectMetadata": {
"enrichmentVersion": "<string>",
"generatedTime": "2023-11-07T05:31:56Z"
},
"authorizedLocations": {
"isInherited": true,
"policy": {
"allowAll": true,
"authorizedLocations": [
{
"typeSpecificData": {
"ipAddressExclusions": [
"<string>"
],
"ipAddressInclusions": [
"<string>"
],
"name": "<string>",
"supplementaryInformation": {
"geoLocation": {
"latitude": 123,
"longtitude": 123
},
"additionalLocationMetadata": [
{
"id": "<string>",
"name": "<string>",
"namespace": "<string>",
"value": {}
}
]
}
}
}
]
}
},
"createdBy": "user:U_kgDOB7P6Rg (GitHub based on node identifier), 838439349399 (Google Workspace based on user id), user:wiz-inc-4db1c46901 (GitHub based on app slug)",
"createdByFederation": {
"isFederated": true,
"authenticationKey": "<string>"
},
"createdDate": "2024-05-02T03:17:34.948Z",
"description": "oleria Repos Writers",
"lastModifiedBy": "user:U_kgDOB7P6Rg (GitHub based on node identifier), 838439349399 (Google Workspace based on user id), user:wiz-inc-4db1c46901 (GitHub based on app slug)",
"lastModifiedByFederation": {
"isFederated": true,
"authenticationKey": "<string>"
},
"lastModifiedDate": "2024-05-02T03:17:34.948Z",
"objectDirectoryContainerFederation": {
"isFederated": true,
"authenticationKey": "<string>"
},
"objectDirectoryContainerId": "repo:R_kgDOLL0doQ (GitHub based on repository node identifier), 1BUxdX4M-H7X8GKRgTjprJS8fjY_Ij1giE82lQlny2kc (Google Drive based on file id)",
"sourceTag": "oleria",
"globalAuthorizedLocations": {
"isInherited": true,
"policy": {
"allowAll": true,
"authorizedLocations": [
{
"typeSpecificData": {
"ipAddressExclusions": [
"<string>"
],
"ipAddressInclusions": [
"<string>"
],
"name": "<string>",
"supplementaryInformation": {
"geoLocation": {
"latitude": 123,
"longtitude": 123
},
"additionalLocationMetadata": [
{
"id": "<string>",
"name": "<string>",
"namespace": "<string>",
"value": {}
}
]
}
}
}
]
}
},
"globalCreatedBy": "<string>",
"globalLastModifiedBy": "<string>",
"globalObjectDirectoryContainerId": "<string>",
"analyticsAccessToResourceInstancesCount": 123,
"analyticsActiveMemberCount": 123,
"analyticsAssignedApplicationCount": 123,
"analyticsAssignedRoleCount": 123,
"analyticsAssignedUserGroupCount": 123,
"analyticsInactiveMemberCount": 123,
"analyticsMemberAccountsCount": 123,
"analyticsMemberCount": 123,
"analyticsOwners": [
"<string>"
],
"sorPrimaryStewardEmail": "<string>"
}
],
"nextPageToken": "<string>"
}{
"code": "BAD_REQUEST",
"message": "The request was malformed."
}{
"code": "UNAUTHORIZED",
"message": "Missing or invalid authentication token."
}{
"code": "FORBIDDEN",
"message": "The token lacks the required scope."
}{
"code": "TOO_MANY_REQUESTS",
"message": "Rate limit exceeded. Retry after the specified interval."
}{
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred."
}Authorizations
OAuth 2.0 client-credentials flow. Request an access token from the token endpoint and send it as Authorization: Bearer <token>.
Query Parameters
Maximum items per page.
1 <= x <= 200Opaque page token from the previous response's nextPageToken. Omit it for the first page; pass it back exactly as received. Do not parse or construct it.
Scope the list to a single application instance, identified by its id (UUID). An application instance is one connected integration in your tenant: a specific Okta, Workday, and so on. Omit it to list across all of your instances.
Response
A page of roles.
Show child attributes
Show child attributes
Opaque token for the next page; pass it back as pageToken. Present whenever more pages remain, including when this page is empty because the results are still being prepared, and absent only once the collection is fully returned. Do not parse or construct it.
Was this page helpful?

